Em uma única linha: A referência cruzada para entender a linguagem da Meta, diagnosticar erros comuns e se inspirar com implementações reais e rentáveis.
📖 Glossário Funcional ↔ Técnico
Termo Técnico (Meta/Atom) | Nome Funcional (Negócio) | O que é |
Flow JSON | Definição do flow | O arquivo que a Meta usa para desenhar a tela. |
Data Exchange | Flow conectado | O modo que consulta ou envia dados ao vivo para uma API. |
nfm_reply | Resposta do flow | Pacote de dados que chega quando o cliente envia tudo. |
Screen loader | Requisição ao abrir | Chamada que traz dados assim que você entra na tela. |
Trigger handler | Requisição ao interagir | Chamada que dispara quando o cliente escolhe algo (cascata). |
Throttled / Blocked | Restringido / Bloqueado | A Meta limitou o flow por falta de saúde do endpoint do cliente. |
❓ Perguntas Frequentes e Solução de Problemas
Posso usar condicionais (If / Switch)? Sim (desde v4.0). Você pode aninhar ramificações para solicitar dados distintos (Ex. Se escolher Empresa, solicitar RFC; se escolher Pessoa, solicitar CURP).
Por que dá erro ao importar um JSON? Quase sempre porque o arquivo não cumpre o esquema rigoroso da Meta (ex. usar nome completo em vez de nome).
Posso importar um flow de várias telas por JSON? Hoje tem limitações fortes. É melhor montá-lo direto no Builder visual.
Funciona no WhatsApp Web? Não. Só funciona em telefones (Android 6.0+ ou iOS 12+). Na Web o usuário verá uma mensagem de erro.
Erro INVALID_REFERENCE: O caminho de um dado não existe; escolha um caminho real ou remova o vínculo.
🏆 Biblioteca de Casos de Uso (Padrões)
Classifique seu cliente em segundos usando estas quatro famílias:
Família | Precisa de API? | Valor para o Cliente |
Pesquisa / Lead | Não (Estático) | Go-live rápido. Captação de leads sem intervenção humana. |
Consulta de status | Sim (1 conexão) | Autoatendimento 24/7 sem ocupar um assessor. |
Consulta / Agenda | Sim (Leitura + Escrita) | Elimina remarcações. Agenda confirmada ao vivo. |
Cotação / Carrinho | Sim (Catálogo + Cálculo) | Fechamento de compra em chat. Gestão de catálogos e pagamentos (OTP). |
Fale a linguagem dos especialistas! 🚀
Com este glossário e biblioteca de casos, você tem o critério necessário para diagnosticar erros ao instante e propor soluções de alto impacto comercial que transformarão a operação de seus clientes. ✅