Usar webhooks para el seguimiento de las conversaciones en tiempo real

En esta guía, se explica cómo usar los webhooks para estimar el total de conversaciones por tipo en un período de facturación determinado.

Antes de comenzar con este documento, asegúrate de consultar y entender el artículo Webhooks para la plataforma de WhatsApp Business.

Seguimiento de conversaciones con identificadores

Cada vez que una empresa envía un mensaje a un usuario por fuera de una sesión de conversación existente, se genera un identificador de conversación. Cuando se entrega el primer mensaje de la empresa con este identificador de conversación, se genera un cargo y se inicia una sesión de conversación de 24 horas.

Puede haber demoras entre el envío y la entrega de un mensaje. Esto puede deberse a que el teléfono del usuario está apagado cuando se entrega el mensaje. Si hay una demora, la conversación se procesa como tal: cuando el mensaje se envía, se abre provisoriamente una sesión de conversación. Se asocia un identificador de conversación correspondiente a esa conversación.

Una vez que el mensaje se entrega, la hora de inicio de la sesión de conversación se actualiza.

La siguiente ilustración muestra un ejemplo extremo. La mayoría de los mensajes se entregan segundos después de enviarse.

Los mensajes enviados que no se entregan en 30 días se pierden. No se cobrarán cargos de conversación por los identificadores de conversación que se generen de mensajes enviados pero no entregados.

Estimar la cantidad de conversaciones por período de facturación

Para estimar los costos, necesitas dos datos: el código de país del destinatario y la categoría de la conversación. Tanto el código de país como la categoría de conversación se utilizan para determinar la tarifa. Puedes descargar aquí las hojas de las tarifas individuales.

Para conocer la categoría de una conversación específica, revisa el objeto de precios en las notificaciones de tus webhooks. En Notificaciones de precios y estado, encontrarás más información sobre cómo identificar el tipo de conversación en los webhooks.

Una vez que sepas la categoría de conversación y el código de país del destinatario, cuenta la cantidad de identificadores de conversación únicos que la notificación del webhook haya confirmado como entregadas para calcular la cantidad de conversaciones realizadas durante el período de facturación. Los identificadores de conversación que solo tengan asociada una notificación del webhook con el estado del mensaje "enviado" no se cobrarán.

Es posible que, en algunos casos, solo recibas una notificación de estado “entregado” o “leído”. Ambos confirman que el mensaje se entregó. Lo más habitual es que recibas confirmaciones tanto de entrega como de lectura.

Si una conversación se extiende durante dos períodos de facturación, no se generarán cargos adicionales por el segundo mes. Para determinar el período de facturación del cargo de una conversación, se toma en cuenta la marca de tiempo del primer mensaje de la empresa entregado en la conversación según la zona horaria de la WABA.

Los webhooks son la mejor herramienta para realizar un seguimiento de las métricas de las conversaciones en tiempo real.

Para obtener más información, consulta Información sobre la facturación de tu cuenta de WhatsApp Business.