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.
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
- Vá em Configurações → Canais e clique em Conectar novo canal. Escolha WhatsApp.
- Escreva um nome para o canal (obrigatório).
- 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.
- Abra o acordeão «Configuración manual (Avanzado)». (Esse rótulo ainda aparece em espanhol.)
- Preencha Phone Number ID e Business Account ID exatamente como aparecem no Meta Business Manager.
- Cole o Access Token (não é preciso o App Secret: o Omnifox o aplica automaticamente).
- Copie o Verify Token que o Omnifox gerou e cole na configuração de Webhooks do seu app da Meta.
- Copie também a Webhook URL exibida e configure-a no mesmo lugar na Meta.
- Opcional: preencha o Catalog ID se for enviar produtos do catálogo do Meta Commerce pelo composer.
- 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
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.