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.

