SendGrid é uma plataforma líder de entrega de e-mail baseada em nuvem, usada por desenvolvedores e empresas para enviar e-mails transacionais e de marketing confiáveis em escala. Com APIs robustas e ferramentas poderosas, o SendGrid permite gerenciar todos os aspectos da sua comunicação por e-mail, desde o envio de notificações e recibos até o gerenciamento de campanhas de marketing complexas.
O SendGrid oferece um conjunto completo de operações de e-mail, permitindo automatizar fluxos críticos de e-mail e gerenciar de perto listas de contatos, templates e o engajamento dos destinatários. Sua integração seamless com o Zoen permite que agentes e fluxos de trabalho entreguem mensagens direcionadas, mantenham listas dinâmicas de contatos e destinatários, disparem e-mails personalizados por meio de templates e acompanhem os resultados em tempo real.
Principais recursos do SendGrid:
- E-mail transacional: Envie e-mails transacionais automatizados e de alto volume (como notificações, recibos e redefinições de senha).
- Templates dinâmicos: Use templates HTML ou texto ricos com dados dinâmicos para comunicação altamente personalizada em escala.
- Gerenciamento de contatos: Adicione e atualize contatos de marketing, gerencie listas de destinatários e segmente públicos para campanhas.
- Suporte a anexos: Inclua um ou mais anexos de arquivo nos seus e-mails.
- Cobertura abrangente da API: Gerencie de forma programática e-mails, contatos, listas, templates, suppression groups e muito mais.
Ao conectar o SendGrid ao Zoen, seus agentes podem:
- Enviar e-mails simples e avançados (com template ou multi-destinatário) como parte de qualquer fluxo de trabalho.
- Gerenciar e segmentar contatos e listas automaticamente.
- Aproveitar templates para consistência e personalização dinâmica.
- Acompanhar e responder ao engajamento de e-mail dentro dos seus processos automatizados.
Esta integração permite automatizar todos os fluxos críticos de comunicação, garantir que as mensagens cheguem ao público certo e manter o controle sobre a estratégia de e-mail da sua organização, diretamente a partir dos fluxos de trabalho Zoen.
Integrate SendGrid into your workflow. Send transactional emails, manage marketing contacts and lists, and work with email templates. Supports dynamic templates, attachments, and comprehensive contact management.
Send an email using SendGrid API
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
from | string | Yes | Sender email address (must be verified in SendGrid) |
fromName | string | No | Sender name |
to | string | Yes | Recipient email address |
toName | string | No | Recipient name |
subject | string | No | Email subject (required unless using a template with pre-defined subject) |
content | string | No | Email body content (required unless using a template with pre-defined content) |
contentType | string | No | Content type (text/plain or text/html) |
cc | string | No | CC email address |
bcc | string | No | BCC email address |
replyTo | string | No | Reply-to email address |
replyToName | string | No | Reply-to name |
attachments | file[] | No | Files to attach to the email (UserFile objects) |
templateId | string | No | SendGrid template ID to use |
dynamicTemplateData | json | No | JSON object of dynamic template data |
| Parameter | Type | Description |
|---|
success | boolean | Whether the email was sent successfully |
messageId | string | SendGrid message ID |
to | string | Recipient email address |
subject | string | Email subject |
Add a new contact to SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
email | string | Yes | Contact email address |
firstName | string | No | Contact first name |
lastName | string | No | Contact last name |
customFields | json | No | JSON object of custom field key-value pairs (use field IDs like e1_T, e2_N, e3_D, not field names) |
listIds | string | No | Comma-separated list IDs to add the contact to |
| Parameter | Type | Description |
|---|
jobId | string | Job ID for tracking the async contact creation |
email | string | Contact email address |
firstName | string | Contact first name |
lastName | string | Contact last name |
message | string | Status message |
Get a specific contact by ID from SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
contactId | string | Yes | Contact ID |
| Parameter | Type | Description |
|---|
id | string | Contact ID |
email | string | Contact email address |
firstName | string | Contact first name |
lastName | string | Contact last name |
createdAt | string | Creation timestamp |
updatedAt | string | Last update timestamp |
listIds | json | Array of list IDs the contact belongs to |
customFields | json | Custom field values |
Search for contacts in SendGrid using a query
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
query | string | Yes | Search query (e.g., "email LIKE '%example.com%' AND CONTAINS(list_ids, 'list-id')") |
| Parameter | Type | Description |
|---|
contacts | json | Array of matching contacts |
contactCount | number | Total number of contacts found |
Delete one or more contacts from SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
contactIds | string | Yes | Comma-separated contact IDs to delete |
| Parameter | Type | Description |
|---|
jobId | string | Job ID for the deletion request |
Create a new contact list in SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
name | string | Yes | List name |
| Parameter | Type | Description |
|---|
id | string | List ID |
name | string | List name |
contactCount | number | Number of contacts in the list |
Get a specific list by ID from SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
listId | string | Yes | List ID |
| Parameter | Type | Description |
|---|
id | string | List ID |
name | string | List name |
contactCount | number | Number of contacts in the list |
Get all contact lists from SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
pageSize | number | No | Number of lists to return per page (default: 100, max: 1000) |
pageToken | string | No | Page token from a previous response (nextPageToken) to fetch the next page |
| Parameter | Type | Description |
|---|
lists | json | Array of lists |
nextPageToken | string | Token to pass as pageToken to fetch the next page, if more results exist |
Delete a contact list from SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
listId | string | Yes | List ID to delete |
| Parameter | Type | Description |
|---|
message | string | Success message |
Add or update contacts and assign them to a list in SendGrid (uses PUT /v3/marketing/contacts)
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
listId | string | Yes | List ID to add contacts to |
contacts | json | Yes | JSON array of contact objects. Each contact must have at least: email (or phone_number_id/external_id/anonymous_id). Example: [{"email": "user@example.com", "first_name": "John"}] |
| Parameter | Type | Description |
|---|
jobId | string | Job ID for tracking the async operation |
message | string | Status message |
Remove contacts from a specific list in SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
listId | string | Yes | List ID |
contactIds | string | Yes | Comma-separated contact IDs to remove from the list |
| Parameter | Type | Description |
|---|
jobId | string | Job ID for the request |
Create a new email template in SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
name | string | Yes | Template name |
generation | string | No | Template generation type (legacy or dynamic, default: dynamic) |
| Parameter | Type | Description |
|---|
id | string | Template ID |
name | string | Template name |
generation | string | Template generation |
updatedAt | string | Last update timestamp |
versions | json | Array of template versions |
Get a specific template by ID from SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
templateId | string | Yes | Template ID |
| Parameter | Type | Description |
|---|
id | string | Template ID |
name | string | Template name |
generation | string | Template generation |
updatedAt | string | Last update timestamp |
versions | json | Array of template versions |
Get all email templates from SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
generations | string | No | Filter by generation (legacy, dynamic, or both) |
pageSize | number | No | Number of templates to return per page (default: 20, max: 200). ' + |
| 'When paginating with pageToken, pass the same pageSize used on the first request ' + | | | |
| 'to keep page boundaries consistent. | | | |
pageToken | string | No | Page token from a previous response (nextPageToken) to fetch the next page |
| Parameter | Type | Description |
|---|
templates | json | Array of templates |
nextPageToken | string | Token to pass as pageToken to fetch the next page, if more results exist |
Delete an email template from SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
templateId | string | Yes | Template ID to delete |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
message | string | Status or success message |
messageId | string | Email message ID (send_mail) |
to | string | Recipient email address (send_mail) |
subject | string | Email subject (send_mail, create_template_version) |
id | string | Resource ID |
jobId | string | Job ID for async operations |
email | string | Contact email address |
firstName | string | Contact first name |
lastName | string | Contact last name |
createdAt | string | Creation timestamp |
updatedAt | string | Last update timestamp |
listIds | json | Array of list IDs the contact belongs to |
customFields | json | Custom field values |
contacts | json | Array of contacts |
contactCount | number | Number of contacts |
lists | json | Array of lists |
name | string | Resource name |
templates | json | Array of templates |
generation | string | Template generation |
versions | json | Array of template versions |
nextPageToken | string | Token for the next page of results (list_all_lists, list_templates) |
templateId | string | Template ID |
active | boolean | Whether template version is active |
htmlContent | string | HTML content |
plainContent | string | Plain text content |
Create a new version of an email template in SendGrid
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | SendGrid API key |
templateId | string | Yes | Template ID |
name | string | Yes | Version name |
subject | string | Yes | Email subject line |
htmlContent | string | No | HTML content of the template |
plainContent | string | No | Plain text content of the template |
active | boolean | No | Whether this version is active (default: true) |
| Parameter | Type | Description |
|---|
id | string | Version ID |
templateId | string | Template ID |
name | string | Version name |
subject | string | Email subject |
active | boolean | Whether this version is active |
htmlContent | string | HTML content |
plainContent | string | Plain text content |
updatedAt | string | Last update timestamp |