Skip to main content

Mensagens espelhadas

Durante a Coexistência, quando você envia uma mensagem pelo aplicativo WhatsApp Business ou por um dispositivo companheiro, a Positus espelha essa mensagem para sua integração via webhook. Essa funcionalidade garante que seu sistema permaneça sincronizado com todas as mensagens do negócio, independentemente do canal de envio.

O que você recebe

Cada mensagem enviada pelo negócio é entregue ao seu webhook no mesmo formato de uma mensagem recebida na Positus — o envelope { "contacts": [...], "messages": [...] }. Você recebe um webhook por mensagem espelhada; o seu handler de webhook existente já trata essas mensagens sem alteração.
Como identificar um eco: o campo from traz o número do próprio negócio (seu número WhatsApp Business). Numa mensagem recebida de um cliente, from seria o número do cliente. Use esse padrão para distinguir mensagens espelhadas de mensagens recebidas normalmente.
Este é o mesmo formato descrito em Webhook. O seu handler existente processa mensagens espelhadas sem alteração — basta observar o campo from para detectar que se trata de uma mensagem enviada pelo negócio.

Campos da mensagem

Tipos suportados

Mensagens de mídia (image, video, document, audio, sticker) são entregues no mesmo formato de uma mensagem de mídia recebida normalmente. Consulte a página de Webhook para o detalhamento dos objetos de mídia.
Não há um campo ou flag explícito marcando uma mensagem como “eco” ou “espelhada”. A única forma de identificar que uma mensagem foi enviada pelo negócio (e não recebida de um cliente) é verificar se from é igual ao seu número WhatsApp Business. Implemente essa verificação no seu handler para processar o eco de forma diferente, se necessário.

Próximos passos