Quando uma empresa conecta o número do app WhatsApp Business a um CRM com a Coexistence, as respostas que a equipe envia pelo app podem não aparecer no CRM porque ele não está configurado para recebê-las. O WhatsApp não leva as respostas para o CRM sozinho: ele envia uma notificação para cada uma, e o CRM precisa se inscrever para recebê-la. As conversas e os contatos anteriores também podem ser copiados, mas só uma vez, em até 24 horas após a conexão, e apenas se a empresa permitir.
Principais conclusões
- O seu CRM ou a sua ferramenta de automação pode mostrar todas as respostas que a sua equipe envia pelo app WhatsApp Business, assim que se inscrever na cópia que o WhatsApp envia de cada uma.
- As conversas individuais dos últimos 180 dias podem ser transferidas uma única vez, em até 24 horas após a conexão, e só se a empresa concordar em compartilhá-las no app.
- Fotos, vídeos e documentos de conversas mais antigas chegam sem o arquivo, porque só vêm os arquivos de mídias enviadas nos 14 dias anteriores à conexão.
- Um erro de “mensagem indisponível” na primeira mensagem de um cliente é esperado, costuma sumir em segundos, e a mensagem continua legível no app.
- A 360Dialog, Official Meta Solution Partner, conecta o número do seu app à WhatsApp Business API, e o seu software e a sua equipe passam a trabalhar nas mesmas conversas.
Por que as respostas do app WhatsApp Business não aparecem no seu CRM?
As respostas do app ficam de fora do CRM quando o software nunca se inscreveu nas cópias que o WhatsApp envia delas, ou quando a empresa recusou o compartilhamento durante a conexão. Verificar essas duas configurações primeiro pode poupar uma nova conexão.
Com a Coexistence do WhatsApp, o app WhatsApp Business e a Cloud API, a conexão hospedada pela Meta para softwares empresariais, compartilham um número e mantêm as conversas sincronizadas.[1] O seu CRM fica sabendo de cada mensagem por um webhook, um endereço da web em que a Meta entrega uma notificação para cada novo evento. As mensagens dos clientes e as respostas do app chegam como dois tipos separados de notificação.[2] Um software que só escuta as mensagens dos clientes registra metade de cada conversa.
Comece pela inscrição: a Meta avisa que um parceiro sem as notificações extras da Coexistence “vai perder webhooks importantes”. As conversas e os contatos anteriores dependem do proprietário da empresa, que aprova o compartilhamento no app durante o cadastro.
O que é sincronizado entre o app e a API em um número com Coexistence?
Quatro tipos de dados são sincronizados em um número com Coexistence: as novas respostas do app, as mensagens que o seu software envia, as conversas individuais anteriores e os contatos. Saber como cada parte chega mostra onde procurar quando uma conversa parece incompleta.
| Dados | Como chegam ao seu software | O que pode impedir |
|---|---|---|
| Novas respostas que a sua equipe envia pelo app ou por um aparelho conectado compatível | Uma notificação para cada mensagem, no momento do envio | Software sem inscrição nas notificações de respostas |
| Mensagens que o seu software envia | Aparecem no app automaticamente | Nada a configurar |
| Conversas individuais anteriores | Lotes que o seu software solicita uma vez, logo após a conexão | A empresa recusa o compartilhamento, ou a solicitação chega tarde |
| Contatos com número de WhatsApp | Um lote por solicitação, depois uma notificação para cada alteração | A solicitação chega tarde ou é repetida |
| Conversas em grupo | Nunca são sincronizadas | Ficam só no app |
Como funcionam os ecos de mensagens?
Um eco de mensagem é a cópia que o WhatsApp faz de uma mensagem que a sua equipe enviou pelo app, e o seu software usa essa cópia para arquivar a mensagem na conversa certa. Com os ecos funcionando, o seu CRM mostra a mesma conversa que a sua equipe vê no app.
O WhatsApp gera um eco quando a empresa envia uma mensagem pelo app WhatsApp Business ou por um aparelho conectado compatível, edita uma mensagem enviada ou apaga uma.[3] Os ecos chegam no campo smb_message_echoes, separado do campo messages, que traz o que os clientes enviam.
Cada eco traz o número do cliente, um ID de mensagem, um registro de data e hora e um tipo. O seu software arquiva cada eco sob esse número, e o tipo indica o que fazer. Ecos de texto, imagem, vídeo e documento adicionam uma mensagem, enquanto ecos de edição e de revogação alteram ou removem uma mensagem que ele já mostra.
As respostas enviadas pelo app não abrem nem estendem a janela de atendimento ao cliente de 24 horas, o período após a última mensagem do cliente em que o seu software pode enviar respostas em formato livre.
Como funciona a sincronização do histórico de conversas e quais são os limites?
A sincronização do histórico de conversas copia até 180 dias de conversas individuais para o seu software uma única vez, em até 24 horas após a conexão, se a empresa concordar em compartilhá-las. Fazer a sincronização no primeiro dia coloca o contexto de cada cliente no seu CRM antes da próxima resposta dele.
O seu software inicia a sincronização com uma chamada à SMB App Data API da Meta: POST /<BUSINESS_PHONE_NUMBER_ID>/smb_app_data com sync_type definido como history. A resposta da Meta só confirma que a chamada foi aceita. Os webhooks history que vêm depois mostram se a empresa compartilhou alguma coisa.
Cinco limites definem o que a sua equipe vai ver no CRM.[4]
| Limite | Regra | Se não for cumprido |
|---|---|---|
| Prazo | Solicitar em até 24 horas após a conexão | Erro 2593108; a empresa precisa desconectar o número e conectá-lo de novo.[5] |
| Número de solicitações | Uma solicitação de histórico por conexão | Erro 2593107 em uma segunda chamada |
| Período | Mensagens enviadas ou recebidas nos 180 dias anteriores à conexão | As conversas mais antigas ficam no app |
| Fotos, vídeos e documentos | Só vêm os arquivos de mídias enviadas nos 14 dias anteriores à conexão | As mensagens de mídia mais antigas chegam como marcadores, sem o arquivo |
| Aprovação da empresa | O proprietário compartilha o histórico no app durante o cadastro | Um webhook com o erro 2593109 |
O histórico chega em até três fases, contadas a partir do dia da conexão: do dia 0 ao 1, do dia 1 ao 90 e do dia 90 ao 180. Uma fase pode vir em vários blocos que chegam fora de ordem, e uma fase sem mensagens não envia nenhum webhook. Um valor de progress igual a 100 marca o fim da sincronização. Armazene primeiro os dados de cada webhook e processe-os em segundo plano, porque um único webhook pode descrever milhares de mensagens.
Um histórico grande ou um processamento lento dos webhooks pode estender a sincronização a vários minutos. Ela termina com mais facilidade quando a empresa mantém o app aberto.
Como funciona a sincronização de contatos?
A sincronização de contatos copia do app para o seu software todos os contatos com número de WhatsApp e depois envia uma atualização cada vez que a sua equipe adiciona, edita ou remove um contato. O seu CRM então mostra os clientes com os nomes que a sua equipe já salvou.
O seu software solicita essa sincronização com a mesma chamada à SMB App Data API, com sync_type definido como smb_app_state_sync. As mesmas regras valem: uma solicitação, em até 24 horas após a conexão. O WhatsApp responde com um conjunto de webhooks smb_app_state_sync.[6] Cada entrada de contato traz os nomes salvos, o número de telefone, um registro de data e hora e uma ação: add para um contato novo ou editado, remove para um contato apagado.
As alterações posteriores não exigem uma nova solicitação, porque cada edição na agenda de contatos do app gera o próprio webhook.
O que significa “mensagem indisponível” (erro 131060)?
O erro 131060 significa que a mensagem de um cliente não pôde ser repassada ao seu software naquele momento, e a sua equipe ainda pode lê-la no app WhatsApp Business. Tratar o erro como comportamento esperado evita que a sua equipe procure uma falha em uma conexão que funciona.
O erro chega no campo messages como uma mensagem sem suporte, com o título em inglês “This message is currently unavailable.”[7] Em números com Coexistence, ele aparece em duas situações:
- Primeiro contato: Um cliente envia uma mensagem à empresa pela primeira vez, muitas vezes logo depois de selecionar um anúncio de clique para o WhatsApp. O erro costuma desaparecer em poucos segundos, e as mensagens seguintes chegam normalmente.
- Aparelho conectado sem suporte: O cliente envia ou recebe a mensagem em um app complementar que o WhatsApp não aceita na Coexistence, como o WhatsApp para Windows ou o WearOS.
Quando esse erro chegar, mostre à sua equipe um aviso para responder à mensagem no app WhatsApp Business.
Em quais campos de webhook o seu software precisa se inscrever?
Um software em um número com Coexistence precisa de quatro campos de webhook além dos que já usa: um para as respostas do app, um para as conversas anteriores, um para os contatos e um para as alterações de conta. Fazer a inscrição antes de solicitar o histórico ou os contatos permite que o seu software receba lotes que só podem ser solicitados uma vez.
Os campos ficam na Messaging account da empresa, que a Meta separou da conta do WhatsApp Business (WABA) para reunir os modelos de mensagem, a cobrança e as inscrições de webhook.[8] Você faz a inscrição em App Dashboard > WhatsApp > Configuração. Depois, o código que recebe os webhooks precisa processar os dados de cada campo.
| Campo | O que traz | O que o seu software faz com ele |
|---|---|---|
messages (já inscrito) | Mensagens que os clientes enviam, status de entrega e o erro 131060 | Mostra as mensagens recebidas e sinaliza as indisponíveis |
smb_message_echoes | Mensagens que a sua equipe envia, edita ou apaga no app | Adiciona ou atualiza a resposta na conversa do contato |
history | Conversas individuais anteriores, em fases e blocos | Armazena as mensagens anteriores na conversa de cada contato |
smb_app_state_sync | Contatos na primeira sincronização, depois cada alteração | Cria, atualiza ou remove o contato |
account_update | Alterações na WhatsApp account, que reúne o número, e na Messaging account | Avisa a sua equipe quando o status do número muda, como em uma desconexão |
Se o seu número funciona pela 360Dialog, os ecos vão para a URL de webhook definida para o número de telefone.[9] Aponte essa URL para o seu software. O nosso guia mostra como conectar um CRM ou uma ferramenta de automação.
Mais de 1.000 plataformas fazem a integração com o WhatsApp pela 360Dialog, Official Meta Solution Partner da WhatsApp Business API. As plataformas que fazem a integração dos próprios clientes conectam esses números com Coexistence pela nossa Partner Platform.
Como verificar se a sincronização está funcionando
Quatro verificações confirmam se a sincronização chega ao seu software. Feitas em ordem, elas mostram se uma falha vem da inscrição, do consentimento da empresa ou do prazo.
- Envie uma resposta de teste pelo app. Responda a um contato de teste pelo app WhatsApp Business. Se nenhum webhook
smb_message_echoeschegar à sua URL de webhook, verifique a inscrição da Messaging account e os quatro campos acima. - Leia o resultado do histórico. Um valor de
progressigual a 100 significa que a sincronização terminou, e o erro 2593109 significa que a empresa desativou o compartilhamento do histórico. - Verifique os prazos. O erro 2593107 significa que o histórico ou os contatos já foram solicitados, e o erro 2593108 significa que a solicitação chegou mais de 24 horas após a conexão.
- Teste a sua URL de webhook. Envie uma notificação de teste em App Dashboard > WhatsApp > Configuração. Mantenha o seu app no modo Ao vivo, porque a Meta retém alguns webhooks no modo de Desenvolvimento.
A sincronização do histórico e a de contatos só rodam uma segunda vez depois que a empresa desconecta o número e o conecta de novo. Guarde o request_id de cada chamada de sincronização e compartilhe esse ID com o suporte da Meta se uma sincronização der errado.
Quando as respostas, as conversas anteriores e os contatos chegam ao seu CRM, a sua equipe pode continuar respondendo no app enquanto colegas e automações trabalham com a mesma conversa completa.
Para manter o app e ver todas as conversas no seu CRM, o próximo passo é começar a usar a API e conectar o seu número com a 360Dialog.
Perguntas frequentes
Posso executar a sincronização do histórico de novo depois?
A sincronização do histórico roda uma vez por conexão: uma segunda solicitação retorna o erro 2593107, e uma solicitação feita mais de 24 horas após a conexão retorna o erro 2593108. Para sincronizar de novo, a empresa desconecta o número do seu software e passa pelo cadastro mais uma vez. Isso abre um novo período de 24 horas para uma solicitação de histórico e uma de contatos.
Por que faltam fotos nas conversas sincronizadas mais antigas?
As fotos e outras mídias faltam nas conversas sincronizadas mais antigas porque a sincronização do histórico só envia os arquivos de mídias enviadas nos 14 dias anteriores à conexão. As mensagens de mídia mais antigas ainda aparecem no histórico como marcadores, sem arquivo anexado. Já as mensagens de texto dos 180 dias completos chegam com o conteúdo.
As respostas enviadas por aparelhos conectados chegam ao meu CRM?
As respostas enviadas por um aparelho conectado compatível chegam ao seu CRM da mesma forma que as respostas enviadas pelo celular, como um eco de mensagem para cada mensagem. Todos os aparelhos conectados são desvinculados quando o número se conecta, e a sua equipe pode vincular de novo qualquer um deles, exceto o WhatsApp para Windows e o WearOS.
Mensagens editadas ou apagadas no app são atualizadas no meu CRM?
As mensagens editadas e apagadas no app são atualizadas no seu CRM quando o seu software processa os ecos de mensagens, porque o WhatsApp envia um eco cada vez que a empresa edita ou revoga uma mensagem enviada no app WhatsApp Business. O eco traz o tipo edit ou revoke, e o seu software o usa para alterar ou remover a cópia que já armazena.
Fontes
[1] Meta for Developers, “Onboard WhatsApp Business app users.” Updated June 26, 2026. Accessed October 26, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users
[2] Meta for Developers, “Webhooks overview.” Updated June 26, 2026. Accessed October 26, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview/
[3] Meta for Developers, “smb_message_echoes webhook reference.” Updated May 21, 2026. Accessed October 26, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/smb_message_echoes/
[4] Meta for Developers, “history webhook reference.” Updated May 21, 2026. Accessed October 26, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/history/
[5] Meta for Developers, “Error codes.” Updated June 18, 2026. Accessed October 26, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
[6] Meta for Developers, “smb_app_state_sync webhook reference.” Updated June 17, 2026. Accessed October 26, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/smb_app_state_sync/
[7] Meta for Developers, “Unsupported messages webhook reference.” Updated June 26, 2026. Accessed October 26, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/unsupported/
[8] Meta for Developers, “Updates to WhatsApp Business accounts.” Updated September 22, 2026. Accessed October 26, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/account-model-evolution
[9] 360Dialog Documentation, “Webhook reference.” Accessed October 26, 2026. https://docs.360dialog.com/docs/messaging/webhook/webhook-reference



