🚀 Wati AI chegou – A Camada de Inteligência Conversacional para Negócios Modernos Explorar🚀 Wati AI chegou →

WhatsApp Flows

WhatsApp Flows: formulários que os clientes preenchem dentro do chat.

Colete leads, agendamentos e feedbacks com formulários de várias telas que abrem no WhatsApp. Crie-os no Wati sem código hoje mesmo. A API de Flows está chegando em breve.

Última atualização em

Situação atual do WhatsApp Flows

RecursoComo usarStatus
Criar um Flow em um construtor de arrastar e soltar, a partir de um modelo ou do zeroAplicativo Wati: Automação > WhatsApp FlowsAtivo
Enviar um Flow durante uma conversa com chatbotConstrutor de chatbots: Nó do WhatsApp FlowAtivo
Enviar um Flow para uma lista de contatosAnexe-o a um modelo e envie uma campanhaAtivo
Salvar cada resposta no contatoAtributos personalizados, criados automaticamenteAtivo
Enviar um modelo de Flow a partir do seu próprio códigoAPI de envio de modelos, como qualquer modelo aprovadoAtivo
Criar e gerenciar Flows por APIAPI de FlowsEm breve

Os WhatsApp Flows estão disponíveis nos planos Pro e Business: o Pro inclui até 2 Flows e o Business até 10. Ainda não há endpoints de Flows na API do Wati. Fale conosco sobre o seu caso de uso.

  • 16.000+empresas em mais de 190 países
  • 4,6/5avaliação média no G2
  • OficialParceiro de Negócios da Meta e BSP do WhatsApp
G2 Leader, ChatbotsG2 Leader Mid-Market, ChatbotsG2 Momentum Leader, ChatbotsG2 Most Implementable, WhatsApp MarketingISO 27001GDPR

Um toque. O formulário inteiro.

Formulários de leads, agendamentos e pesquisas que os clientes preenchem sem sair do WhatsApp.

  • Começa com um modeloUm modelo aprovado inicia a conversa, para um cliente ou 10.000.
  • Continua no chatTexto, mídia e botões assim que o cliente responde.
  • Termina com sua equipeOs webhooks informam o seu código. A caixa de entrada da equipe informa as pessoas.
O básico

O que são os WhatsApp Flows?

Os WhatsApp Flows são formulários que abrem dentro de um chat do WhatsApp. Um cliente toca em um botão, avança por uma ou mais telas de campos, menus suspensos e seletores de data, e envia as respostas de volta sem sair da conversa.

  1. Criar

    Crie no Wati

    Vá para Automação > WhatsApp Flows. Comece a partir do modelo de Geração de Leads ou Formulário de Feedback, ou do zero, e publique.

  2. Enviar

    Envie por chatbot ou campanha

    Adicione um nó de WhatsApp Flow a um chatbot ou anexe o Flow a um modelo e envie em uma campanha.

  3. Coletar

    As respostas vão para o contato

    Cada resposta é salva no contato como um atributo personalizado, para que a caixa de entrada da sua equipe e a próxima etapa do chatbot possam usá-la.

O que as equipes criam com os WhatsApp Flows

  • Geração de leads

    Solicite nome, empresa e o que o lead precisa em um único formulário. Sua equipe de vendas vê as respostas no contato dentro da caixa de entrada da equipe.

    Modelo de Geração de Leads
  • Agendamentos e consultas

    Permita que os clientes escolham um serviço e uma data para um atendimento, uma aula ou um retorno de chamada, em poucos cliques.

    Seletor de data
  • Pesquisas e feedback

    Envie uma pesquisa curta após uma entrega ou um chat de suporte, e mantenha cada nota registrada no contato.

    Modelo de Formulário de Feedback
O produto

Envie. Responda. Obtenha retorno. Transfira.

Transmissões

Mensagens personalizadas, enviadas em escala.

Escolha um modelo aprovado e envie para até 10.000 destinatários. Cada pessoa recebe suas próprias variáveis, e cada resultado retorna por número.

Mensagens

Responda com mais do que texto.

Dentro da janela de 24 horas, envie texto, imagens, arquivos, botões de resposta e seletores de lista, com um indicador de digitação enquanto você trabalha.

Atualizações de pedidos e alertas

A atualização certa, no momento em que acontece.

Sua loja, sistema de reservas ou faturamento envia um modelo aprovado quando algo muda. Os clientes tocam em um botão ou respondem.

Resposta automática e chatbots

Seu código responde.

O webhook de mensagem traz cada nova mensagem para o seu servidor. Responda com os endpoints de envio ou inicie um chatbot Wati nos planos Pro e Business.

Webhooks

Cada resposta, no momento em que chega.

Webhooks enviam novas mensagens, confirmações de leitura, cliques e falhas para a sua URL. Sem polling.

Caixa de entrada da equipe

O código começa. As pessoas terminam.

As respostas chegam à caixa de entrada da equipe do Wati. Atribua um operador, defina o status e adicione tags via API para que a pessoa certa assuma o atendimento.

Contatos e segmentos

Seu CRM, espelhado no Wati.

Crie e atualize contatos com atributos personalizados, depois visualize uma prévia do segmento antes de enviar a mensagem.

InstagramComentários e DMs do Instagram

Crie automação no Instagram também.

Liste comentários em suas postagens, responda publicamente ou envie uma resposta privada.

Começar

Pronto em três passos.

  1. Conectar

    Conecte seu número

    Vincule seu número do WhatsApp por meio do Cadastro Incorporado da Meta dentro do Wati.

  2. Autenticar

    Obtenha um token

    Crie um token de API no Wati e conceda a ele apenas os escopos necessários. Mantenha-o em seu servidor.

  3. Enviar

    Faça sua primeira chamada

    Envie um modelo aprovado com uma única requisição. Em seguida, adicione um webhook para acompanhar a entrega.

Sua primeira requisição, explicada

Veja o que compõe uma requisição e onde cada parte aparece na mensagem.

  1. Quem

    O número de WhatsApp do cliente, com o código do país.

    phone_number14155552671
  2. Qual mensagem

    O nome de um modelo que a Meta aprovou em sua conta.

    template_nameorder_update
  3. O que preencher

    Os valores para os espaços em branco no modelo, um por pessoa.

    custom_paramsname = Mayaorder_id = 10482
  4. Sua chave

    Seu token de API, enviado a cada requisição. Mantenha-o em seu servidor.

    Authorization: Bearer <token>
  5. O que você recebe de volta

    Um 200 significa que o Wati aceitou a mensagem, junto com um broadcast_id. As confirmações de entrega e leitura chegam posteriormente via webhook.

    200broadcast_id

O texto da mensagem e o order_update são exemplos. O seu modelo aprovado define a redação.

Código pronto para usoOcultar o código
POST/api/ext/v3/messageTemplates/send
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template_name": "order_update",
    "broadcast_name": "order_update_api",
    "recipients": [
      {
        "phone_number": "14155552671",
        "custom_params": [
          { "name": "name", "value": "Maya" },
          { "name": "order_id", "value": "10482" }
        ] 
      }
    ]
  }'
200 Resposta de exemploFormato do exemplo da documentação
{
  "success": true,
  "broadcast_id": "broadcast_123456",
  "recipients": [
    {
      "local_message_id": "local-msg-123",
      "phone_number": "14155552671",
      "errors": []
    }
  ]
}
Criado em

O que o Wati resolve para você não ter trabalho.

Onboarding de números

Conecte-se por meio do Cadastro Incorporado da Meta. A conta do WhatsApp Business é registrada em nome da sua empresa.

Status de modelos

Alterações de aprovação, qualidade e categoria chegam como webhooks, para você saber antes que um envio falhe.

Tentativas de webhook

Até 144 tentativas, a cada 10 minutos. Se o seu endpoint continuar falhando, o Wati envia um e-mail.

Limites de taxa e filas

Se você enviar rápido demais, receberá um erro 429 com um cabeçalho Retry-After. As mensagens aceitas ficam aguardando em uma fila.

Transferência humana

Uma caixa de entrada compartilhada para a equipe cuidar das conversas que seu código não deve responder sozinho.

Tokens de API com escopo

A v3 oferece suporte a tokens com escopo, garantindo que cada integração tenha apenas o acesso necessário.

Envios agendados

Agende o envio de um modelo para mais tarde com apenas uma chamada. O Wati envia na hora certa.

Estimativa de custo prévia

Estime quanto uma transmissão custará antes de qualquer envio ser realizado.

Nos bastidores

Os endpoints, por funcionalidade.

Modelos

Inicie conversas com modelos aprovados, seja agora ou de forma agendada.

Documentação →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

Transmissões

Consulte os resultados de campanhas e o status por destinatário, além de estimar o custo antecipadamente.

Documentação →
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

Mensagens

Responda com texto, mídia ou botões dentro da janela de 24 horas.

Documentação →
POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

Chatbots Pro+

Liste seus chatbots do Wati e inicie um para um contato específico.

Documentação →
GET/chatbotsPOST/chatbots/start

Webhooks

Gerencie assinaturas e liste os tipos de eventos que você pode receber.

Documentação →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

Contatos e segmentos

Sincronize contatos e atributos do seu CRM e, em seguida, segmente o público-alvo.

Documentação →
POST/contactsPUT/contactsPOST/segments/evaluate

Caixa de entrada da equipe

Atribua um operador, altere o status e adicione ou remova tags.

Documentação →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

Liste publicações e comentários, responda publicamente ou em privado e verifique permissões.

Documentação →
GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

Os caminhos são relativos a https://live-mt-server.wati.io/api/ext/v3. A criação de um webhook utiliza o caminho legado POST /{tenantId}/api/v2/webhookEndpoints.

Para agentes de IA, o servidor Wati MCP abrange as mesmas ações do WhatsApp e pode responder a DMs do Instagram e chats do Messenger com texto.

Ver todos os 19 tipos de eventos de webhook do WhatsApp

Mensagens

  • message
  • newContactMessageReceived
  • sessionMessageSent_v2
  • templateMessageSent_v2

Status de entrega

  • sentMessageDELIVERED_v2
  • sentMessageREAD_v2
  • sentMessageREPLIED_v2
  • templateMessageFailed

Modelos e conta

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

Engajamento e chamadas

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

Versões BSUID de vários eventos também estão disponíveis. Documentação de webhooks

Limites e planos

Limites claros. Publicados.

30 a 100 por 10 s

Envios de modelos

Chamadas para enviar modelos, dependendo do seu plano (Growth, Pro ou Business).

10.000 destinatários

Por chamada de envio v3

Um modelo, para até 10.000 pessoas, cada uma com suas próprias variáveis.

24 h de janela

Respostas em formato livre

Texto, mídia e botões exigem uma janela de atendimento ao cliente aberta. Fora dela, envie um modelo.

429 Retry-After

Quando você envia rápido demais

O Wati informa quanto tempo você deve esperar. As mensagens aceitas são processadas em uma fila.

Limites de taxa e disponibilidade de planos em detalhes
Limites de taxa documentados por plano
EndpointGrowthProBusiness
/addContact, /getContacts10 / 10 s10 / 10 s10 / 10 s
/getMessages10 / 10 s10 / 10 s10 / 10 s
/sendTemplateMessage30 / 10 s60 / 10 s100 / 10 s
/sendTemplateMessages30 / 10 s60 / 10 s100 / 10 s

Limites conforme publicados em Erros e Limites de Taxa, listados pelo nome do endpoint. A chamada em lote da v1 aceita até 1.000 contatos. Os endpoints principais de mensagens, modelos e contatos estão disponíveis em todos os planos. A atribuição de equipe, status de chat, chatbots e segmentos personalizados exigem os planos Pro ou Business. A atualização de atributos para vários contatos de uma só vez exige o plano Business. Disponibilidade de endpoints por plano. Para limites mais altos, fale com a equipe do Wati sobre o seu caso de uso.

FAQ

Perguntas frequentes

A configuração passo a passo está na central de ajuda. Como criar e usar o WhatsApp Flows

O que é o WhatsApp Flows?

O WhatsApp Flows consiste em formulários que abrem dentro de um chat do WhatsApp. O cliente toca em um botão em uma mensagem, preenche uma ou mais telas e envia, tudo sem sair do chat. As empresas utilizam essa ferramenta para formulários de geração de leads, reservas, agendamentos, pesquisas e feedbacks.

Como crio um WhatsApp Flows no Wati?

Vá para Automação > WhatsApp Flows. Escolha o modelo de Geração de Leads ou Formulário de Feedback, ou comece do zero, e edite no construtor do tipo arrastar e soltar. Você pode adicionar telas, menus suspensos e um seletor de data.

Salve como rascunho ou publique. Um Flow publicado não pode ser editado, portanto, mantenha-o como rascunho até que esteja pronto.

Como faço para enviar um Flow para os clientes?

De duas maneiras. Em um chatbot, adicione um nó do WhatsApp Flows e escolha um Flow publicado. Para alcançar uma lista de contatos, anexe o Flow a um modelo, obtenha a aprovação do modelo e envie-o em uma campanha.

Cada resposta é salva no contato como um atributo personalizado, e você pode visualizá-la na caixa de entrada da equipe.

Existe uma API do WhatsApp Flows?

Ainda não. A API do Flows estará disponível em breve e, atualmente, não há endpoints do Flows na API do Wati. Compartilhe seu caso de uso com nossa equipe.

Até lá, crie os Flows no aplicativo do Wati. Se um Flow estiver anexado a um modelo aprovado, você poderá enviar esse modelo a partir do seu código como qualquer outro modelo aprovado.

O que preciso para usar o WhatsApp Flows?

O WhatsApp Flows está disponível nos planos Pro e Business: o Pro inclui até 2 Flows e o Business, até 10. A Meta também exige um Portfólio Comercial verificado, um limite de mensagens de pelo menos 2.000 e uma classificação de alta qualidade.

Quais são os limites de taxa da API?

As chamadas de histórico de mensagens e de contatos são limitadas a 10 solicitações a cada 10 segundos em todos os planos. Os envios de modelos são limitados a 30, 60 ou 100 solicitações a cada 10 segundos nos planos Growth, Pro e Business. Quando você atinge um limite, recebe o erro HTTP 429 com um cabeçalho Retry-After. Para limites maiores, entre em contato com o Wati.

Posso enviar mensagens para um cliente a qualquer momento?

No WhatsApp, textos livres, mídias e mensagens interativas exigem uma janela de atendimento ao cliente aberta de 24 horas. Fora desse período, inicie a conversa com um modelo aprovado pela Meta.

Qual é a diferença entre o aplicativo WhatsApp Business e a API?

O aplicativo Business é para chats manuais em um telefone, com até 5 dispositivos vinculados e listas de transmissão limitadas a 256 contatos. A API conecta o WhatsApp aos seus próprios sistemas. Você pode enviar modelos aprovados em volume, automatizar respostas, receber webhooks e compartilhar um único número em uma caixa de entrada de equipe.

Quais endpoints estão incluídos no meu plano?

Os endpoints principais de mensagens, modelos e contatos estão em todos os planos. A atribuição de equipe, o status do chat, os chatbots e os segmentos personalizados exigem os planos Pro ou Business. A documentação lista a disponibilidade de endpoints por plano.

Quer a API do Flows? Conte-nos o que você criaria.

O Flows funciona no Wati hoje, sem código. A API do Flows estará disponível em breve. Compartilhe seu caso de uso com nossa equipe.