Skip to Content
AgentsAgent Flows (Formulários do WhatsApp)

Agent Flows

Formulários de várias telas que um agent de IA pode entregar a um cliente no meio de uma conversa. O agent decide quando pedir informações estruturadas — nome, datas, uma foto de documento, um questionário de várias etapas — e o seu cliente preenche tudo em um formulário nativo, em vez de uma longa troca de mensagens.

O Agent Flows funciona no WhatsApp, no Telegram, no Messenger e no widget de chat do seu site e está disponível em todos os planos pagos (com limites por plano; veja a tabela de limites por plano mais abaixo). Crie um flow uma vez; ele é renderizado de forma nativa em todos os canais compatíveis.

Canais compatíveis

Um flow é independente do canal: você o desenha uma vez e ele é renderizado de forma nativa onde quer que o agent rode.

CanalComo o formulário abreObservações
WhatsAppO agent envia um botão nativo de WhatsApp Flow; o formulário abre dentro do WhatsAppPublica por idioma na Meta; é o único canal com limites de texto rico definidos pelo WhatsApp
TelegramO agent envia um botão inline que abre o formulário como Mini App do TelegramTexto rico completo (negrito, títulos, listas, tabelas)
MessengerO agent envia um botão que abre o formulário em um Webview do MessengerTexto rico completo
Widget de chat do siteO formulário abre dentro do widget de chat embutido no seu siteRenderizador leve; o texto rico se limita a negrito, itálico, links e listas

Os mesmos componentes, telas, lógica e traduções funcionam em todos os canais — não há nada por canal para manter. A lógica condicional (If / Switch) e o roteamento entre telas são avaliados da mesma forma em cada renderizador, então um flow se comporta de modo idêntico não importa onde o seu cliente o preencha.

Publique um mesmo flow em vários canais de uma vez. Na aba Distribuir do flow, cada canal tem o seu próprio cartão de publicação. Publique em um número de WhatsApp e depois publique o mesmo flow em um bot do Telegram e uma página do Messenger: cada cartão permanece publicado de forma independente, e adicionar um canal nunca despublica outro. Despublique um único canal pelo seu cartão sem mexer nos demais. As análises se combinam por padrão entre todos os canais em que o flow está no ar; quando um flow está no ar em dois ou mais canais, aparece um filtro de canal nas telas de Envios, Mapa de calor e Diagnóstico para você analisar um canal de cada vez.

Quando usar o Agent Flows

Use um flow quando o chat sozinho não for o formato certo para a pergunta:

  • Captura de leads — nome + e-mail + porte da empresa + preferência de reunião, tudo em uma tela que o cliente preenche de uma só vez
  • Agendamento de horários — escolher uma data, escolher um horário, confirmar
  • Envio de documentos ou fotos — coletar um documento, um recibo, a foto de um produto danificado
  • Triagem de várias etapas — listas de sintomas, formulários de inscrição, pesquisas
  • Perguntas condicionais — perguntar “que tipo de animal de estimação?” somente se a pessoa responder sim a “você tem um animal de estimação?”

O agent recomenda um flow quando o prompt de sistema dele + o contexto da conversa coincidem. Você configura o flow uma única vez no painel de administração; o agent o reutiliza em todas as conversas.

Criar um flow

Os flows ficam em Agent Flows no painel de administração do cliente. Cada flow tem:

  • Um nome e uma descrição que o agent lê para decidir quando usá-lo
  • Uma ou mais telas, cada uma com componentes (campos)
  • Lógica de tela opcional (ramificar para telas diferentes conforme o que o cliente escolher)
  • Variantes A/B opcionais — divide o tráfego entre duas versões do mesmo flow
  • Publicações por idioma no WhatsApp (traduza uma vez, publique por idioma)

Começar a partir de um modelo

Você não precisa começar com um editor em branco. Abra a aba Modelos na lista de Agent Flows para explorar uma biblioteca curada de flows prontos para usar: captação de leads, agendamento de demos, recepção de suporte, opiniões de produto e muito mais. Clique em Usar este modelo e ele cria um rascunho editável no seu próprio workspace: as telas, os campos, a lógica e as traduções vêm preenchidos. Vincule o rascunho a um número do WhatsApp, ajuste o que quiser e publique.

Um modelo é só um ponto de partida: depois que você cria sua cópia, ela é um flow normal que pertence totalmente a você e que você pode editar à vontade. A biblioteca de modelos está disponível em todos os planos que incluem Agent Flows.

Biblioteca de componentes — 23 variantes

O menu Add field do editor agrupa os 23 componentes em sete categorias. Escolha o formato certo para os dados de que você precisa.

Display (exibição, sem entrada)

Estes mostram texto ou imagens na tela sem pedir nenhuma entrada do cliente.

ComponenteUse para
Text HeadingUm título grande no topo de uma tela (≤ 80 caracteres)
Text SubheadingUm título secundário abaixo do título principal (≤ 80 caracteres)
Text BodyUm parágrafo de texto explicativo. Aceita negrito e tachado (≤ 4096 caracteres)
Text CaptionTexto de apoio curto; markdown permitido (≤ 4096 caracteres)
Rich TextUm bloco markdown — útil para termos, avisos legais, instruções formatadas
ImageUma única imagem (≤ 100 KB)
Image CarouselAté 10 imagens deslizáveis com legendas — galerias de produtos, antes/depois, instruções

Inputs (texto de uma e de várias linhas)

ComponenteUse para
Text InputUma caixa de texto de uma linha — nome, e-mail, respostas curtas
Text AreaUma caixa de texto de várias linhas — comentários, descrições, respostas mais longas (≤ 600 caracteres)
Embedded LinkUm link embutido para tocar e abrir, com texto personalizado (≤ 25 caracteres)

Choices (escolher de um conjunto)

ComponenteUse para
DropdownEscolher um item de uma lista longa (mais de 10 opções)
Radio ButtonsEscolher um item de uma lista curta (≤ 5 opções), todas visíveis ao mesmo tempo
CheckboxesEscolher qualquer quantidade de itens de uma lista, com mínimo e máximo opcionais
Chips SelectorEscolher entre até 20 chips no estilo etiqueta — interesses, categorias, seleção múltipla ocupando pouco espaço

Data e hora

ComponenteUse para
Date PickerUma única data — data de reserva, data de nascimento
Calendar PickerUma superfície de calendário com intervalo de datas opcional, limites mínimo/máximo e datas indisponíveis esmaecidas — agendamento de horários, estadias em hotel

Tanto o Date Picker quanto o Calendar Picker são mantidos como componentes distintos. Use o Date Picker para uma única data rápida; use o Calendar Picker quando precisar de uma grade de mês visível, de um intervalo ou de esmaecer datas específicas.

Envios de arquivos

ComponenteUse para
Photo PickerO cliente envia fotos da câmera ou da galeria (até 30 por envio)
Document PickerO cliente envia documentos — PDF, DOC, etc. (até 10 por envio)

Exclusão mútua: Uma única tela pode conter um Photo Picker ou um Document Picker, mas não os dois. Coloque-os em telas separadas se o seu flow precisar dos dois tipos de envio.

Layout

ComponenteUse para
Navigation ListAté 20 linhas tocáveis com chevrons — escolher uma categoria, escolher um produto, escolher uma tela de destino
Opt-InUma caixa de consentimento — termos de serviço, consentimento de marketing, consentimento da LGPD/GDPR
FooterO elemento de envio na última tela do flow

Logic (renderização condicional)

ComponenteUse para
IfRenderizar alguns componentes apenas quando uma condição for verdadeira (then) — opcionalmente com uma alternativa (else)
SwitchRenderizar componentes diferentes conforme um valor que o cliente escolheu antes (vários cases + um default opcional)

If e Switch aceitam até 3 níveis de aninhamento. Se você perceber que está aninhando mais fundo do que isso, divida a lógica em várias telas com roteamento no nível da tela.

Flows de várias telas e roteamento

Um flow pode ter até 10 telas. Cada tela termina com um Footer que envia o flow ou avança para a próxima tela. Use o editor de lógica de tela para encaminhar o cliente a uma próxima tela diferente conforme o que ele escolheu — por exemplo, clientes que selecionam “Reembolso” vão para uma segunda tela específica de reembolsos; todos os demais vão para a tela de acompanhamento genérica.

Para renderização condicional no nível do componente dentro de uma única tela, use If / Switch.

Localização

Os flows são publicados por idioma. Traduza o flow uma vez e escolha os idiomas em que você publica a partir da lista completa de idiomas com suporte do WhatsApp — todos os idiomas em que a Meta permite publicar um WhatsApp Flow. O seletor mostra opções distintas por região quando isso importa, então você pode publicar Português (Brasil) separadamente de Português (Portugal), ou 中文 (简体) separadamente de 中文 (繁體). Cada cliente vê a versão que corresponde ao idioma do WhatsApp dele; se o idioma de um cliente não estiver publicado, o idioma padrão da integração é usado como fallback. (Quando o cliente escreve em um idioma base, como português, e você publicou apenas uma variante regional, como o português do Brasil, ele ainda recebe o formulário localizado.)

Testes A/B

Se você quiser testar duas versões de um flow entre si, configure-as como variantes na aba Variants. Os clientes são divididos de forma determinística (o mesmo cliente sempre vê a mesma variante); a visão Submissions mostra de qual variante veio cada envio, e o Field Heatmap permite comparar as taxas de abandono e de conclusão lado a lado.

Geração por IA

Se você tem um plano de nível superior, o editor oferece geração de formulários por IA: escreva um prompt de uma linha (“um formulário de reserva de hotel com intervalo de datas e envio de foto”), ou envie um PDF / imagem de um formulário existente, e o assistente redige o flow para você. O rascunho é totalmente editável — cada campo é reversível no editor (sem instantâneos opacos de IA).

Envios e análises

Depois que um flow é publicado, cada envio chega à visão Submissions desse flow. Cada linha mostra:

  • Quem enviou, quando e por meio de qual agent
  • Os valores completos dos campos do formulário
  • Uma pontuação de IA (0–100) que o assistente atribuiu ao envio — os leads de maior valor sobem para o topo
  • Os turnos de chat da conversa logo antes de o formulário ser aberto (a junção com o contexto da conversa — para ver por que o agent decidiu pedir este envio)

As análises agregadas incluem uma faixa de KPIs (iniciados / concluídos / taxa de abandono), um Field-Level Heatmap que mostra onde os clientes desistem e um Narrative Diagnostic — um analista de IA a quem você pode perguntar “por que as pessoas estão desistindo na tela 2?” e que rastreia a resposta pelo mapa de calor, pelos envios e pelo contexto da conversa.

Notificações e o funil de leads

Um envio só vale se alguém agir rápido. A aba Distribuir de cada fluxo tem um bloco de notificações para que as pessoas certas fiquem sabendo de um lead assim que ele chega:

  • Notificações de envio — quando um formulário é enviado, aparece uma notificação no app, com link direto para aquele envio. Você ativa por fluxo.
  • Notificações de resposta após assumir o atendimento — quando alguém da sua equipe responde a um lead no WhatsApp e o cliente escreve de volta, você recebe uma segunda notificação — o segundo tempo do ciclo de velocidade de resposta.
  • Destinatários de e-mail — adicione até dez endereços de e-mail e cada envio também dispara um e-mail diferido com link para o envio, para que a equipe offline não perca o lead.

Um cliente tagarela não vai te encher de notificações: uma rajada de mensagens logo após um envio é agrupada em uma única notificação, e uma nova só dispara depois que um humano de fato respondeu e o cliente volta a escrever.

Cada fluxo também tem uma faixa de funil na sua página de envios — uma visão somente leitura para ver num relance em que ponto os leads estão:

EtapaSignificado
Enviadotodos os envios do fluxo
Atendido pela IAo agente deu sequência à conversa depois do formulário
Respondido por humanoalguém da sua equipe respondeu manualmente
Resolvidoa conversa foi arquivada
Aguardando resposta humananotificado, mas nenhum humano respondeu ainda — seus leads em risco

O funil é uma visão heurística para gerenciar o pipeline num relance, não um modelo de atribuição de receita.

Confirmações contextuais

Quando um cliente termina um formulário, ele vê a mensagem de confirmação instantânea que você configurou nele (no WhatsApp, é a tela de conclusão nativa). Logo depois, o agente também envia uma mensagem separada que faz referência ao que o cliente realmente preencheu —“Pronto, agendei você para terça às 14h. Mais alguma coisa?”— para que a conversa continue de forma natural em vez de deixar o cliente diante de um “obrigado” estático. O agente já conhece os valores enviados, então a confirmação é específica, não genérica. Essa mensagem de acompanhamento é enviada no WhatsApp, no Telegram e no Messenger.

Isso vem ativado por padrão em cada formulário. Se você preferir que o agente fique em silêncio após um envio, desative Confirmar envios na aba Distribuir do formulário. A confirmação também fica em silêncio automaticamente quando alguém da sua equipe assume a conversa: você não vai receber uma mensagem de IA atropelando uma resposta humana.

Formulários publicados não vivem só dentro das conversas que o agente inicia. Abra o card Recurso de campanha na aba Distribuir do formulário e gere um link compartilhável — um link padrão de conversa direta do WhatsApp (mais um QR code para baixar) que você pode colocar em um e-mail, na bio do Instagram, em um botão “Agendar uma demo” ou imprimir em um panfleto.

Quando alguém clica no link, o WhatsApp abre uma conversa com o seu número e uma mensagem já preenchida; o usuário toca em enviar e o formulário exato abre como a primeira resposta, sem adivinhação nem saudação da IA no meio. Quem clicou em “Agendar demo” recebe o formulário de agendamento na hora. Depois, o agente cuida do resto da conversa normalmente.

Cada link tem um contador de aberturas para você ver quantas pessoas abriram o formulário por ele, e você pode revogar um link a qualquer momento. Se o texto de um link for editado ou removido antes do envio, ou se o link for revogado, a mensagem simplesmente segue para uma conversa de IA normal — nada quebra.

Limites por plano

PlanoFlows publicadosIdiomas por flowGeração por IA
Trial11
Starter11
PlusIlimitadoIlimitado
EnterpriseIlimitadoIlimitado

Todos os 23 tipos de componentes estão disponíveis em todos os planos que oferecem suporte ao Agent Flows — não há restrição por componente conforme o plano.

Last updated on