Resolver erros comuns ao conectar o WhatsApp
Diagnostique e resolva os erros mais frequentes ao conectar ou usar o WhatsApp no Omnifox.
Conectar o WhatsApp ao Omnifox costuma ser rápido. Quando falha, quase sempre é um de poucos problemas conhecidos. Este guia ajuda a identificá-los.
Antes de começar
- Verifique se sua conta Meta Business está verificada.
- Tenha acesso de administrador ao Omnifox e à sua conta do WhatsApp Business.
A janela da Meta não abre
O assistente abre um pop-up. Se nada aparecer:
- Desative o bloqueador de pop-ups para omnifox.io e clique no botão de novo.
- Se você estiver no navegador interno de outro app (Instagram, Facebook), abra o Omnifox no Chrome ou Safari.
- Se a janela abrir em branco, feche, volte a Configurações → Canais e reinicie o processo.
O assistente não deixa continuar
Se ao clicar no cartão aparecer «Poné un nombre para el canal antes de conectar», é porque falta o nome do canal no campo de cima. Preencha e clique de novo.
Erro: o número já está em uso
- Um número só pode estar conectado a uma plataforma por vez.
- Se ele já está em outra plataforma Cloud API, use Migrar número existente em vez de criar um novo, ou libere-o lá antes.
- Na Coexistence o número não pode estar migrado para outra plataforma Cloud API: é um dos requisitos que o assistente pede para confirmar.
As mensagens não chegam à caixa de entrada
- Confira em Canais se o canal aparece como Conectado e não em Erro.
- Não procure um botão de reconectar nem de atualizar o webhook: eles não existem, e o webhook é registrado automaticamente ao conectar. Se o canal ficou em erro, rode o assistente de novo com o mesmo número (veja o artigo de reconexão).
- Envie uma mensagem de teste de outro telefone.
Erro: code 190 — todos os envios falham
- O token de acesso do canal expirou.
- Solução: conecte o canal de novo com o mesmo número para renovar o token.
- Verifique também se o usuário do sistema na Meta não foi excluído.
Erro: #131009 ao enviar modelos
- Normalmente são títulos ou IDs duplicados em botões ou listas.
- A Meta exige que cada botão, linha de lista ou SKU tenha um identificador único.
- Edite o modelo, deixe os identificadores únicos e reenvie.
O modelo foi rejeitado
- Revise a categoria (Marketing / Utilidade / Autenticação).
- Adicione valores de exemplo a todas as variáveis.
- Corrija ortografia, links suspeitos ou texto incompleto.
O histórico da Coexistence não chegou
O histórico é compartilhado durante o pareamento, quando a Meta pergunta. Se você não aceitou naquele momento, a única forma de trazê-lo é parear o número de novo.
Dica final: quando tudo para de funcionar de repente sem você ter mudado nada, suspeite do token expirado (code 190). Reconectar o canal resolve a maioria das falhas em massa de envio.
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.