Gmail é um dos serviços de e-mail mais populares do mundo, confiado por indivíduos e organizações para enviar, receber e gerenciar mensagens com segurança.
Com a integração do Gmail no Zoen, você pode:
- Enviar e-mails: Compose e envie e-mails com suporte a destinatários, CC, BCC, assunto, corpo e anexos
- Criar rascunhos: Salve rascunhos de e-mail para revisão e envio posteriores
- Ler e-mails: Recupere mensagens de e-mail por ID com conteúdo completo e metadados
- Pesquisar e-mails: Encontre e-mails usando a poderosa sintaxe de consulta de pesquisa do Gmail
- Mover e-mails: Mova mensagens entre pastas ou labels
- Gerenciar status de leitura: Marque e-mails como lidos ou não lidos
- Arquivar e desarquivar: Arquive mensagens para limpar sua caixa de entrada ou restaure-as
- Excluir e-mails: Remova mensagens da sua caixa de correio
- Gerenciar labels: Adicione ou remova labels dos e-mails para organização
No Zoen, a integração com o Gmail permite que seus agentes interajam com sua caixa de entrada de forma programática como parte de workflows automatizados. Os agentes podem enviar notificações, pesquisar e-mails específicos, organizar mensagens e disparar ações com base no conteúdo do e-mail — habilitando automação inteligente de e-mail e workflows de comunicação.
Integrate Gmail into the workflow. Can send, read, search, and move emails. Can be used in trigger mode to trigger a workflow when a new email is received.
Send emails using Gmail. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
to | string | Yes | Recipient email address |
subject | string | No | Email subject |
body | string | Yes | Email body content |
contentType | string | No | Content type for the email body (text or html) |
threadId | string | No | Thread ID to reply to (for threading) |
replyToMessageId | string | No | Gmail message ID to reply to - use the "id" field from Gmail Read results (not the RFC "messageId") |
cc | string | No | CC recipients (comma-separated) |
bcc | string | No | BCC recipients (comma-separated) |
attachments | file[] | No | Files to attach to the email |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Email labels |
Draft emails using Gmail. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
to | string | Yes | Recipient email address |
subject | string | No | Email subject |
body | string | Yes | Email body content |
contentType | string | No | Content type for the email body (text or html) |
threadId | string | No | Thread ID to reply to (for threading) |
replyToMessageId | string | No | Gmail message ID to reply to - use the "id" field from Gmail Read results (not the RFC "messageId") |
cc | string | No | CC recipients (comma-separated) |
bcc | string | No | BCC recipients (comma-separated) |
attachments | file[] | No | Files to attach to the email draft |
| Parameter | Type | Description |
|---|
draftId | string | Draft ID |
messageId | string | Gmail message ID for the draft |
threadId | string | Gmail thread ID |
labelIds | array | Email labels |
Update an existing Gmail draft in place without deleting and recreating it.
| Parameter | Type | Required | Description |
|---|
draftId | string | Yes | ID of the draft to update (from Gmail List Drafts or Gmail Get Draft) |
to | string | Yes | Recipient email address |
subject | string | No | Email subject |
body | string | Yes | Email body content |
contentType | string | No | Content type for the email body (text or html) |
threadId | string | No | Thread ID to associate the draft with (for threading) |
replyToMessageId | string | No | Gmail message ID to reply to - use the "id" field from Gmail Read results (not the RFC "messageId") |
cc | string | No | CC recipients (comma-separated) |
bcc | string | No | BCC recipients (comma-separated) |
attachments | file[] | No | Files to attach to the email draft |
| Parameter | Type | Description |
|---|
draftId | string | Draft ID |
messageId | string | Gmail message ID for the draft |
threadId | string | Gmail thread ID |
labelIds | array | Email labels |
Read emails from Gmail. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | No | Gmail message ID to read (e.g., 18f1a2b3c4d5e6f7) |
folder | string | No | Folder/label to read emails from (e.g., INBOX, SENT, DRAFT, TRASH, SPAM, or custom label name) |
unreadOnly | boolean | No | Set to true to only retrieve unread messages |
maxResults | number | No | Maximum number of messages to retrieve (default: 1, max: 10) |
includeAttachments | boolean | No | Set to true to download and include email attachments |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Email labels |
from | string | Sender email address |
to | string | Recipient email address |
subject | string | Email subject |
date | string | Email date |
body | string | Email body text (best-effort plain text) |
hasAttachments | boolean | Whether the email has attachments |
attachmentCount | number | Number of attachments |
attachments | file[] | Downloaded attachments (if enabled) |
results | json | Summary results when reading multiple messages |
Search emails in Gmail. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
query | string | Yes | Search query for emails |
maxResults | number | No | Maximum number of results to return (e.g., 10, 25, 50) |
| Parameter | Type | Description |
|---|
results | json | Array of search results |
Move emails between labels/folders in Gmail. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | Yes | ID of the message to move |
addLabelIds | string | Yes | Comma-separated label IDs to add (e.g., INBOX, Label_123) |
removeLabelIds | string | No | Comma-separated label IDs to remove (e.g., INBOX, SPAM) |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Email labels |
Mark a Gmail message as read. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | Yes | ID of the message to mark as read |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Updated email labels |
Mark a Gmail message as unread. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | Yes | ID of the message to mark as unread |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Updated email labels |
Archive a Gmail message (remove from inbox). Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | Yes | ID of the message to archive |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Updated email labels |
Unarchive a Gmail message (move back to inbox). Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | Yes | ID of the message to unarchive |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Updated email labels |
Delete a Gmail message (move to trash). Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | Yes | ID of the message to delete |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Updated email labels |
Add label(s) to a Gmail message. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | Yes | ID of the message to add labels to |
labelIds | string | Yes | Comma-separated label IDs to add (e.g., INBOX, Label_123) |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Updated email labels |
Remove label(s) from a Gmail message. Returns API-aligned fields only.
| Parameter | Type | Required | Description |
|---|
messageId | string | Yes | ID of the message to remove labels from |
labelIds | string | Yes | Comma-separated label IDs to remove (e.g., INBOX, Label_123) |
| Parameter | Type | Description |
|---|
id | string | Gmail message ID |
threadId | string | Gmail thread ID |
labelIds | array | Updated email labels |
A Trigger is a block that starts a workflow when an event happens in this service.
These run on a schedule (polling-based) — they check for new data rather than receiving push notifications.
Triggers when new emails are received in Gmail (requires Gmail credentials)
| Parameter | Type | Required | Description |
|---|
triggerCredentials | string | Yes | This trigger requires google email credentials to access your account. |
labelIds | string | No | Choose which Gmail labels to monitor. Leave empty to monitor all emails. |
labelFilterBehavior | string | Yes | Include only emails with selected labels, or exclude emails with selected labels |
searchQuery | string | No | Optional Gmail search query to filter emails. Use the same format as Gmail search box (e.g., |
markAsRead | boolean | No | Automatically mark emails as read after processing |
includeAttachments | boolean | No | Download and include email attachments in the trigger payload |
| Parameter | Type | Description |
|---|
email | object | email output from the tool |
↳ id | string | Gmail message ID |
↳ threadId | string | Gmail thread ID |
↳ subject | string | Email subject line |
↳ from | string | Sender email address |
↳ to | string | Recipient email address |
↳ cc | string | CC recipients |
↳ date | string | Email date in ISO format |
↳ bodyText | string | Plain text email body |
↳ bodyHtml | string | HTML email body |
↳ labels | array | Email labels array |
↳ hasAttachments | boolean | Whether email has attachments |
↳ attachments | file[] | Array of email attachments as files (if includeAttachments is enabled) |
timestamp | string | Event timestamp |