Цены на API для групп | Документация для разработчиков
Цены на API для групп
Обновлено: 22 октября 2025 г
Ценообразование за сообщение в API групп
API групп использует модель ценообразования Cloud API, основанную на оплате за сообщение, для определения того, является ли данное сообщение платным. Однако с вас взимается плата каждый раз, когда платное сообщение доставляется кому-либо из группы.
Например, если вы отправляете шаблонное маркетинговое сообщение (подлежащее оплате) группе из 5 пользователей WhatsApp, и оно доставляется всем 5 пользователям, с вас будет взиматься плата за 5 доставленных сообщений по действующему тарифу на маркетинговые сообщения для телефонного кода страны каждого получателя.
Если сообщение было доставлено только 4 из 5 пользователей, с вас будет взиматься плата только за 4 доставленных сообщения.
Как работают окна обслуживания клиентов с использованием Groups API
При использовании API групп работа служб поддержки клиентов отличается.
Когда любой пользователь WhatsApp в группе отправляет вам сообщение, окно службы поддержки между вами и всей группой (или обновляется, если такое окно уже существует). Это позволяет вам бесплатно отправлять шаблонные сообщения для служебного и маркетингового характера, а также сообщения в свободной форме.
Это отличается от обмена сообщениями один на один, когда при отправке вам сообщения пользователем WhatsApp открывается окно службы поддержки
Всё остальное, что касается окон обслуживания клиентов, остаётся без изменений.
Информация о ценах в веб-хуке «Статус сообщения»
Информация о ценах на сообщения, отправленные с использованием Groups API, содержится в вебхуках статуса сообщений .
Как обрабатываются веб-хуки статуса прочитанных и доставленных
Для того чтобы сообщение считалось
прочитанным , оно должно быть как минимум доставлено .В некоторых сценариях, например, когда пользователь присутствует в чате в момент получения сообщения, сообщение помечается как
доставленное и прочитанное практически одновременно. В этом и других подобных сценариях доставки не отправляется обратно. Это происходит потому, что подразумевается, что сообщение было доставлено, поскольку оно было прочитано.Как отображаются данные о ценах в веб-перехватчике «Статус сообщения»
Не все веб-хуки статуса сообщений содержат информацию о ценах.
С введением ценообразования за сообщение , данные о ценах могут присутствовать в
отправленного , доставленного или прочитанного сообщения . Если за сообщение взимается плата , можно ожидать, что как минимум один веб-хук ( отправленного или прочитанного ) будет содержать информацию о ценах.Веб-перехватчик статуса отправленного сообщения
Веб-перехватчик статуса доставленного/прочитанного сообщения
Параметры
| Заполнитель | Описание |
|---|---|
<CONVERSATION_ID> |
Версия 24.0 и выше:
диалога будет полностью опущен.
Версия 23.0 и ниже:
|
<CONVERSATION_CATEGORY> |
Ничего не изменится. |
<CONVERSATION_EXPIRATION_TIMESTAMP> |
Ничего не изменится. |
<IS_BILLABLE?> |
|
<PRICING_TYPE> |
Новая недвижимость. Стоимость может быть следующей:
regular - означает, что сообщение платное.free_group_customer_service - указывает, что сообщение является бесплатным, поскольку оно представляло собой либо служебное сообщение-шаблон, либо сообщение, не являющееся шаблоном, отправленное в рамках окна обслуживания клиентов . |
<PRICING_CATEGORY> |
Значения не меняются, но теперь их можно интерпретировать следующим образом:
group_marketing - указывает на шаблонное маркетинговое сообщение.group_utility - указывает на шаблонное сообщение утилиты.group_service - указывает на сообщение, не являющееся шаблоном. |
Идентификация сообщений, подлежащих оплате
Для платных сообщений
параметр pricing.type установлен на regular. pricing.category указывает тариф ( group_marketing или group_utility ).Идентификация свободных сообщений
Для бесплатных сообщений
параметр pricing.type установлен на free_group_customer_service . pricing.category указывает причину бесплатности:group_utility - сообщение было отправлено в открытом окне групповой службы поддержки клиентов.group_service - все сообщения, не являющиеся шаблонами, бесплатны.
Аналитика сообщений для API групп
В
«Аналитика» отображается количество и тип сообщений, отправленных и доставленных телефонными номерами, связанными с конкретным WABA-номером. Для получения данных о метриках разговоров см. раздел «Аналитика разговоров».Для получения аналитических данных по сообщениям, отправленным с помощью Groups API, можно использовать следующую конечную точку:
/<WHATSAPP_BUSINESS_ACCOUNT_ID> ?fields=analytics.<FILTER_PARAMETER> .<FILTER_PARAMETER> ...
Фильтрация параметров для аналитики сообщений
Полный список параметров фильтра аналитики сообщений см. в справочнике по аналитике сообщений .
Изменения в параметрах фильтрации для API групп
| Имя | Описание |
|---|---|
тип_продуктатип: Массив |
Необязательный.
Типы сообщений (уведомления и/или сообщения службы поддержки клиентов), для которых вы хотите получать уведомления.
Предоставьте массив и включите в него:
101 для групповых уведомлений102 для групповых сообщений службы поддержки клиентов.103 для входящих групповых сообщений
Если указанные выше значения не будут предоставлены, вызов API вернет аналитические данные по всем сообщениям одновременно.
Входящие данные по типу товара нельзя запрашивать одновременно с данными по другим типам товаров, иначе вы увидите ошибку, подобную приведенной ниже:
|
Значение ответа
В случае успешного ответа на запрос данных сообщений API групп к API аналитики будет возвращен объект, похожий на следующий:
Примечание: Фильтр по коду страны не поддерживается для сообщений, отправляемых группами.
Аналитика ценообразования для API групп
Поле
pricing_analytics позволяет получить подробную информацию о ценах на любые сообщения, доставленные в указанном диапазоне дат.ПОЛУЧАТЬ /<WABA_ID> ?fields=pricing_analytics .start(<START> ) .конец(<END> ) .granularity(<GRANULARITY> ) .phone_numbers(<PHONE_NUMBERS> ) .country_codes(<COUNTRY_CODES> ) .metric_types(<METRIC_TYPES> ) .pricing_types(<PRICING_TYPES> ) .pricing_categories(<PRICING_CATEGORIES> ) .размеры(<DIMENSIONS> )
Параметры фильтрации для анализа ценообразования
Полный список параметров фильтра аналитики сообщений см. в справочнике по аналитике сообщений .
Изменения в параметрах фильтрации для API групп
| Имя | Описание |
|---|---|
<PRICING_CATEGORIES>Массив строк |
Необязательный.
Массив ценовых категорий. Если вы отправите пустой массив, мы вернем результаты для всех ценовых категорий.
Возможные значения:
ГРУППОВОЙ МАРКЕТИНГ : За групповые сообщения взимается плата по маркетинговому тарифу.GROUP_SERVICE : Групповые сообщения, за которые не была произведена оплата. Включает все сообщения, не являющиеся шаблонами, и служебные сообщения, отправленные в рамках окна обслуживания клиентов.GROUP_UTILITY : За групповые сообщения взимается плата по тарифу коммунальных услуг. |
<PRICING_TYPES>Массив строк |
Необязательный.
Массив типов ценообразования. Если вы отправите пустой массив, мы вернем результаты для всех типов ценообразования.
Возможные значения:
FREE_GROUP_CUSTOMER_SERVICE : Бесплатные групповые сообщения. Это сообщения, не являющиеся шаблонами, и служебные сообщения, отправляемые в рамках окон группового обслуживания клиентов.ОБЫЧНЫЕ : Платные сообщения. Включают все шаблонные сообщения для аутентификации и маркетинга, а также любые служебные шаблонные сообщения, отправленные вне окна обслуживания клиентов. |
Прайс-листы
Групповые служебные сообщения не подлежат включению в тарифные планы по объему.
Тарифы на обмен сообщениями через Groups API такие же, как и тарифы на обмен сообщениями один на один.
Комментарии отсутствуют
Комментарии отсутствуют