Perguntas frequentes e solução de problemas da Coexistência
Este guia aborda erros importantes e como solucioná-los durante o uso da Coexistência
Erro de tipo de mensagem não compatível na Coexistência
Códigos de erro: 131051, 131060 e outros
Se você usa o WhatsApp Coexistence para conectar seu número do WhatsApp Business App ao Chakra Chat, às vezes pode aparecer na sua caixa de entrada uma mensagem como:
"Mensagem não compatível. Veja no WhatsApp Business App."
Esse comportamento é esperado em algumas situações e é determinado pela Meta, não é um bug do Chakra. Este guia explica por que isso acontece, o que significam os diferentes códigos de erro e o que você pode fazer.
O que esse erro significa
Um espaço reservado de "mensagem não compatível" aparece no Chakra quando uma mensagem enviada ou recebida no seu número da Coexistência não pode ser encaminhada ao Chakra pelo sistema de webhook da Meta. A mensagem continua existindo — ela apenas não fica visível no Chakra, porque a Meta nunca enviou ao Chakra os dados necessários para exibi-la.
Essa é uma limitação da Meta/WhatsApp Cloud API, e não algo que o Chakra possa contornar. A mensagem original continua sempre visível no próprio WhatsApp Business App.
Códigos de erro comuns que você pode ver
Código de erro | Significado | Geralmente aparece quando |
|---|---|---|
131051 | Tipo de mensagem não compatível | O contato enviou um tipo de mensagem que não é compatível com a Cloud API (por exemplo, reações, enquetes, mensagens temporárias/de visualização única e mensagens excluídas) |
131060 | Mensagem recebida durante a sincronização / indisponível | Uma limitação específica da Coexistência — geralmente relacionada a mensagens recebidas pela primeira vez, dispositivos complementares não compatíveis ou um número que ainda está sincronizando |
Outros (nenhum código numérico exibido) | Espaço reservado genérico de "mensagem não compatível" | Mensagens editadas por um contato ou mensagens enviadas por um dispositivo vinculado não compatível |
Os dois códigos apontam para o mesmo problema: a Meta não enviou um evento de webhook com o conteúdo da mensagem, então o Chakra não tem nada para exibir.
Por que isso acontece
Há cinco causas comuns. Compare o que você está vendo com os cenários abaixo.
1. O contato usou um dispositivo complementar (vinculado) não compatível
A Meta oferece suporte à maioria dos dispositivos complementares/vinculados do WhatsApp na Coexistência, mas o WhatsApp para Windows e o WhatsApp para WearOS não são compatíveis. Se o seu contato enviar uma mensagem por um desses dispositivos, isso não acionará um webhook e o Chakra não poderá exibi-la. (Adocumentação da Meta sobre dispositivos vinculados aborda isso em detalhes.)
2. Sincronização de mensagens após um período de inatividade
Se um contato enviar uma mensagem para o seu número da Coexistência após um período de inatividade, talvez a conexão precise de um momento para atualizar. As mensagens recebidas durante esse período de atualização podem aparecer como não compatíveis até que a sincronização seja concluída.
3. Tipo de mensagem realmente não compatível
Alguns tipos de mensagem do WhatsApp simplesmente não são compatíveis com a Cloud API, independentemente da Coexistência. Isso inclui reações, enquetes, mensagens de visualização única e mensagens excluídas/revogadas. Elas sempre aparecerão como não compatíveis — não há solução, pois a Cloud API não processa esse conteúdo.
4. Mensagem recebida pela primeira vez, especialmente por um anúncio Click-to-WhatsApp
Quando alguém envia uma mensagem para o seu número pela primeira vez — principalmente logo após tocar em um anúncio Click-to-WhatsApp — essa primeira mensagem talvez não chegue pelo webhook. Esse cenário está relacionado ao erro 131060 e é mencionado explicitamente na documentação da Meta como um comportamento esperado que geralmente se resolve em segundos.
5. O contato edita uma mensagem enviada anteriormente
Se um contato editar uma mensagem que já enviou a você, a versão editada também poderá aparecer como não compatível no Chakra, mesmo que a mensagem original tenha sido recebida normalmente.
O que você pode fazer
Causa | O que fazer |
|---|---|
Dispositivo complementar não compatível | Veja a mensagem completa diretamente no WhatsApp Business App principal do seu celular. |
Sincronização após inatividade | Aguarde a conclusão da sincronização — as mensagens seguintes devem chegar normalmente. Não é necessário fazer nada. |
Tipo de mensagem não compatível | Veja a mensagem no WhatsApp Business App. Essa é uma limitação permanente da Meta, sem solução alternativa. |
Mensagem recebida pela primeira vez por um anúncio | Não é necessário fazer nada — isso geralmente se resolve em segundos, quando as mensagens seguintes chegam normalmente. |
Mensagem editada | Veja a mensagem editada no WhatsApp Business App. |
Se você estiver vendo mensagens não compatíveis com frequência, inclusive mensagens de texto comuns de contatos que usam dispositivos compatíveis, isso não é esperado — veja a observação sobre solução de problemas abaixo.
Quando isso pode indicar um problema real de conexão
Espaços reservados de mensagens não compatíveis ocasionais são normais na Coexistência. Mas, se a maioria ou todas as mensagens recebidas aparecerem como não compatíveis, verifique o seguinte:
- Confirme se a mensagem está visível no WhatsApp Business App do seu dispositivo principal.
- Acesse o WhatsApp Business Manager e confirme se o Chakra ainda aparece como parceiro conectado ativo para sua Conta do WhatsApp Business.
- Se o Chakra não aparecer na lista, provavelmente sua conexão com o parceiro foi removida — você precisará reconectar seu Canal da Coexistência pelo fluxo de cadastro incorporado.
Uma causa comum para a perda da conexão com o parceiro: o WhatsApp Business App não foi aberto no dispositivo principal por 14+ dias, o que pode desconectar dispositivos vinculados e interromper a conexão.
Perguntas frequentes sobre mensagens não compatíveis
Vou perder o conteúdo da mensagem permanentemente? Não. A mensagem nunca é perdida — ela apenas não é espelhada no Chakra. Ela permanece totalmente visível no WhatsApp Business App o tempo todo.
Isso afeta a entrega da mensagem ao meu contato? Não. Isso afeta apenas a capacidade do Chakra de exibir a mensagem. A entrega no próprio WhatsApp não é afetada.
Isso é um bug do Chakra? Não. Essa é uma limitação imposta pela Cloud API da Meta para números conectados à Coexistência. Ela se aplica a todas as plataformas que oferecem Coexistência, não apenas ao Chakra.
Posso evitar isso sincronizando o histórico/contatos? A sincronização de contatos e do histórico de mensagens durante a integração é separada desse problema e não impede que espaços reservados de mensagens não compatíveis apareçam nos cinco cenários acima.
Detalhes dos códigos de erro
Erro 131060 – Mensagem indisponível no momento
O que é afetado: Uma mensagem recebida no Chakra · Tentar novamente ajuda? Não – geralmente é resolvido em segundos · Onde corrigir: app WhatsApp Business
O que você vê: Uma mensagem recebida aparece como indisponível no Chakra, com o erro 131060.
Diagnóstico simples: Uma primeira mensagem de um novo contato – geralmente de um anúncio Click-to-WhatsApp – não foi encaminhada ao Chakra pela Meta. A Meta documenta que isso é esperado para números do app WhatsApp Business.
Solução 1 – Abordagem sugerida
1. Leia a mensagem no app WhatsApp Business.
2. Responda normalmente – as mensagens seguintes desse contato chegarão ao Chakra como de costume.
Solução 2 – Verificada pelo Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte do Chakra.
Erro 131051 – Tipo de mensagem não compatível
O que é afetado: Uma mensagem no Chakra · Tentar novamente ajuda? Não · Onde corrigir: app WhatsApp Business
O que você vê: O Chakra exibe “Mensagem não compatível. Veja no app WhatsApp Business”, com o erro 131051.
Diagnóstico simples: O contato enviou algo que a API do WhatsApp não consegue exibir, como uma reação, enquete, mensagem de visualização única ou mensagem apagada.
Solução 1 – Abordagem sugerida
1. Veja a mensagem no app WhatsApp Business.
2. Se precisar do conteúdo no Chakra, peça ao contato que o envie como texto normal.
Solução 2 – Verificada pelo Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte do Chakra.