Preços baseados em conversa mudaram. Consulte Preços para saber como nosso novo modelo de preços baseado em conversa funciona.
Além disso, a visibilidade de metric_types mudou desde 1º de julho de 2023. Consulte a tabela Análises de conversas para ver mais detalhes.
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.
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.