Resolver erros comuns ao conectar o WhatsApp

Diagnostique e resolva os erros mais frequentes ao conectar ou usar o WhatsApp no Omnifox.

Jun 22, 2026

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

  1. Confira em Canais se o canal aparece como Conectado e não em Erro.
  2. 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).
  3. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp