Skip to main content

​
Sincronização de histórico

Ao ativar a Coexistência, você pode importar o histórico de mensagens do seu número WhatsApp Business para a Positus. A importação é assíncrona e as mensagens chegam ao seu webhook no mesmo formato das mensagens recebidas normalmente.

​
Como disparar a sincronização

Faça uma requisição POST ao endpoint abaixo. Nenhum corpo (body) é necessário.
Parâmetros:
  • {NUMBER_ID} — ID do número WhatsApp já ativado com Coexistência.
A importação pode ser disparada uma única vez por onboarding, dentro da janela de 24 horas após a ativação da Coexistência. O servidor apenas confirma o recebimento da solicitação; as mensagens são entregues depois, ao longo de vários webhooks.

​
O que você recebe

Cada mensagem do histórico é entregue ao seu webhook no mesmo formato de uma mensagem recebida na Positus — o envelope { "contacts": [...], "messages": [...] }. Você recebe um webhook por mensagem do histórico; o seu handler de webhook existente já trata essas mensagens sem alteração.
Este é o mesmo formato descrito em Webhook. A diferença é que mensagens de histórico trazem o campo adicional history_context, indicando o estado que a mensagem tinha no aplicativo. Os metadados internos de progresso da importação (fase, ordem do lote) não são repassados ao seu webhook.

​
Campos da mensagem

​
Valores de history_context.status

​
Janela de cobertura do histórico

A Meta disponibiliza o histórico em três fases, definindo quanto tempo para trás as mensagens são importadas: Mensagens com mais de 180 dias não são importadas. Você não precisa tratar essas fases: elas apenas determinam o alcance da importação — as mensagens chegam ao seu webhook uma a uma, conforme descrito acima.

​
Mídia em duas etapas

Mensagens de mídia mais antigas (com mais de ~14 dias) chegam em duas etapas:
  1. Primeiro, uma mensagem com type: "media_placeholder" — sem o conteúdo da mídia.
  2. Depois, um novo webhook entrega a mesma mensagem com o conteúdo real da mídia.
Aguarde a segunda etapa antes de considerar a mídia completa. O media_placeholder sinaliza que a mídia existe, mas ainda não foi entregue.

​
Histórico recusado pelo negócio

Se o compartilhamento de histórico estiver desligado no aplicativo WhatsApp Business, a Meta recusa a importação (erro 2593109 — “History sync is turned off by the business”).
Quando o histórico é recusado, a importação não prossegue e nenhuma mensagem é entregue. O usuário precisa habilitar o compartilhamento de histórico no aplicativo WhatsApp Business e refazer o onboarding.

​
Próximos passos