SendGrid

Enviar e-mails e administrar contatos, listas e modelos no SendGrid.

Integrações e ferramentasE-mailConexão: Credencial protegida

O que faz

Integre o SendGrid ao seu fluxo. Envie e-mails transacionais, gerencie contatos e listas de marketing e trabalhe com modelos de e-mail. Suporta modelos dinâmicos, anexos e uma gestão completa de contatos.

Quando usar: Use quando o seu fluxo precisar enviar e-mails e administrar contatos, listas e modelos no SendGrid.

Exemplo de situação: Enviar uma confirmação por e-mail ou tratar uma mensagem recebida.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

Adicione SendGrid ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
Escolha a operação. O painel mostra só os campos que essa operação usa.
Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
Só publique depois de conferir o resultado da execução de teste.

Operações

Operação	O que faz
Enviar e-mail	Envia e-mail com o bloco SendGrid.
Adicionar contato	Adiciona contato com o bloco SendGrid.
Obter contato	Obtém contato com o bloco SendGrid.
Buscar contatos	Busca contatos com o bloco SendGrid.
Excluir contatos	Exclui contatos com o bloco SendGrid.
Criar lista	Cria lista com o bloco SendGrid.
Obter lista	Obtém lista com o bloco SendGrid.
Listar todas as listas	Lista todas as listas com o bloco SendGrid.
Excluir lista	Exclui lista com o bloco SendGrid.
Adicionar contatos à lista	Adiciona contatos à lista com o bloco SendGrid.
Remover contatos da lista	Remove contatos da lista com o bloco SendGrid.
Criar modelo	Cria modelo com o bloco SendGrid.
Obter modelo	Obtém modelo com o bloco SendGrid.
Listar modelos	Lista modelos com o bloco SendGrid.
Excluir modelo	Exclui modelo com o bloco SendGrid.
Criar versão do modelo	Cria versão do modelo com o bloco SendGrid.

Campos

Mostrar campos de

Operação
Escolhe qual ação este bloco executará.
Opções:
Enviar e-mail · Adicionar contato · Obter contato · Buscar contatos · Excluir contatos · Criar lista · Obter lista · Listar todas as listas · Excluir lista · Adicionar contatos à lista · Remover contatos da lista · Criar modelo · Obter modelo · Listar modelos · Excluir modelo · Criar versão do modelo
Padrão:
Enviar e-mail
Chave de API do SendGrid
ObrigatórioDado protegido
Usa a chave salva em Integrações → SendGrid.
Padrão:
Segredo protegido
E-mail do remetente
Obrigatório conforme a operação
E-mail que aparece como remetente; precisa ser um endereço ou domínio verificado na sua conta do SendGrid (ex.: contato@minhaempresa.com.br).
Aparece em:
Enviar e-mail
Exemplo:
cliente@exemplo.com
Nome do remetente
Em campos adicionais
Nome do remetente.
Aparece em:
Enviar e-mail
Exemplo:
cliente@exemplo.com
E-mail do destinatário
Obrigatório conforme a operação
Informa o destinatário ou endereço de e-mail usado pela operação.
Aparece em:
Enviar e-mail
Exemplo:
cliente@exemplo.com
Nome do destinatário
Em campos adicionais
Nome do destinatário.
Aparece em:
Enviar e-mail
Exemplo:
Exemplo de atendimento
Assunto
Assunto do e-mail (obrigatório, exceto ao usar um modelo).
Aparece em:
Enviar e-mail
Exemplo:
Exemplo de atendimento
Conteúdo
Corpo do e-mail (obrigatório, exceto ao usar um modelo).
Aparece em:
Enviar e-mail
Exemplo:
Olá! Sua solicitação foi processada com sucesso.
Tipo de conteúdo
Informa o conteúdo de texto que será enviado ou processado.
Aparece em:
Enviar e-mail
Opções:
Texto simples · HTML
Padrão:
Texto simples
Cc
Em campos adicionais
Informa o destinatário ou endereço de e-mail usado pela operação.
Aparece em:
Enviar e-mail
Exemplo:
.com
Cco
Em campos adicionais
Informa o destinatário ou endereço de e-mail usado pela operação.
Aparece em:
Enviar e-mail
Exemplo:
.com
Responder para
Em campos adicionais
Informa o destinatário ou endereço de e-mail usado pela operação.
Aparece em:
Enviar e-mail
Exemplo:
cliente@exemplo.com
Nome para resposta
Em campos adicionais
Nome para resposta.
Aparece em:
Enviar e-mail
Exemplo:
Exemplo de atendimento
ID do modelo
Em campos adicionais
ID do modelo do SendGrid.
Aparece em:
Enviar e-mail
Exemplo:
id-do-recurso
Dados do modelo dinâmico
Em campos adicionais
Informa dados estruturados ou código no formato exigido pelo campo.
Aparece em:
Enviar e-mail
Exemplo:
{ "chave": "valor" }
Anexos
Envie os arquivos a anexar.
Aparece em:
Enviar e-mail
Exemplo:
(selecione um arquivo de teste)
Anexos
Em campos adicionais
Referencie arquivos de blocos anteriores.
Aparece em:
Enviar e-mail
E-mail
Obrigatório conforme a operação
Informa o destinatário ou endereço de e-mail usado pela operação.
Aparece em:
Adicionar contato
Exemplo:
cliente@exemplo.com
Nome
Define o nome ou título usado para identificar o recurso.
Aparece em:
Adicionar contato
Exemplo:
Exemplo de atendimento
Sobrenome
Define o nome ou título usado para identificar o recurso.
Aparece em:
Adicionar contato
Exemplo:
Exemplo de atendimento
Campos personalizados
Em campos adicionais
Informa uma estrutura JSON com os dados exigidos por esta operação.
Aparece em:
Adicionar contato
Exemplo:
{"custom_field_1": "valor1"}
IDs das listas
Em campos adicionais
IDs das listas, separados por vírgula.
Aparece em:
Adicionar contato
Exemplo:
IDs das listas, separados por vírgula
ID do contato
Obrigatório conforme a operação
ID do contato.
Aparece em:
Obter contato
Exemplo:
id-do-recurso
Consulta de busca
Obrigatório conforme a operação
Informa a consulta usada para localizar ou transformar dados.
Aparece em:
Buscar contatos
Exemplo:
SELECT * FROM clientes WHERE status = 'ativo'
IDs dos contatos
Obrigatório conforme a operação
IDs dos contatos, separados por vírgula.
Aparece em:
Excluir contatos, Remover contatos da lista
Exemplo:
IDs dos contatos, separados por vírgula
Contatos (lista JSON)
Obrigatório conforme a operação
Informa dados estruturados ou código no formato exigido pelo campo.
Aparece em:
Adicionar contatos à lista
Exemplo:
{ "chave": "valor" }
Nome da lista
Obrigatório conforme a operação
Nome da lista.
Aparece em:
Criar lista
Exemplo:
Exemplo de atendimento
ID da lista
Obrigatório conforme a operação
ID da lista.
Aparece em:
Obter lista, Excluir lista, Adicionar contatos à lista, Remover contatos da lista
Exemplo:
id-do-recurso
Itens por página
Em campos adicionais
Define um valor numérico, quantidade ou limite da operação.
Aparece em:
Listar todas as listas
Exemplo:
10
Token da página
Em campos adicionais
Token da página de uma resposta anterior.
Aparece em:
Listar todas as listas
Exemplo:
Token da página de uma resposta anterior
Nome do modelo
Obrigatório conforme a operação
Nome do modelo.
Aparece em:
Criar modelo
Exemplo:
Exemplo de atendimento
ID do modelo
Obrigatório conforme a operação
ID do modelo.
Aparece em:
Obter modelo, Excluir modelo, Criar versão do modelo
Exemplo:
id-do-recurso
Geração do modelo
Escolhe uma das opções aceitas por este campo.
Aparece em:
Criar modelo
Opções:
Dinâmico · Legado
Padrão:
Dinâmico
Filtrar por geração
Em campos adicionais
Filtra os modelos do SendGrid pela geração: legacy para os antigos, dynamic para os dinâmicos ou legacy,dynamic para ver os dois.
Aparece em:
Listar modelos
Exemplo:
legacy, dynamic ou os dois
Itens por página
Em campos adicionais
Define um valor numérico, quantidade ou limite da operação.
Aparece em:
Listar modelos
Exemplo:
10
Token da página
Em campos adicionais
Token da página de uma resposta anterior (mantenha o mesmo tamanho de página).
Aparece em:
Listar modelos
Exemplo:
Token da página de uma resposta anterior (mantenha o mesmo tamanho de página)
Nome da versão
Obrigatório conforme a operação
Nome da versão.
Aparece em:
Criar versão do modelo
Exemplo:
Exemplo de atendimento
Assunto do modelo
Obrigatório conforme a operação
Assunto do e-mail.
Aparece em:
Criar versão do modelo
Exemplo:
Exemplo de atendimento
Conteúdo em HTML
Informa o conteúdo de texto que será enviado ou processado.
Aparece em:
Criar versão do modelo
Exemplo:
Olá! Sua solicitação foi processada com sucesso.
Conteúdo em texto simples
Em campos adicionais
Conteúdo em texto simples.
Aparece em:
Criar versão do modelo
Exemplo:
Olá! Sua solicitação foi processada com sucesso.
Ativo
Em campos adicionais
Define se este comportamento fica ativado ou desativado.
Aparece em:
Criar versão do modelo
Opções:
Sim · Não
Padrão:
Sim

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <sendgrid.success>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Referência	Tipo	O que contém
`<sendgrid.success>`	boolean	Indica se a operação foi concluída com sucesso.
`<sendgrid.message>`	string	Mensagem de status ou de sucesso.
`<sendgrid.messageId>`	string	ID da mensagem de e-mail (send_mail).
`<sendgrid.to>`	string	E-mail do destinatário (send_mail).
`<sendgrid.subject>`	string	Assunto do e-mail (send_mail, create_template_version).
`<sendgrid.id>`	string	ID do recurso.
`<sendgrid.jobId>`	string	ID da tarefa nas operações assíncronas.
`<sendgrid.email>`	string	E-mail do contato.
`<sendgrid.firstName>`	string	Nome do contato.
`<sendgrid.lastName>`	string	Sobrenome do contato.
`<sendgrid.createdAt>`	string	Data e hora de criação.
`<sendgrid.updatedAt>`	string	Data e hora da última atualização.
`<sendgrid.listIds>`	json	Lista de IDs das listas a que o contato pertence.
`<sendgrid.customFields>`	json	Valores dos campos personalizados.
`<sendgrid.contacts>`	json	Lista de contatos.
`<sendgrid.contactCount>`	number	Quantidade de contatos.
`<sendgrid.lists>`	json	Lista das listas de contatos.
`<sendgrid.name>`	string	Nome do recurso.
`<sendgrid.templates>`	json	Lista de modelos.
`<sendgrid.generation>`	string	Geração do modelo.
`<sendgrid.versions>`	json	Lista de versões do modelo.
`<sendgrid.nextPageToken>`	string	Token da próxima página de resultados (list_all_lists, list_templates).
`<sendgrid.templateId>`	string	ID do modelo.
`<sendgrid.active>`	boolean	Indica se a versão do modelo está ativa.
`<sendgrid.htmlContent>`	string	Conteúdo HTML.
`<sendgrid.plainContent>`	string	Conteúdo em texto simples.
`<sendgrid.status>`	number	Código HTTP retornado pelo SendGrid. Use junto de body e data para conferir o resultado da operação.
`<sendgrid.body>`	json	Resposta completa do SendGrid.
`<sendgrid.data>`	json	Dados estruturados para outros blocos.

Exemplo de uso

Objetivo: Enviar uma confirmação por e-mail ou tratar uma mensagem recebida.

InícioSendGridpróxima etapa

Operação: Enviar e-mail
E-mail do remetente: cliente@exemplo.com
E-mail do destinatário: cliente@exemplo.com
Assunto: Exemplo de atendimento
Conteúdo: Olá! Sua solicitação foi processada com sucesso.
Tipo de conteúdo: Texto simples

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa: Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal: Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte: Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <sendgrid.success>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece: Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada: Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
O serviço recusou a chamada ou devolveu erro: Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

O que faz

Antes de começar

Passo a passo

Operações

Campos

Operação

Chave de API do SendGrid

E-mail do remetente

Nome do remetente

E-mail do destinatário

Nome do destinatário

Assunto

Conteúdo

Tipo de conteúdo

Cc

Cco

Responder para

Nome para resposta

ID do modelo

Dados do modelo dinâmico

Anexos

Anexos

E-mail

Nome

Sobrenome

Campos personalizados

IDs das listas

ID do contato

Consulta de busca

IDs dos contatos

Contatos (lista JSON)

Nome da lista

ID da lista

Itens por página

Token da página

Nome do modelo

ID do modelo

Geração do modelo

Filtrar por geração

Itens por página

Token da página

Nome da versão

Assunto do modelo

Conteúdo em HTML

Conteúdo em texto simples

Ativo

Saídas

Exemplo de uso

Erros comuns e como resolver

Blocos relacionados