Skip to main content

​
Configuración básica

Puedes instalar la integración de Gmail directamente desde nuestro Marketplace. Una vez instalada, podrás enviar correos electrónicos (incluyendo HTML, CC y BCC), buscar contactos mediante Google People API, consultar correos, buscarlos por criterios avanzados y modificar sus etiquetas (leer/no leer, archivar, spam, etc.).

​
Funcionalidades

​
Enviar correo electrónico

Enviar un correo con soporte para contenido HTML, CC, BCC y threading (responder dentro de una conversación existente). Inputs:
  • to (array de string) — Lista de correos destinatarios.
  • subject (string) — Asunto del correo.
  • body (string) — Cuerpo del correo (usado para text/plain o cuando no se provee htmlBody).
  • htmlBody (opcional, string) — Versión HTML del cuerpo del correo.
  • mimeType (opcional, enum: text/plain | text/html | multipart/alternative) — Tipo de contenido (por defecto text/plain).
  • cc (opcional, array de string) — Lista de direcciones en CC.
  • bcc (opcional, array de string) — Lista de direcciones en BCC.
  • threadId (opcional, string) — ID del hilo al que se responde.
  • inReplyTo (opcional, string) — ID del mensaje al que se responde.
Ejemplo: 
{
  "to": ["destinatario1@ejemplo.com", "destinatario2@ejemplo.com"],
  "subject": "Actualización de proyecto",
  "body": "Hola equipo, aquí va el resumen del avance.",
  "htmlBody": "<p>Hola equipo,</p><p>Aquí va el <strong>resumen</strong> del avance.</p>",
  "mimeType": "multipart/alternative",
  "cc": ["lider@ejemplo.com"],
  "bcc": ["auditoria@ejemplo.com"],
  "threadId": "188c1234abcd5678",
  "inReplyTo": "CADf1234xyz@mail.gmail.com"
}

​
Buscar personas (Google People)

Buscar personas/contactos usando Google People API (nombres, correos, teléfonos, organizaciones). Inputs:
  • query (string) — Texto de búsqueda (nombres, correos, teléfonos, organizaciones).
  • pageSize (opcional, number) — Cantidad de resultados (por defecto 10, máximo 30).
  • readMask (opcional, string) — Campos a devolver separados por comas (por defecto names,emailAddresses,phoneNumbers,organizations).
Ejemplo: 
{
  "query": "Ana Perez",
  "pageSize": 20,
  "readMask": "names,emailAddresses,phoneNumbers,organizations"
}

​
Obtener correo

Obtener el contenido de un correo específico por su ID. Inputs:
  • messageId (string) — ID del mensaje a recuperar.
Ejemplo: 
{
  "messageId": "188c9a0f12abcde3"
}

​
Buscar correos

Buscar correos en Gmail usando la sintaxis de búsqueda de Gmail (p. ej. from:usuario@dominio.com, subject:reunión, is:unread). Inputs:
  • query (string) — Consulta de búsqueda de Gmail.
  • maxResults (opcional, number) — Máximo de resultados a devolver (por defecto 10).
Ejemplo: 
{
  "query": "from:ventas@ejemplo.com subject:Reporte is:unread",
  "maxResults": 25
}

​
Modificar etiquetas de un correo

Modificar etiquetas de un correo para marcar como leído/no leído, archivar, mover, marcar como importante/spam, etc. Etiquetas comunes: UNREAD, INBOX, IMPORTANT, SPAM, TRASH, STARRED. Inputs:
  • messageId (string) — ID del mensaje a modificar.
  • addLabelIds (opcional, array de string) — Lista de etiquetas a agregar (p. ej. ["IMPORTANT"] para marcar como importante).
  • removeLabelIds (opcional, array de string) — Lista de etiquetas a remover (p. ej. ["UNREAD"] para marcar como leído, ["INBOX"] para archivar).
Ejemplo: 
{
  "messageId": "188c9a0f12abcde3",
  "addLabelIds": ["STARRED", "IMPORTANT"],
  "removeLabelIds": ["UNREAD", "INBOX"]
}