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

1. Событие подписки

YCloud отправляет обновления статуса и стоимости сообщений через событие whatsapp.message.updated. Оформить подписку можно в консоли YCloud в разделе Developers → Webhook . Следующий запрос создает подписку через API. Справочную информацию о конечной точке см. в разделе Create a webhook endpoint:
url указывает эндпоинт для приема вебхуков. Обработка событий и проверка подписи описаны в Webhook Integration Guide.

2. Поля тарификации

Информация о тарификации содержится в объекте whatsappMessage колбэка: Другие поля описаны в разделе Retrieve a message.

3. Правила тарификации

3.1 Окончательность цены

YCloud возвращает расчетные или окончательные цены в зависимости от статуса сообщения: Для маркетинговых сообщений Max Price предельная цена рассчитывается как maxBid шаблона, умноженная на коэффициент страны и множитель конкретного сообщения. Для итогового начисления платы используйте totalPrice со статусом delivered/read. Информацию о настройке см. в Max Price integration guide, а полный пример колбэка — в разделе delivered bidding example.

3.2 Платные и бесплатные типы тарификации

YCloud передает следующие три типа тарификации через pricingType: Начиная с 1 октября 2026 года лимит сервисных сообщений сбрасывается ежемесячно для каждого рабочего номера телефона. Неиспользованный лимит не переносится на следующий период, а индивидуальные и групповые сервисные сообщения расходуют общий лимит. После его исчерпания для индивидуальных сервисных сообщений применяется тарификация regular, если не действуют правила бесплатной точки входа. С этой же даты служебные шаблоны (utility) в пределах окна обслуживания клиентов больше не являются бесплатными только лишь из-за открытого окна и не покрываются сервисным лимитом. Для сообщений, подпадающих под условия бесплатной точки входа, по-прежнему применяется тарификация free_entry_point. Окно бесплатной точки входа открывается, когда пользователь отправляет сообщение компании через рекламу с переходом в WhatsApp или кнопку WhatsApp на Странице Facebook с помощью WhatsApp для Android или iOS, а компания отвечает в течение 24 часов. Окно длится 72 часа с момента ответа компании. Приложения WhatsApp для компьютеров и веб-версии под это правило точки входа не подпадают.

4. Примеры полезной нагрузки Webhook

Следующие фрагменты callback-уведомлений представляют сообщения формата «один на один». Идентификаторы и суммы списаний приведены в качестве примера и не являются фактическими тарифами. Полные полезные нагрузки см. в WhatsApp Message Updated Webhook Examples.

4.1 Маркетинговое сообщение: оплачиваемое

Для доставленного маркетингового сообщения применяется тарификация regular. Примерная итоговая сумма составляет 0.05 USD.

4.2 Сервисное сообщение: оплачиваемое

С 1 октября 2026 года, когда бизнес-номер телефона исчерпает ежемесячный лимит в 1000 бесплатных сервисных сообщений и сообщение не соответствует условиям тарификации бесплатных точек входа, YCloud передает pricingType=regular. Примерная итоговая сумма составляет 0.01 USD.

4.3 Сервисное сообщение: в пределах бесплатного лимита

С 1 октября 2026 года для сообщения, входящего в ежемесячный лимит бизнес-номера телефона на 1000 бесплатных сервисных сообщений, YCloud передает pricingType=free_customer_service и итоговую сумму 0.

4.4 Сообщение через бесплатную точку входа

Для сообщения, доставленного в течение 72-часового окна бесплатной точки входа, YCloud передает pricingType=free_entry_point, pricingCategory=referral_conversion и итоговую сумму 0.