Pular para o conteúdo principal
Os fluxos de resposta estão em beta. Sua equipe precisa estar inscrita antes que a API aceite solicitações de fluxos de resposta; as outras equipes recebem 403 feature_unavailable.
Um fluxo de resposta é uma conversa curta e fixa que começa quando um destinatário responde a uma mensagem de campanha. Cada etapa pode enviar uma mensagem e depois aguarda a próxima resposta do destinatário. A resposta decide qual etapa é executada em seguida.

Como um fluxo de resposta funciona

  1. Crie uma revisão de fluxo de resposta com a Messaging API (Criar fluxo de resposta de campanha do projeto) ou com a Platform API (Criar fluxo de resposta de campanha).
  2. Vincule-o a uma campanha em rascunho ou agendada (Messaging, Platform).
  3. Quando uma mensagem de campanha é enviada, o fluxo começa para esse destinatário na etapa de entrada, que não envia nada e aguarda a primeira resposta.
  4. Uma resposta que corresponde a um dos ramos da etapa leva o destinatário à próxima etapa, que envia a sua mensagem. Uma resposta que não corresponde a nada é ignorada.
Respostas STOP e START são tratadas primeiro e nunca fazem um fluxo avançar. Quando sua equipe está com a captura de palavras-chave STOP/START ativada, as suas próprias palavras-chave de opt-out e de opt-in também têm prioridade: um ramo do fluxo baseado em uma dessas palavras nunca é acionado. Um destinatário que está na sua lista de opt-outs não recebe mensagens de fluxos de resposta, e fazer opt-out encerra o fluxo dele.

Limites

Uma revisão não pode ser editada. Para alterar um fluxo, crie uma nova revisão com o mesmo flowKey e uma revision maior e depois vincule-a a uma nova campanha. Uma campanha lançada mantém a revisão com que foi lançada.

Ramos

Cada ramo tem um match e a etapa para a qual leva (to):
  • choice: o destinatário tocou em um botão de resposta (replyKind: "button") ou em uma linha de lista (replyKind: "list") com este id. Uma etapa que envia botões ou uma lista só pode ramificar pelas opções que oferece.
  • keyword: o texto da resposta é igual a esta palavra-chave, sem diferenciar maiúsculas e minúsculas. Uma resposta que cita a mensagem da etapa sempre conta. Uma resposta sem citação só conta quando este é o único fluxo do destinatário aguardando resposta e nenhuma outra mensagem de campanha chegou a ele desde a mensagem da etapa. As palavras STOP e START integradas não podem ser palavras-chave de fluxo.
  • flow_submission: o destinatário enviou o formulário de Fluxo que esta etapa mandou. A Polymorfa não armazena as respostas do formulário.

Mensagens que uma etapa pode enviar

Uma etapa flow_form em um número vinculado encerra o fluxo do destinatário sem enviar nada. As mensagens de continuação usam as mesmas verificações de envio, o mesmo saldo e a mesma proteção de número das outras mensagens desse número. Se a Polymorfa não conseguir confirmar se uma mensagem de continuação chegou ao WhatsApp, ela nunca a envia de novo. Ela consulta o registro de envio: um envio confirmado continua o fluxo, e uma mensagem que nunca foi enviada, ou um fluxo que atinge antes a duração de 24 horas, encerra o fluxo.

Exemplo

As respostas de botões e listas também chegam aos seus webhooks como eventos message.received com payload.replyChoice. Consulte Webhooks.