Skip to main content
O WhatsApp Flows permite que os clientes concluam tarefas estruturadas dentro do WhatsApp, como escolher um agendamento, enviar uma solicitação ou responder a um questionário rápido.
Exemplo da Meta de telas do WhatsApp Flow, desde o botão de mensagem até as preferências e seleção do produto e a mensagem de acompanhamento.

Meta example: a message opens a multi-screen Flow for product preferences and selection. This illustrates the customer experience, not YCloud's Flow editor.

Fonte: Exemplo oficial da Meta.

​
Entenda os elementos fundamentais

Um Flow pertence a uma WABA. Sua definição descreve telas, campos de entrada, navegação e comportamento de conclusão. Alguns Flows usam dados fornecidos quando a mensagem é enviada. Outros precisam de um endpoint de dados para recuperar informações atuais ou processar seleções durante a interação. Por exemplo, um Flow de agendamento pode coletar o serviço, a data de preferência e os detalhes de contato. Se precisar exibir disponibilidade em tempo real, o endpoint e seu sistema de agendamento devem coordenar esses dados. A Meta disponibiliza guias de Flows para design de telas, integração de endpoints, criptografia, testes e monitoramento de integridade.

​
Um Flow e seu convite são separados

Você envia uma mensagem que abre o Flow:
  • Use uma mensagem interativa de Flow suportada dentro de uma janela de atendimento aberta.
  • Use um modelo aprovado com um botão de Flow quando um modelo for obrigatório.
A finalidade do Flow não determina automaticamente a categoria do modelo. Um convite promocional e uma atualização de agendamento podem abrir um formulário, mas exigir tratamento de modelo diferente. Consulte Componentes e formatos de modelo e Mensagens de serviço.

​
Criar, testar e publicar

O guia da API de Flows da YCloud aborda a criação, recuperação, atualização, pré-visualização, publicação e descontinuação de Flows. Mantenha o trabalho em rascunho enquanto valida a estrutura e testa a jornada do cliente. A publicação é um limite de ciclo de vida; planeje uma versão de substituição ao alterar uma experiência em produção e verifique as regras atuais da API antes de tentar uma alteração direta. Teste:
  • Campos obrigatórios e entradas inválidas.
  • Navegação para voltar e abandono.
  • Erros de endpoint ou agendamentos indisponíveis.
  • Envios duplicados.
  • Mensagens de conclusão e a próxima ação de negócios.
Um Flow concluído não é automaticamente um agendamento confirmado, pedido pago ou solicitação aprovada. O seu sistema de negócios precisa validar e concluir essa ação.

​
Exemplo: uma solicitação de agendamento

Uma primeira versão útil tem três telas: Use um Flow estático se você apenas coletar um horário de preferência para um atendente confirmar mais tarde. Use um Flow integrado a endpoint se as opções disponíveis precisarem mudar com o estoque em tempo real. Não exiba uma lista estática como disponibilidade garantida. Escreva a tela de conclusão de acordo com o resultado. “Solicitação recebida” é apropriado quando a equipe ainda precisa confirmar; “Agendamento confirmado” requer reserva bem-sucedida em seu sistema de agendamento.

​
Mantenha os identificadores separados

  • O Flow ID identifica o formulário reutilizável.
  • O ID da mensagem identifica um convite e seu envio.
  • Um token de Flow, quando fornecido pela sua integração, associa a interação ao contexto do seu negócio.
  • O seu ID de agendamento ou solicitação identifica o registro de negócios resultante.
Um token deve ser uma referência opaca, não uma senha ou informações pessoais do cliente. Valide os valores enviados no seu servidor mesmo que o formulário restrinja as opções disponíveis.

​
Diagnostique a etapa correta

Essas verificações evitam que um problema de entrega seja confundido com um problema de formulário ou agendamento.

​
Trate os dados com cuidado

Colete apenas as informações necessárias. Explique seu uso e forneça informações de privacidade relevantes. Para Flows alimentados por endpoint, siga os requisitos de criptografia e endpoint da Meta. Mantenha segredos fora do JSON do Flow e de pré-visualizações públicas. Use dados sintéticos para testes. Salve e processe envios no contexto correto do cliente. Projete o tratamento de duplicidades para que um envio repetido não crie dois agendamentos ou cobranças.

​
Continuar no YCloud

Mantenha a entrega do Flow, o envio do formulário e o resultado de negócios como métricas separadas.

​
Perguntas frequentes

Não. Um Flow estático pode coletar seleções ou informações sem buscar dados em tempo real a cada tela. Use um endpoint quando opções ou validações dependerem de sistemas atuais, como horários de agendamento disponíveis. Você ainda precisará decidir para onde as respostas concluídas vão e quem atuará sobre elas.
Apenas se o seu sistema de agendamento reservou o horário com sucesso. Um formulário preenchido pode ser uma solicitação em vez de um agendamento confirmado. Use um ID de solicitação, valide a disponibilidade, trate envios duplicados e certifique-se de que o texto de confirmação corresponda ao resultado real.
O formulário e o convite dele são coisas separadas. Use uma mensagem interativa de Flow qualificada durante a janela de atendimento ou um modelo aprovado com um botão de Flow quando um modelo for necessário. A finalidade real do convite determina sua categoria; anexar um formulário não transforma uma mensagem promocional em utilidade.