Conectar o WhatsApp no modo manual (Phone Number ID e token)

O modo manual é pensado para equipes técnicas ou operações que já têm um número de WhatsApp Cloud API configurado em outra plataforma e querem trazê-lo para a Omnifox sem passar pelo assistente da Meta (Embedded Signup). É uma configuração avançada, oculta por padrão.

Requisitos

• Sua organização precisa ter a opção de configuração manual habilitada (ativada por um superadmin da Omnifox para casos pontuais).
• Um número de WhatsApp Cloud API já existente, com Phone Number ID, Business Account ID e um token de acesso (idealmente permanente, de um System User do Meta Business Manager).

Passos

1. Em Canais → Conectar canal → WhatsApp, expanda o painel "Configuração manual (Avançado)".
2. Preencha Phone Number ID e Business Account ID exatamente como aparecem no Meta Business Manager.
3. Cole o Access Token (não precisa colar o App Secret — a Omnifox aplica automaticamente).
4. Copie o Verify Token gerado pela Omnifox e cole na configuração de Webhooks do seu app da Meta.
5. Copie também a Webhook URL exibida e configure no mesmo lugar na Meta.
6. Opcional: preencha o Catalog ID se for enviar produtos do catálogo do Meta Commerce pelo composer.
7. Salve — o canal fica ativo assim que a Meta confirmar a inscrição do webhook.

Exemplo

Uma equipe migrando de outro provedor de WhatsApp Cloud API cola o Phone Number ID e o token do System User já existentes, configura o webhook na Meta com os dados gerados pela Omnifox, e o número começa a receber mensagens no inbox sem passar pelo fluxo padrão de onboarding.

Dicas

• Use sempre um token de System User permanente, não um token de usuário temporário que expira.
• Guarde o Verify Token em um lugar seguro — você vai precisar dele toda vez que reconfigurar o webhook na Meta.

Solução de problemas

Se o canal for salvo mas nenhuma mensagem chegar, confirme na Meta que o webhook foi verificado com o Verify Token correto e que os campos inscritos incluem messages.