Отслеживание переписок с помощью Webhooks в режиме реального времени

В этой статье рассматривается использование Webhooks для оценки общего числа переписок за определенный период биллинга.

Прежде чем начать, ознакомьтесь с руководством по Webhooks для платформы WhatsApp Business.

Отслеживание переписок с помощью идентификаторов

Идентификатор переписки создается, когда компания отправляет пользователю сообщение вне существующего сеанса переписки. При доставке первого сообщения от компании с этим идентификатором переписки взимается плата и создается 24-часовой сеанс переписки.

С момента отправки сообщения до момента его доставки может пройти некоторое время. Это может быть связано с тем, что в момент доставки профиль пользователя может быть отключен. В случае подобной задержки происходит следующее: при отправке сообщения происходит предварительное открытие сеанса переписки. С этой перепиской связывается соответствующий идентификатор переписки. После доставки сообщения время начала сеанса переписки обновляется.

На изображении ниже проиллюстрирован пример крайнего проявления этого эффекта. Большинство сообщений доставляются в течение нескольких секунд с момента отправки.

Сообщения, не доставленные в течение 30 дней, удаляются. Плата за идентификаторы переписок, созданные для отправленных, но не доставленных сообщений, не взимается.

Оценка числа переписок за период биллинга

Чтобы оценить стоимость, вам понадобятся следующие два параметра: код страны получателя и категория переписки. От обоих этих параметров зависит ваш тариф. Индивидуальные таблицы тарифов можно загрузить здесь.

Чтобы уточнить категорию переписки, воспользуйтесь объектом цены в уведомлениях Webhooks. Дополнительные сведения о том, как определить тип переписки в Webhooks, можно найти в разделе, посвященном уведомлениям о статусе и расценках.

Определив категорию переписки и код страны получателя, подсчитайте количество переписок за период биллинга по числу уникальных идентификаторов переписки, для которых доставка сообщения подтверждается уведомлением Webhooks. Плата за идентификаторы переписок, с которыми связано уведомление Webhooks о сообщении со статусом "Отправлено" (но не "Доставлено"), не взимается.

В некоторых случаях приходит только одно уведомление о статусе ("Прочитано" или "Доставлено"). В обоих случаях сообщение считается доставленным. Чаще всего приходит отдельное уведомление как о доставке, так и о прочтении.

Если переписка охватывает два платежных периода, плата за него в следующем месяце не взимается. Платежный период для переписки определяется по метке времени первого сообщения компании, доставленного в рамках этой переписки (в часовом поясе аккаунта WhatsApp Business).

Webhooks — оптимальный инструмент для отслеживания метрик переписок в режиме реального времени.

Подробнее см. в статье О биллинге для аккаунта WhatsApp Business.