Como usar webhooks para rastrear conversas em tempo real

Este documento explica como usar webhooks para estimar o total de conversas em determinado período de cobrança.

Antes de iniciar este guia, leia Webhooks for the WhatsApp Business Platform.

Como rastrear conversas usando identificações

Uma identificação de conversa é gerada quando a empresa envia uma mensagem ao usuário fora de uma sessão de conversa existente. Quando uma mensagem de empresa com essa identificação é entregue, ocorre uma cobrança, dando início à sessão de conversa de 24 horas.

Pode haver atrasos entre o momento de envio e de entrega de uma mensagem. Por exemplo, isso pode ocorrer quando o telefone do usuário está desligado no momento da entrega da mensagem. Em caso de atraso, o processamento da conversa acontece da seguinte forma: primeiro, uma sessão de conversa é "pré-iniciada" quando a mensagem é enviada. Depois, uma identificação correspondente é associada à conversa.

Por fim, quando a mensagem é entregue, atualizamos a hora de início da sessão de conversa.

A ilustração abaixo mostra um exemplo extremo. A maior parte das mensagens é entregue segundos após o envio.

As mensagens não entregues em até 30 dias são descartadas. Se houver identificações de conversas relativas a mensagens enviadas, mas não entregues, não haverá cobrança.

Como estimar conversas por período de cobrança

Para estimar os custos, você precisa do código do país do destinatário e a categoria da conversa. Essas duas informações são usadas para determinar a tarifa. É possível baixar as tabelas de tarifas individuais aqui.

Para saber a categoria de uma conversa específica, consulte o objeto "pricing" (de preços) nas notificações de webhooks. Acesse Notificações de status e preço para mais detalhes sobre como identificar o tipo de conversa em webhooks.

Quando souber a categoria de conversa e o código do país do destinatário, calcule o total de conversas no período de cobrança. Para isso, conte o número de identificações de conversa únicas com entrega confirmada pela notificação de webhook. Não haverá cobrança relativa às identificações de conversa com apenas a notificação de webhook do status de mensagem "sent" (enviada).

Em alguns casos, você receberá apenas uma notificação do status "read" (lida) ou "delivered" (entregue). Ambas as opções confirmam a entrega da mensagem. A situação mais comum é o recebimento de confirmações de entrega e de leitura.

Se uma conversa iniciada em um período de cobrança se estender até o próximo período, não haverá cobranças adicionais no mês seguinte. O período de cobrança de uma conversa é determinado pelo registro de data e hora da primeira mensagem da empresa entregue na conversa, conforme o fuso horário da conta do WhatsApp Business (WABA, pelas iniciais em inglês).

Os webhooks são a melhor ferramenta para rastrear as métricas de conversa em tempo real.

Para saber mais, consulte Sobre a cobrança da sua conta do WhatsApp Business.