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

Para casos avançados, a Omnifox permite conectar um número de WhatsApp Cloud API colando manualmente suas credenciais em vez de usar o assistente da Meta.

Jul 11, 2026

O modo manual é 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 o Omnifox sem passar pelo assistente da Meta (Embedded Signup). É uma configuração avançada, recolhida por padrão.

Requisitos

  • Um número de WhatsApp Cloud API já existente, com seu Phone Number ID, Business Account ID e um token de acesso (de preferência permanente, de um System User do Meta Business Manager).
  • Permissões de administrador no seu espaço de trabalho do Omnifox.

Passos

  1. Vá em Configurações → Canais e clique em Conectar novo canal. Escolha WhatsApp.
  2. Escreva um nome para o canal (obrigatório).
  3. Escolha uma das duas opções de Cloud API — Migrar número existente ou Criar novo número Cloud API. O bloco manual fica abaixo do fluxo da Meta, não na tela dos três cartões.
  4. Abra o acordeão «Configuración manual (Avanzado)». (Esse rótulo ainda aparece em espanhol.)
  5. Preencha Phone Number ID e Business Account ID exatamente como aparecem no Meta Business Manager.
  6. Cole o Access Token (não é preciso o App Secret: o Omnifox o aplica automaticamente).
  7. Copie o Verify Token que o Omnifox gerou e cole na configuração de Webhooks do seu app da Meta.
  8. Copie também a Webhook URL exibida e configure-a no mesmo lugar na Meta.
  9. Opcional: preencha o Catalog ID se for enviar produtos do catálogo do Meta Commerce pelo composer.
  10. Salve. O canal fica ativo assim que a Meta confirma a assinatura do webhook.

Diferente do fluxo com Embedded Signup —onde o webhook se registra sozinho—, no modo manual o webhook é você quem configura na Meta. Esse é o passo mais esquecido.

Exemplo

Uma equipe que migra 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 pelo Omnifox, e o número começa a receber mensagens na caixa de entrada sem passar pelo fluxo de onboarding padrão.

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 lugar seguro: você precisa dele sempre que reconfigurar o webhook na Meta.

Solução de problemas

Se o canal salva mas não chegam mensagens, confirme na Meta que o webhook foi verificado com o Verify Token correto e que os campos de assinatura incluem messages.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp