Pular para as operações

Mensageria

Zenvia em um fluxo de decisão.

5 Zenvia 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

Plataforma brasileira de comunicação com o cliente em WhatsApp, SMS, e-mail e voz.

A Zenvia envia e recebe mensagens nos canais que o cliente brasileiro usa, a partir de uma credencial só e de um formato de mensagem só. É uma provedora oficial da solução WhatsApp Business, então as empresas chegam ao WhatsApp por ela sem tratar direto com a Meta. Ela também gera, entrega e verifica códigos de uso único, de modo que a aplicação nunca precisa guardar um.

O que um fluxo pode chamar

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

  1. POST/channels/whatsapp/messages

    Enviar uma mensagem de WhatsApp

    Envia uma mensagem de WhatsApp a partir de um remetente cadastrado.

  2. POST/channels/sms/messages

    Enviar um SMS

    O canal reserva para quando o WhatsApp não está cadastrado para o número ou o template foi recusado.

  3. POST/channels/email/messages

    Enviar um e-mail

    E-mail pela mesma credencial e no mesmo formato de mensagem dos outros canais.

  4. POST/2fa-tokens

    Enviar um código de uso único

    Gera um código, entrega pelo canal que a configuração indica e o guarda.

  5. POST/2fa-tokens/$data.zenvia_token_id/actions/verify

    Verificar um código de uso único

    Confere o código que a pessoa digitou contra o que a Zenvia enviou.

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 Zenvia 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 Zenvia as a connection authenticating with an API key.
  • 02A Zenvia 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 uma mensagem de WhatsApp” 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 Zenvia em um fluxo.

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

Adicione a Zenvia 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 Zenvia em uma decisão sem nunca ver o segredo.

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

A Zenvia 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 Zenvia?

5 operações, incluindo “Enviar uma mensagem de WhatsApp”, “Enviar um SMS”, “Enviar um e-mail”. 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 uma mensagem de WhatsApp”. 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 Zenvia 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 Zenvia 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