Guias passo a passo para construir experiências onde as opções e validações dependem de dados em tempo real hospedados nos sistemas do cliente.
📅 Caso 1: Agendamento com disponibilidade real
Este caso elimina o loop infinito de "esse horário não está mais disponível", alcançando uma economia de entre 6 a 8 mensagens por conversa.
Design: Placa (caixa de texto) → Oficina (opções em tempo real) → Data/Hora (datas em tempo real) → Confirmação.
Data Exchange: No painel Flow, ativa Data Exchange (em modo Rascunho) para gerar a chave de criptografia.
Requisição ao abrir: Em Dados → Ao abrir, configura a consulta GET. Mapeia a resposta para as opções do campo (id para valor, title para rótulo visível).
Cascatas (Opcional): Usa Dados → Ao interagir para que, ao escolher uma oficina, os horários sejam recalculados.
Escrita: Ao completar o flow (nfm_reply), dispara um POST com a placa, oficina, data e hora para criar o agendamento.
Nota: Este tipo de Flow só pode ser alterado enquanto estiver em rascunho.
🔍 Caso 2: Consulta de status
O caso conectado mais simples: uma única conexão, apenas leitura, sem escrita. Ideal como primeiro piloto.
Design: Identificador (caixa de texto) → Resultado (texto dinâmico).
Requisição ao abrir: Configura uma consulta GET na tela de resultado. Insere o identificador capturado (ex. .../status?folio={data.folio}).
Fallback: Define um valor de fallback obrigatório (ex. "Não encontramos esse folio").
🛒 Caso 3: Orçamento e carrinho
O fluxo mais completo. Convivem catálogo dinâmico, cascatas, cálculo e dados sensíveis.
Design: Categoria (lista) → Produto (cascata) → Resumo (cálculo em tempo real) → Pagamento (dados sensíveis) → Confirmação.
Dados sensíveis (Cartões/OTP): Marca-os estritamente como Não guardar ou usa máscara para não persistir em texto claro. Valida o pagamento contra o endpoint do cliente no momento.
Catálogos massivos: Se são centenas de opções, carrega-os sempre dinamicamente do sistema, nunca fixos no flow.
Solução de problemas comuns em Flows Conectados
Sintoma | Causa provável | O que fazer |
O flow é interrompido ao carregar | O sistema levou mais de 8 segundos. | Otimizar endpoint ou usar cache. |
Relatório mostra códigos (não texto) | Falta o mapeamento valor ↔ rótulo. | Configurar title visível. |
"Parou de funcionar" após republicar | Re-fazer upload do JSON reiniciou Data Exchange. | Reconfigurar loaders/triggers. |
Dados sensíveis salvos | Não foi marcado "Não guardar". | Reverter configuração do campo. |
🛠️ Catálogo de Modelos
Usa esta tabela para encontrar o ponto de partida ideal conforme a família a que pertence o requerimento.
Exemplo oficial do Meta | Família equivalente no Atom | Link para o guia |
Coletar intenção de compra (Collect purchase intent) | Pesquisa / Captação de leads | |
Obter um orçamento de seguro (Get an insurance quote) | Orçamento (Ex. Seguros) | |
Obter prospects para empréstimos pré-aprovados (Get leads for pre-approved loans) | Consulta / Captação financeira | |
Oferta personalizada (Personalized offer) | Orçamento / Carrinho de compras |
💡 Recurso extra: Se precisares explorar cenários adicionais ou tutoriais mais aprofundados, podes revisar o catálogo completo diretamente na documentação para desenvolvedores: Exemplos do Meta (Meta Examples).
Conecta sua IA com o mundo real! 🚀
Os flows conectados oferecem a melhor experiência de usuário e a maior economia econômica, transformando o WhatsApp em uma aplicação nativa capaz de ler e escrever no CRM do seu cliente. ✅