Mensagens do WhatsApp não aparecem nas Linhas Abertas do Bitrix24? Siga este checklist

Ontem gastamos uma manhã inteira com uma mensagem que "não chegou". Ela tinha chegado — estava lá no widget do CRM, na cara. Só nunca apareceu nas Linhas Abertas do Bitrix24, e o motivo acabou sendo constrangedoramente simples quando o encontramos.

Aquela manhã virou um runbook interno. Esta é a versão pública: sete causas reais para mensagens de WhatsApp sumidas das Linhas Abertas, na ordem em que hoje as verificamos em produção.

Entenda isto primeiro: são dois pipelines, não um

A maioria das integrações WhatsApp–Bitrix24 exibe as mensagens em dois lugares separados:

1. O widget do CRM — o painel de chat do WhatsApp embutido no lead ou no negócio. Ele lê do armazenamento de mensagens da própria integração.
2. Linhas Abertas (Canais Abertos) — a fila de mensagens nativa do Bitrix24, com distribuição entre operadores, criação automática de contatos no CRM e a caixa de entrada da Central de contatos. As mensagens só chegam aqui se a integração as encaminhar por um conector vinculado a uma Linha Aberta específica.

Esses pipelines falham de forma independente. Uma mensagem pode ser entregue, armazenada e visível no widget enquanto as Linhas Abertas ficam completamente mudas — que é exatamente o estado confuso que depuramos. Se o widget mostra as mensagens, o lado WhatsApp da sua integração funciona; o problema mora na etapa de encaminhamento ou no vínculo com a Linha Aberta. Isso estreita a busca enormemente.

O checklist

1. Existe mesmo uma Linha Aberta vinculada a este número?

A causa nº 1 — e a que nos pegou. Toda conexão de WhatsApp precisa de um vínculo explícito com uma Linha Aberta e, dependendo de como a conexão foi criada, esse vínculo pode nunca ter sido definido. A parte cruel: algumas interfaces de administração exibem um nome de linha placeholder mesmo quando nada está vinculado, então pode parecer conectado estando conectado a nada.

Confira dos dois lados: as configurações da integração devem nomear a Linha Aberta exata que cada número alimenta, e essa linha deve existir em Bitrix24 → Central de contatos. Se você não consegue dizer qual linha um número alimenta, assuma que é nenhuma.

2. O conector está ativo naquela linha?

Uma linha pode existir e estar vinculada, mas o conector nela pode estar inativo — normalmente depois de a linha ter sido editada ou recriada. Na Central de contatos, abra a linha e confirme que o conector de WhatsApp está listado e habilitado. Integrações bem feitas reativam isso automaticamente na primeira mensagem; instalações mais antigas podem exigir o toque manual.

3. A Linha Aberta foi excluída ou arquivada?

Linhas são "organizadas" por administradores bem-intencionados com mais frequência do que você imagina. Se a linha vinculada não existe mais, as mensagens ficam sem lugar para cair — e a maioria das integrações falha em silêncio, em vez de quebrar com estardalhaço. Vincule de novo a uma linha viva.

4. A assinatura do webhook continua intacta?

Tudo entre o WhatsApp e o Bitrix24 começa com um webhook. Em números da API oficial (Cloud API), o seu app precisa estar inscrito na WhatsApp Business Account — uma inscrição que pode se perder após trocas de token, eventos de revisão do app ou migrações de número. Sintoma: nada chega em lugar nenhum, widget incluído. Se os dois pipelines estão mortos, olhe aqui primeiro, não no Bitrix.

5. O remetente está bloqueado? (A silenciosa)

Um contato bloqueado na WhatsApp Business API não produz webhook nenhum. Sem erro, sem linha de log — silêncio. Se exatamente um cliente "parou de escrever" enquanto todos os outros fluem normalmente, confira a lista de bloqueio antes de mexer em qualquer configuração. Alguém do seu time pode tê-lo bloqueado meses atrás. Escrevemos à parte sobre as regras de bloqueio e suas surpresas.

6. A mensagem está parada em uma fila sem responsável?

Às vezes a mensagem está nas Linhas Abertas — só não onde você está olhando. Se a fila da linha não tem operadores disponíveis, ou roteia para um departamento que ninguém confere, as conversas se acumulam sem atribuição. Abra as configurações de fila da linha e verifique quem deveria receber os novos diálogos, e se operadores "offline" são pulados.

7. Em números da API: você está dentro das regras de mensageria?

Números na API oficial vêm com as regras de conversa da Meta: clientes sempre podem escrever para você, mas se as suas mensagens de saída de repente falham — ou uma automação parou de responder — confira a janela de atendimento de 24 horas e o status de qualidade dos seus templates no WhatsApp Manager. Problemas de entrada raramente vêm daqui; problemas de saída quase sempre.

Como foi, de verdade, a nossa sessão de depuração

Para os curiosos — a sequência real do nosso incidente: mensagem visível no widget (então a entrada funcionava), nada nas Linhas Abertas (então o encaminhamento não), interface mostrando um nome de linha que se revelou um placeholder (a causa nº 1 disfarçada) e um desvio pela lista de bloqueio (causa nº 5) provocado por um teste de bloqueio anterior no mesmo número. Tempo total: uma manhã. Com este checklist: uns dez minutos.

Duas mudanças saíram disso. O WASync agora cria e vincula uma Linha Aberta automaticamente no momento em que um número da WhatsApp Business API se conecta — então a causa nº 1 não pode mais acontecer em conexões novas — e o conector se autoativa na primeira mensagem, cobrindo a causa nº 2.

A triagem de cinco minutos

---

Configurando do zero em vez de depurando? Nosso guia passo a passo de como conectar o WhatsApp ao Bitrix24 cobre tanto a rota via QR quanto a da API oficial — com o vínculo da Linha Aberta já resolvido para você.