FireZAP Central de Ajuda
SiteEntrar
Central de Ajuda
Novo por aqui?

Passo 4 — Conectar o número no FireZAP

Colar as credenciais, configurar o webhook na Meta e testar. É a etapa final da API Oficial.

Colar as credenciais

  1. 1No FireZAP, abra Conexão → Adicionar canal → API Oficial (WhatsApp Cloud).
  2. 2Dê um nome ao canal — é o rótulo que aparece na conversa (ex.: Comercial, Suporte).
  3. 3Cole Phone Number ID, WhatsApp Business Account ID, Access Token e App Secret.
  4. 4Se quiser, escreva a mensagem padrão de atendimento — ela é enviada quando o canal não tem agente de IA.
  5. 5Clique em Salvar e ativar canal. As credenciais são validadas direto na Meta na hora de salvar.
Seus segredos não voltam para a tela

Access Token e App Secret são guardados de forma protegida e nunca são devolvidos ao navegador. Ao editar o canal depois, deixe esses campos em branco para manter o que já está salvo.

Configurar o webhook na Meta

O webhook é o caminho de volta: é por ele que a Meta avisa o FireZAP de cada mensagem recebida. Sem isso, você envia mas não recebe.

  1. 1No FireZAP, no card da conexão, clique em Configurar e abra a seção Webhook no painel Meta. Copie a Callback URL e o Verify Token.
  2. 2Na Meta, abra o seu app → WhatsApp → Configuração.
  3. 3Na caixa Webhook, clique em Editar.
  4. 4Cole a Callback URL e o Verify Token e clique em Verificar e salvar.
  5. 5Na lista de campos, clique em Gerenciar e assine o campo messages.
Teste de verdade

Peça para alguém mandar uma mensagem para o número, de outro celular. Ela deve aparecer em Atendimento em segundos. Depois responda pelo FireZAP e confirme que chegou no celular da pessoa.

Envia mas não recebe: as três causas

  • Webhook sobrescrito no número. Além do webhook do app, a Meta permite um webhook configurado NO NÚMERO — e ele vence o do app, sem aparecer em lugar nenhum e sem gerar log. É o que acontece quando o número já passou por outra plataforma. Só some removendo o override pela API da Meta; mexer no app não resolve. Chame o suporte que fazemos isso junto com você.
  • App em modo de desenvolvimento. Deixe o app Ativo.
  • App Secret errado ou de outro app. O FireZAP confere a assinatura de cada mensagem recebida com ele; se não bate, a mensagem é recusada em silêncio. Sintoma clássico: campanha aparecendo 100% como "não entregue".

Depois de conectar

  • Escolha o Agente de IA que atende nesse número, no próprio card da conexão.
  • Se quiser triagem por setor, ligue o menu de recepção em Configurar.
  • Para disparar campanha, cadastre e aprove templates no WhatsApp Manager.
  • Antes da primeira campanha, veja Quanto a Meta cobra pela API Oficial — o que é pago e o que é de graça.
Ficou alguma dúvida neste passo?
Falar com o suporte