Crie um Fluxo de Dados Dinâmico no WhatsApp

Visão Geral

Um Fluxo de Dados Dinâmico é um Fluxo do WhatsApp cujas listas são preenchidas ao vivo pela sua própria API. Cada etapa é uma lista, e a escolha do cliente em uma etapa decide o que a próxima etapa mostra. O fluxo conduz o cliente por uma cadeia de seleções dependentes.

Exemplos típicos:

• Saúde - Médico, depois Data disponível, depois Horário disponível.
• E-commerce - Categoria, depois Produto.
• Serviços - Filial, depois Serviço, depois Membro da equipe.

Diferente do Construtor de Formulários, as opções não são inseridas manualmente. Quando o cliente avança para a próxima tela, o WhatsApp chama um endpoint seguro do ChatMaxima, que chama sua API e retorna a próxima lista. Nada é fixo no código, então o mesmo fluxo funciona para qualquer cadeia de etapas que você definir.

Como Funciona

1. O cliente abre o fluxo e vê a lista da primeira etapa.
2. Ele faz uma seleção.
3. O WhatsApp envia essa seleção ao endpoint criptografado do ChatMaxima.
4. O ChatMaxima chama sua API para a próxima etapa, passando as seleções anteriores.
5. A próxima lista aparece. Isso se repete até a tela final de resumo.

Pré-requisitos

Antes de começar, certifique-se de ter:

• Uma conta de WhatsApp conectada - um número da API Cloud do WhatsApp vinculado ao ChatMaxima.
• Uma API para cada etapa - um endpoint HTTPS que retorna uma lista JSON de opções.
• A chave de criptografia configurada - uma configuração única por conta de WhatsApp, descrita abaixo.

Nota: Os Fluxos de Dados Dinâmicos são orientados por endpoint, então o WhatsApp exige uma chave de criptografia. Você precisa concluir a configuração de criptografia antes de salvar um fluxo dinâmico.

Etapa 1: Inicie um Fluxo de Dados Dinâmico

1. Vá para Campanhas, depois Fluxos do WhatsApp e clique em Criar Fluxo.
2. Insira um Nome do Fluxo e escolha uma Categoria.
3. Defina o Tipo de Fluxo como Fluxo de Dados Dinâmico.

O construtor muda para a visualização de Etapas Dinâmicas.

Etapa 2: Configure a Chave de Criptografia

Um Fluxo de Dados Dinâmico chama um endpoint do ChatMaxima para cada tela, e o WhatsApp exige que esse canal seja criptografado.

1. No card Criptografia de Endpoint, clique em Configurar Chave de Criptografia.
2. O ChatMaxima gera um par de chaves RSA para a conta e envia a chave pública à Meta automaticamente.

Esta é uma ação única por conta de WhatsApp. Todo fluxo dinâmico nessa conta reutiliza a mesma chave.

Etapa 3: Adicione Etapas

Cada etapa é uma lista dependente. Clique em Adicionar Etapa e preencha o editor de etapas.

Campos da Etapa

Campo	Descrição
Título da Etapa	O cabeçalho da tela, por exemplo Select a Category
Chave da Etapa	Um identificador em minúsculas, por exemplo category, referenciado depois como {category}
Rótulo da Lista	O rótulo exibido acima da lista
Método HTTP	GET ou POST para a chamada da API
URL da API	O endpoint que retorna as opções desta etapa
Autenticação	Nenhuma, Token Bearer, Basic Auth ou Cabeçalho Personalizado

Passando Seleções Anteriores

Para fazer uma etapa posterior depender de uma anterior, coloque a chave da etapa anterior na URL da API dela como um marcador. O ChatMaxima o substitui pela seleção do cliente em tempo de execução.

https://api.example.com/products?category={category}

Neste exemplo, a URL da etapa product insere a category escolhida.

Etapa 4: Mapeie a Resposta da API

A seção Mapeamento de Resposta do editor de etapas diz ao ChatMaxima como ler o JSON da sua API.

Campo	Descrição
Caminho da Lista	Caminho até o array na resposta, por exemplo data. Deixe em branco se a resposta já for um array
Campo de ID	O campo usado como valor da opção, por exemplo id
Campo de Título	O campo exibido como texto principal da opção, por exemplo name
Campo de Descrição	Uma linha secundária opcional, por exemplo price

A notação de ponto é suportada para campos aninhados, como price.amount.

Etapa 5: Salve e Publique

1. Clique em Salvar Fluxo Dinâmico. O ChatMaxima gera as telas do Fluxo do WhatsApp a partir das suas etapas e as envia.
2. Abra o rascunho salvo e clique em Publicar.

A tela final é um resumo que recapitula cada seleção antes de o cliente confirmar.

Boas Práticas

• Use chaves de etapa claras - curtas, em minúsculas e significativas, pois aparecem nas URLs.
• Retorne listas pequenas - as listas do WhatsApp funcionam melhor com um conjunto focado de opções.
• Ordene as etapas do geral para o específico - por exemplo, Categoria antes de Produto.
• Teste cada API - confirme que cada endpoint retorna o JSON esperado antes de salvar.

Solução de Problemas

Salvar falha pedindo a chave de criptografia

1. Abra o card Criptografia de Endpoint.
2. Clique em Configurar Chave de Criptografia e aguarde a confirmação.
3. Salve o fluxo dinâmico novamente.

Uma etapa mostra uma lista vazia

1. Verifique se a URL da API está correta e acessível por HTTPS.
2. Verifique se o Caminho da Lista, o Campo de ID e o Campo de Título correspondem ao JSON da sua API.
3. Confirme que qualquer {placeholder} na URL corresponde à chave de uma etapa anterior.

Uma etapa não consegue alcançar a API

1. A API precisa ser um endpoint HTTPS público. Endereços internos ou privados são bloqueados por segurança.
2. Confirme se os detalhes de autenticação estão corretos.

Próximas Etapas

• Crie um Fluxo com o Construtor de Formulários →
• O Que São os Fluxos do WhatsApp →
• Transmissão pelo WhatsApp →