Pular para o conteúdo principal

Duvidas Gerais

Esta pagina prioriza duvidas recorrentes de implementacao e operacao. Para erros de execucao, veja tambem Erros Comuns.

Qual a diferenca entre Condition e Switch?​

Use Condition para decisao binaria (sim/nao). Use Switch para multiplos caminhos com fallback.

Preview no FlowBuilder

Este exemplo abre direto no FlowBuilder embedado. A visualizacao em Fluxo/JSON, simulacao e operacoes do flow ficam dentro do proprio editor.

Nao foi possivel carregar o preview embedado automaticamente.

Quando usar SubFlow?​

Use SubFlow quando a mesma logica aparece em varios flows. Isso reduz retrabalho e facilita manutencao.

Quando usar trigger Webhook e quando usar Schedule?​

  • Webhook Trigger: quando o evento vem de fora em tempo real.
  • Schedule Trigger: quando voce precisa executar em horarios definidos.

Meu flow funciona na simulacao e falha em producao. O que pode ser?​

Os motivos mais comuns sao:

  • Payload real diferente do payload de teste
  • Credencial invalida ou expirada
  • Variavel mapeada para caminho que nao existe no evento real

Revise logs e rode nova simulacao com payload capturado de producao.

Como evitar duplicacao de logica entre flows?​

Padronize blocos reutilizaveis em SubFlow e centralize regras comuns. Evite copiar e colar nodes quando a regra sera usada em mais de um processo.

Como escolher entre node nativo e HTTP Request generico?​

  • Node nativo: mais rapido para iniciar e menos margem de erro.
  • HTTP Request: melhor quando voce precisa de flexibilidade total da API.

Qual o melhor formato para nomear flows?​

Use um padrao simples:

  • canal-objetivo-versao
  • Exemplo: whatsapp-triagem-v1

Isso ajuda operacao e suporte a localizar fluxos rapidamente.

Como organizar variaveis para facilitar manutencao?​

  • Use nomes explicitos e consistentes
  • Evite abreviacoes ambiguas
  • Documente variaveis criticas no proprio flow

Comece pela pagina Variaveis e Contexto.

Como reduzir incidentes no dia a dia?​

  • Simule antes de publicar
  • Use fallback no Switch
  • Monitore erros frequentes por node
  • Evite dependencias sem timeout definido

Como saber se um flow esta pronto para producao?​

Checklist minimo:

  • Simulacao com payload real
  • Segredos configurados sem hardcode
  • Tratamento de erro para falha externa
  • Nomeacao e observabilidade adequadas

Como lidar com falha de provedor externo?​

Implemente:

  • timeout
  • retry com limite
  • caminho de fallback
  • log detalhado de resposta

Posso usar WhatsApp Flow sem conta verificada na Meta?​

Nao e recomendavel operar com esse risco. Para ambiente de producao, trate como obrigatorio ter business e operacao em estado valido, incluindo verificacoes exigidas e metodo de pagamento quando aplicavel.

Sem isso, o projeto tende a travar em onboarding, aprovacao ou envio.

Veja o checklist em Pre-requisitos e Permissoes.

Preciso ter pagamento registrado para usar WhatsApp API?​

Em muitos cenarios, sim. A operacao pode exigir metodo de pagamento valido para seguir sem bloqueio. Nao assuma que um ambiente que funcionou em teste vai escalar sem configuracao comercial correta.

Use Custos e Cobranca para alinhar premissas com cliente.

Quanto custa usar WhatsApp com a plataforma?​

O custo final normalmente combina:

  • cobranca de conversa/categoria da Meta
  • custos do parceiro tecnico/integracao
  • custo operacional interno

Como valores mudam por regiao e politica comercial, use fonte oficial da Meta para precos atualizados. Resumo completo: Custos e Cobranca.

Como migrar um numero do WhatsApp Business App para API?​

Essa migracao exige planejamento operacional. Voce deve alinhar ownership, janela de corte, validacao tecnica e comunicacao com equipes.

Tambem deixe explicito para o cliente que o numero passa a operar no contexto da API, com governanca de templates, qualidade e regras da Meta.

Checklist completo: Migracao de Numero para API.

Proximo passo​

Se sua dor e diagnostico, siga para Debug e Simulacao.