Pular para as operações

Mensageria

Twilio em um fluxo de decisão.

4 Twilio 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
HTTP basic auth
Ambiente de teste
Somente host de produção

Quem são

APIs programáveis de SMS, voz e mensagens.

A Twilio vende comunicação como API: SMS, voz, WhatsApp e códigos de verificação, com as relações com operadoras e o provisionamento de números por trás. Em uma decisão, é como uma mensagem chega a alguém que não está na frente do seu produto naquele momento.

O que um fluxo pode chamar

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

  1. POST/Accounts/$data.twilio_account_sid/Messages.json

    Enviar um SMS

    Envia um texto. To e From seguem o E.164 — sinal de mais na frente, só dígitos.

  2. GET/Accounts/$data.twilio_account_sid/Messages/$data.twilio_message_sid.json

    Checar o status de entrega

    Busca uma mensagem pelo SID SM… que Enviar um SMS devolveu em body.sid.

  3. GET/Accounts/$data.twilio_account_sid/Messages.json

    Listar mensagens para um número

    Histórico de mensagens, da mais nova para a mais antiga. Filtre com parâmetros de query no nó — To, From, DateSent, PageSize — em vez de puxar a conta inteira.

  4. DELETE/Accounts/$data.twilio_account_sid/Messages/$data.twilio_message_sid.json

    Apagar o conteúdo de uma mensagem

    Apaga o registro da mensagem, incluindo o texto, da Twilio.

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 Twilio 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 Twilio as a connection authenticating with HTTP basic auth.
  • 02A Twilio 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 SMS” 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 Twilio em um fluxo.

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

Adicione a Twilio como uma conexão no seu workspace, autenticando com HTTP basic auth, 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 Twilio em uma decisão sem nunca ver o segredo.

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

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

4 operações, incluindo “Enviar um SMS”, “Checar o status de entrega”, “Listar mensagens para um número”. 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 SMS”. 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 Twilio 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 Twilio 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