Pular para as operações

Mensageria

WhatsApp Cloud API em um fluxo de decisão.

4 WhatsApp Cloud API 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

Meta's hosted API for sending WhatsApp messages at scale.

The WhatsApp Cloud API lets a business send and receive WhatsApp messages from its own systems, hosted by Meta rather than on the business's servers. Messages a business starts must use templates approved in advance; free text is allowed only inside the 24-hour window a person opens by writing first. In Brazil and much of the world it is the channel people actually read.

O que um fluxo pode chamar

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

  1. POST/$data.whatsapp_phone_number_id/messages

    Enviar uma mensagem de template aprovado

    A chamada a usar para qualquer coisa que a decisão inicie.

  2. POST/$data.whatsapp_phone_number_id/messages

    Enviar uma resposta em texto livre

    Texto livre, que a Meta só entrega dentro da janela de atendimento de 24 horas que a pessoa abriu ao mandar mensagem para você.

  3. POST/$data.whatsapp_phone_number_id/messages

    Marcar uma mensagem recebida como lida

    Marca como lida uma mensagem que o solicitante enviou.

  4. GET/$data.whatsapp_phone_number_id

    Check the sender's status

    Reads the sender's display name, quality rating and messaging limit.

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 WhatsApp Cloud API 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 WhatsApp Cloud API as a connection authenticating with an API key.
  • 02A WhatsApp Cloud API 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 template aprovado” 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 WhatsApp Cloud API em um fluxo.

Como conecto a WhatsApp Cloud API a um fluxo de decisão?

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

Dá para testar a WhatsApp Cloud API sem tocar em produção?

A WhatsApp Cloud API 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 WhatsApp Cloud API?

4 operações, incluindo “Enviar uma mensagem de template aprovado”, “Enviar uma resposta em texto livre”, “Marcar uma mensagem recebida como lida”. 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 template aprovado”. 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 WhatsApp Cloud API 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.

Also in Messaging

Quando você quiser

Wire WhatsApp Cloud API 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