Pular para as operações

Mensageria

SendGrid em um fluxo de decisão.

4 SendGrid operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Mensageria
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Somente host de produção

Quem são

E-mail transacional e em massa, em escala; parte da Twilio.

SendGrid sends the email an application produces — notices, letters, one-off transactional messages — and handles the deliverability work behind it: sender authentication, reputation, and bounce handling. It has been part of Twilio since 2019 and is documented alongside Twilio's other APIs.

O que um fluxo pode chamar

4 operações, cada uma um passo que você coloca no editor.

  1. POST/v3/mail/send

    Enviar um e-mail

    Envia uma mensagem. O endereço de origem precisa pertencer a um Single Sender verificado ou a um domínio autenticado, senão a chamada falha com 403 — é a primeira falha mais comum.

  2. POST/v3/mail/send

    Enviar um e-mail com template

    O mesmo endpoint, com o texto morando em um template dinâmico do SendGrid (um id com prefixo d-) em vez de no fluxo.

  3. POST/v3/mail/send

    Validar sem enviar (sandbox)

    O mesmo envio com mail_settings.sandbox_mode.enable ligado, o que valida a requisição e não entrega nada.

  4. GET/v3/messages

    Consultar o status de entrega

    Resultado de entrega por mensagem — processed, delivered ou not_delivered — mais as contagens de abertura e clique.

Onde isso entra na decisão

Messaging calls have a natural place in a flow.

Avisar uma pessoa faz parte da decisão, e não é um detalhe posterior: a mensagem sai do próprio fluxo, no ponto em que o fluxo decidiu que ela se justificava, carregando a mesma versão e a mesma trilha do resultado que a disparou.

Whatever SendGrid returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add SendGrid as a connection authenticating with an API key.
  • 02A SendGrid tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “Enviar um e-mail” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a SendGrid em um fluxo.

Como conecto a SendGrid a um fluxo de decisão?

Adicione a SendGrid como uma conexão no seu workspace, autenticando com uma chave de API, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a SendGrid em uma decisão sem nunca ver o segredo.

Dá para testar a SendGrid sem tocar em produção?

A SendGrid expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na SendGrid?

4 operações, incluindo “Enviar um e-mail”, “Enviar um e-mail com template”, “Validar sem enviar (sandbox)”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “Enviar um e-mail”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a SendGrid deve ser chamada?

Avisar uma pessoa faz parte da decisão, e não é um detalhe posterior: a mensagem sai do próprio fluxo, no ponto em que o fluxo decidiu que ela se justificava, carregando a mesma versão e a mesma trilha do resultado que a disparou.

Quando você quiser

Wire SendGrid into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação