Информацию об актуальных тарифах см. в разделе Цены на WhatsApp.
2026-11-10
Обновления документации
- Добавлено руководство по YCloud Developer Kit, включающее инструкции по установке для Codex, Claude Code и WorkBuddy, примеры промптов, поддерживаемые возможности и рекомендации по локальному тестированию и авторизованным операциям с рабочим API.
- Расширены разделы Отправка сообщений WhatsApp и Обработка ошибок, включая параметры шаблонов, цитируемые ответы, фильтры подавления, а также различия между сбоями отправки и доставки.
- Расширены рекомендации по приемнику Webhook: добавлены проверка подписи необработанного тела запроса, надежное хранение событий, обработка дубликатов и тестирование приемника.
- Описан контракт запросов и ответов для эндпоинта Flow, включая проверки работоспособности, обмен данными экранов, уведомления об ошибках и обработку завершения.
- Обновлен справочник Meta Business Agent в части инструментов-коннекторов, настройки учетных данных, журналов выполнения, параметров, бюджетов и реплик диалога. См. разделы Настройка агента и Работа агента.
2026-11-03
Обновления документации
- Добавлен пособытийный справочник по Webhook со схемами полезной нагрузки, примерами и описаниями полей для событий сообщений, шаблонов, аккаунтов, номеров телефонов, Business App, Agent, звонков, групп, Flow, платежей и контактов.
- Описаны события создания эхо-сообщений, статуса эхо-сообщений и передачи управления для агентов Public REST API. См. раздел Примеры Webhook для агента.
2026-10-21
Обновления документации
- Уточнено, что
limited_time_offerприменяется только к компонентам шаблона сtype: LIMITED_TIME_OFFER. Его полеtextявляется обязательным, только если этот объект включен. Для других типов компонентов этот объект не требуется. См. примеры создания шаблонов.
2026-09-18
Обновления документации
- Добавлены руководства по интеграции Meta Business Agent, охватывающие соответствие требованиям, подключение, настройку, тестирование, развертывание и эксплуатацию.
2026-09-17
Обновления документации
- Расширено руководство по Utility Direct Send, включая конвертацию существующих шаблонов с помощью
useDirectSend, срок доставки и наименование автоматически создаваемых шаблонов. - Документированы операции WhatsApp для заблокированных пользователей:
POST /v2/whatsapp/{businessPhoneNumber}/blockUsers,POST /v2/whatsapp/{businessPhoneNumber}/unblockUsersиGET /v2/whatsapp/{businessPhoneNumber}/blockedUsers. - Расширен справочник по коннекторам и инструментам Meta Business Agent: добавлены сведения о коннекторах HTTP и MCP, обнаружении и выполнении инструментов, учетных данных и журналах.
2026-09-16
Обновления документации
- Обновлено руководство по Business-Scoped User ID: добавлена обработка идентификаторов через API и Webhook.
2026-09-14
Обновления документации
- Документированы
phaseиprogressдля синхронизации истории WhatsApp Business App. См. примеры Webhook для истории. - Документирована отправка отчетов о кастомных событиях по имени пользователя. См. раздел Отслеживание кастомных событий.
2026-07-13
- Добавлен API запроса Automatic Creative Optimizations на уровне WABA:
GET /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations. - Добавлен API частичного обновления Automatic Creative Optimizations на уровне WABA:
PATCH /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations.
2026-07-07
Обновлено
- Обновлена документация по статусам WhatsApp Business Username: теперь используется
reservedдля запросов Business Username, зарезервированных Meta и, возможно, еще находящихся на рассмотрении. - Значение
pending_reviewпомечено как устаревшее для обратной совместимости. Для новых операций записи Business Username используетсяreserved.
Добавлено
- Добавлено значение
reservedв перечисление статусов WhatsApp Business Username. - Добавлен пример Webhook
whatsapp.phone_number.business_username_updated, гдеbusinessUsernameStatusимеет значениеreserved.
2026-06-10
Обновлено
- Отменено ранее задокументированное состояние WhatsApp Business Account
removed, добавленное 2026-05-25. - События удаления партнера теперь передаются в полезной нагрузке Webhook
whatsapp.business_account.deletedвместоwhatsapp.business_account.updated. removedReason,removedInitiatedByиremovedTimeсохранены как необязательные метаданные удаления в полезных нагрузках Webhook для удаленных аккаунтов WhatsApp Business Account.
Добавлено
- В
WhatsappBusinessAccountUpdateEventEnumдобавленоPARTNER_APP_UNINSTALLED.
2026-06-08
Добавлено
- Новое поле в объекте WhatsApp Phone Number:
updateEvent
- В полезные нагрузки Webhook
whatsapp.phone_number.quality_updatedдобавлено полеupdateEventдля идентификации события обновления аккаунта, вызвавшего изменение статуса номера телефона, напримерACCOUNT_OFFBOARDEDилиACCOUNT_RECONNECTED.
2026-06-01
Добавлено
- Новые API для запроса, обновления, удаления и получения предложений для WhatsApp Business Usernames.
- Новые поля в объекте WhatsApp Phone Number:
- businessUsername
- businessUsernameStatus
- requestedBusinessUsername
- businessUsernameUpdatedAt
- Новый тип события Webhook: whatsapp.phone_number.business_username_updated.
2026-05-25
- Поддержка обновлений WhatsApp Business Account Partner Removed в Webhook
whatsapp.business_account.updated.- В полезные нагрузки Webhook для WhatsApp Business Account добавлены
removed,removedReason,removedInitiatedByиremovedTime. - Добавлено
PARTNER_REMOVEDвupdateEventWhatsApp Business Account. - Задокументированы известные причины Partner Removed:
ACCOUNT_DISCONNECTED,BUSINESS_DOWNGRADE,CHANGE_NUMBER,COMPANION_INACTIVITY,PRIMARY_INACTIVITYиUSER_RE_REGISTERED. - Задокументированы известные инициаторы Partner Removed:
USERиSYSTEM.
- В полезные нагрузки Webhook для WhatsApp Business Account добавлены
2026-05-19
Историческое объявление: эта запись не определяет текущую доступность Webhook для
групповых сообщений. Используйте актуальное руководство по группам
и опубликованный каталог Webhook для получения информации о поддерживаемых операциях и событиях.
- Поддержка WhatsApp Groups API.
- Поддержка операций со ссылками-приглашениями в группы WhatsApp, запросами на вступление, участниками и настройками.
- Добавлено
group_idв параметры компонентов шаблонов WhatsApp. - Добавлены типы событий Webhook для групп WhatsApp и полезные нагрузки
whatsappGroup. См. также События и полезные нагрузки Webhook и Примеры полезных нагрузок Webhook. - Добавлено
groupIdв полезные нагрузки входящих сообщений WhatsApp для групповых сообщений.
2025-05-08
В исходном журнале изменений эта дата указана как 2025-05-08. Ее позиция среди
записей за 2026 год сохранена без предположений о другой дате выпуска.
- Поддержка в WhatsApp inbound-unsupported-message
UNSUPPORTED_TYPE
2026-04-29
- Добавлено
ARCHIVEDвstatusшаблона WhatsApp. - Добавлены
ARCHIVEDиUNARCHIVEDвstatusUpdateEventшаблона WhatsApp. - Добавлены примеры Webhook для событий архивации и разархивации шаблонов WhatsApp. См. также Примеры Webhook для проверки шаблонов WhatsApp.
- В эндпоинт получения списка шаблонов (
GET /v2/whatsapp/templates) добавлен параметрfilter.statusдля фильтрации шаблонов по статусу, включаяARCHIVED.
2026-03-13
- Для поддержки внедрения BSUID от Meta, начинающегося 31 марта 2026 года, YCloud обновила несколько полезных нагрузок Webhook, связанных с обменом сообщениями и идентификацией пользователей. См. Обновления Webhook, связанные с BSUID
2026-03-04
- Поддержка в WhatsApp interactive-media-carousel-messages-with-quick-reply-buttons
2026-01-28
- Поддержка в WhatsApp: создание шаблона GIF/отправка шаблонного сообщения с GIF
2025-12-15
- Поддержка в WhatsApp шаблонов deep link
2025-12-03
- Поддержка в WhatsApp interactive-media-carousel-messages .
- contact-retrieve (
GET /v2/contact/contacts/{id})/contact-update (PATCH /v2/contact/contacts/{id})/contact-delete (DELETE /v2/contact/contacts/{id}) поддерживают номер телефона.
2025-11-06
- Добавлен новый тип события Webhook: whatsapp.user.preferences
2025-10-22
- Добавлено поле source в ответ эндпоинта List unsubscribers (
GET /v2/unsubscribers) - Добавлено поле source в ответ эндпоинта List all unsubscribers by customer (
GET /v2/unsubscribers/{customer}) - Добавлено поле source в ответ эндпоинта Retrieve an unsubscriber (
GET /v2/unsubscribers/{customer}/{channel}) - Добавлены новые типы событий Webhook: contact.unsubscribe.created, contact.unsubscribe.deleted . См. также:
2025-10-20
- Добавлено поле
whatsappBusinessManagerMessagingLimitв несколько эндпоинтов:- Эндпоинты List WABAs (
GET /v2/whatsapp/businessAccounts) и Retrieve a WABA (GET /v2/whatsapp/businessAccounts/{id}) - Эндпоинты List phone numbers (
GET /v2/whatsapp/phoneNumbers) и Retrieve a phone number (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}) - Полезная нагрузка Webhook whatsapp.phone_number.quality_updated
- Эндпоинты List WABAs (
2025-10-10
- В ответ эндпоинтов List WABAS (
GET /v2/whatsapp/businessAccounts) и Retrieve a WABA (GET /v2/whatsapp/businessAccounts/{id}) добавлены поляbusinessId,businessStatusиbusinessName
2025-09-24
- Добавлена поддержка эндпоинта Update a phone number’s display name
- В ответ эндпоинтов List phone numbers (
GET /v2/whatsapp/phoneNumbers) и Retrieve a phone number (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}) добавлено полеnewName. - В ответ эндпоинта Retrieve a phone number profile (
GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile) добавлены поляverifiedName,nameStatusиnewName - В полезную нагрузку Webhook whatsapp.phone_number.quality_updated добавлено поле
whatsappBusinessManagerMessagingLimit
2025-09-01
- Добавлена поддержка перенаправления эндпоинта WhatsApp Flow
- В API создания Flow (
POST /v2/whatsapp/flows) добавлен параметр endpointUri для указания URI эндпоинта Flow - В API обновления метаданных Flow (
PATCH /v2/whatsapp/flows/{flowId}/metadata) добавлен параметр endpointUri для настройки эндпоинта - В API сведений о Flow (
GET /v2/whatsapp/flows/{flowId}) добавлен возвращаемый ресурс endpointUrl
- В API создания Flow (
2025-08-28
- Добавлены новые Webhook для WhatsApp Smb
2025-08-20
- Добавлены новые API для звонков WhatsApp
- Инициировать исходящий звонок WhatsApp (
POST /v2/whatsapp/calls/connect) - Предварительно принять входящий звонок WhatsApp (
POST /v2/whatsapp/calls/preAccept) - Принять входящий звонок WhatsApp (
POST /v2/whatsapp/calls/accept) - Завершить звонок WhatsApp (
POST /v2/whatsapp/calls/terminate) - Отклонить входящий звонок WhatsApp (
POST /v2/whatsapp/calls/reject)
- Инициировать исходящий звонок WhatsApp (
- Добавлены API настройки параметров звонков
- Получить параметры звонков для бизнес-номера телефона (
GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings) - Настроить параметры звонков для бизнес-номера телефона (
POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings)
- Получить параметры звонков для бизнес-номера телефона (
- Добавлены новые Webhook для звонков WhatsApp
- Руководство по использованию WhatsApp Calling: whatsapp-calling-examples
2025-08-04
- Добавлена поддержка веб-страницы предварительного просмотра WhatsApp Flow (
GET /v2/whatsapp/flows/{flowId}/preview)
2025-07-24
- В метод создания шаблона (
POST /v2/whatsapp/templates) добавлено новое поле массиваsupported_appsдля указания имен пакетов нескольких приложений и хешей ключей подписи (до 5 приложений) в одном OTP-шаблоне (One-tap / Zero-tap).- Существующие поля
package_nameиsignature_hashобъявлены устаревшими в пользу новой структуры массиваsupported_apps
- Существующие поля
2025-07-10
- Добавлена поддержка метода получения списка атрибутов контактов (
GET /v2/contact/contacts/attributes) для запроса всех определенных атрибутов контактов. - Добавлены новые типы событий Webhook:
contact.created,contact.deletedиcontact.attributes_changed. См. также: - В следующие API эндпоинтов Webhook добавлено новое свойство
eventProperties:- Создание эндпоинта Webhook (
POST /v2/webhookEndpoints) - Обновление эндпоинта Webhook (
PATCH /v2/webhookEndpoints/{id}) - Получение списка эндпоинтов Webhook (
GET /v2/webhookEndpoints) - Получение эндпоинта Webhook (
GET /v2/webhookEndpoints/{id})
- Создание эндпоинта Webhook (
- В объект Contact добавлены новые поля для отслеживания информации об источнике контакта:
sourceType: перечисление типов источника контакта (WHATSAPP,GROWTH_TOOL,MANUALLY_ADDED,FILE_IMPORT,SHOPIFY,API,AD,POST,CALLING,SMB,UNKNOWN)sourceId: идентификатор источника для отслеживания источника создания контактаsourceUrl: URL источника, где был создан контакт
2025-07-01
- Добавлена поддержка WhatsApp Flow API (
POST /v2/whatsapp/flows) со следующими эндпоинтами:- Создание flow, получение списка flow, обновление метаданных flow, обновление структуры flow, удаление flow, получение flow, публикация flow, перевод flow в статус устаревшего
2024-10-10
- Поддержка сообщений WhatsApp с деталями заказа (Order Details) и со статусом заказа (Order Status).
- Добавлен новый тип событий Webhook:
whatsapp.payment.updated. См. также Примеры Webhook: обновление платежа WhatsApp.
2024-09-12
- Поддержка WhatsApp Flows. См. также шаблон Flow, шаблонное сообщение Flow, интерактивное сообщение Flow и входящее интерактивное сообщение с ответом Flow.
2024-08-22
- Добавлен API Custom Events . См. Отправка события (
POST /v2/event/events).
2024-08-02
- В объект Contact добавлено поле
lastMessageToPhoneNumber. См. Получение контакта (GET /v2/contact/contacts/{id}).
2024-07-18
- В эндпоинт Enqueue a WhatsApp Message (
POST /v2/whatsapp/messages) добавлен параметрfilterBlocked. Если задано значениеtrue, мы не будем отправлять сообщения пользователям из вашего черного списка.
2024-05-24
- С 1 июня 2024 года WhatsApp вводит новый тариф authentication-international в Индонезии и Индии. См. Authentication-International Rates .
- В объект WhatsApp Message добавлено свойство
pricingCategory. Если диалог аутентификации тарифицируется по тарифу authentication-international, в Webhook whatsapp.message.updated свойствоpricingCategoryбудет иметь значениеauthentication_international. - В объект WhatsApp Business Account добавлены свойства
authIntlRateEligibilityCountriesиprimaryBusinessLocation. Чтобы получать уведомления, подпишитесь на Webhook Authentication-International Rate Eligibility и Primary Business Location Update.
2024-04-03
- В объект WhatsApp Message добавлено свойство
regionCode.
2024-02-22
- Добавлен эндпоинт WhatsApp Mark message as read (
POST /v2/whatsapp/inboundMessages/{id}/markAsRead).
2024-01-30
- Добавлена поддержка сообщений WhatsApp Interactive Location Request message.
- Добавлена поддержка WhatsApp Inbound Request Welcome message.
- Время жизни (time-to-live) шаблонных сообщений аутентификации изменено с 24 часов на 30 дней, если оно не было задано явно (т. е.
messageSendTtlSecondsимеет значение-1).
2024-01-17
- В эндпоинт Start a verification (
POST /v2/verify/verifications) добавлен параметрexternalId.
2024-01-05
- Добавлен эндпоинт Register a phone number (
POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register). - В объект WhatsApp Phone Number добавлено свойство
id. - В объект WhatsApp Business Account добавлено свойство
paymentMethodAttached.
2023-12-21
- Добавлены эндпоинты Unsubscribers.
2023-12-13
- В эндпоинт Enqueue a WhatsApp message (
POST /v2/whatsapp/messages) добавлен параметр запросаfilterUnsubscribed. Если задано значениеtrue, сообщение не будет отправлено пользователям, отписавшимся от вашего аккаунта.
2023-11-24
- Добавлена поддержка шаблонов WhatsApp Catalog template и сообщений по ним Catalog template message.
- Добавлена поддержка шаблонов WhatsApp Multi-Product Message template и сообщений по ним MPM template message.
- Добавлена поддержка сообщений WhatsApp Interactive Catalog message.
- Добавлен эндпоинт Update commerce settings (
PATCH /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings) для включения или отключения корзины либо каталога товаров для определенного бизнес-номера телефона.
2023-11-02
- Добавлена поддержка шаблонов WhatsApp Zero-Tap Authentication template.
- Добавлено время жизни сообщений (time-to-live) для шаблонов аутентификации. По умолчанию составляет 600 секунд для вновь создаваемых шаблонов аутентификации.
2023-10-27
- Поддержка WhatsApp шаблона с ограниченным сроком действия и шаблонного сообщения с ограниченным сроком действия.
- Поддержка WhatsApp шаблона карусели и шаблонного сообщения карусели.
2023-10-18
- Поддержка интерактивных сообщений WhatsApp с кнопками CTA URL. См. также пример интерактивного сообщения CTA URL.
2023-10-12
- Добавлены типы событий Webhook whatsapp.business_account.deleted и whatsapp.phone_number.deleted.
- Поддержка WhatsApp шаблонов с купонами. Другие примеры см. также в разделах Шаблон купона и Шаблонное сообщение с купоном.
2023-09-07
- Добавлен Contacts API
/v2/contact/contacts. Используйте его для создания, обновления или удаления контактов.
2023-07-05
- В объект WhatsApp Message добавлено
conversation.type. При наличии возможными значениями являютсяFREE_ENTRY,FREE_TIERиREGULAR. - В объект WhatsApp Phone Number добавлено
isOfficialBusinessAccount.
2023-06-01
- В каждый ответ добавлены заголовки ограничения частоты запросов. См. также Ограничения частоты запросов.
2023-05-26
- Добавлен тип событий Webhook
whatsapp.template.quality_updated, позволяющий отслеживать обновления рейтинга качества шаблонов WhatsApp. См. События и полезные нагрузки Webhook. - В объект WhatsApp Template добавлено
qualityRating.
2023-05-16
- Добавлен API отправки сообщений WhatsApp
/v2/whatsapp/messages/sendDirectly. Информацию об обработке ошибок см. в разделе Ошибки WhatsApp. - Добавлен API удаления шаблонов WhatsApp
DELETE /v2/whatsapp/templates/{wabaId}/{name}/{language}. - В объект тела ответа
errorдобавлено полеwhatsappApiError. - В объект WhatsApp Phone Number добавлено
qualityUpdateEvent. - В объект WhatsApp Message добавлены
sendTime,deliverTimeиreadTime. - В
messagingLimitобъекта WhatsApp Phone Number добавлено новое значение перечисленияTIER_NOT_SET.
2023-03-24
- Плата за переписки WhatsApp взимается, когда первое сообщение этой переписки становится
delivered, а неsent. Таким образом, полеtotalPriceобъектов сообщений WhatsApp представляет собой лишь ориентировочную цену до момента доставки сообщения и становится окончательной ценой, когдаstatusпринимает значениеdeliveredилиread. Средства баланса, занятые сообщениями, которые отправлены, но еще не доставлены, будут недоступны до тех пор, пока эти сообщения не будут сброшены (отправленные сообщения, которые не были доставлены в течение 30 дней, сбрасываются). Значениеconversation.expireTimeтакже является ориентировочным временем истечения срока действия до тех пор, пока первое сообщение этой переписки не примет значениеdeliveredилиread. - Добавлен тип события Webhook
whatsapp.template.category_updatedдля отслеживания изменений категорий шаблонов WhatsApp. См. Полезные данные при обновлении категории шаблона WhatsApp. Дополнительные сведения о миграции категорий шаблонов см. также в разделе Первая миграция категорий шаблонов. - Добавлены новые типы источников переписок WhatsApp:
authentication,marketing,utilityиservice. Переход на новую модель ценообразования произойдет 1 июня 2023 года. См. также Новые тарифы на переписки, вступающие в силу 1 июня 2023 года. - Добавлена поддержка создания шаблонов аутентификации с кнопками одноразового пароля, которые станут доступны с 1 мая 2023 года и будут обязательными с 29 мая 2023 года.
2023-03-09
- Добавлен заголовок ответа
YCloud-Request-IDдля каждого запроса. См. Идентификатор запроса. - В объект ответа
errorдобавлено полеrequestId. См. Ошибки. - Добавлены новые категории шаблонов WhatsApp:
AUTHENTICATIONиUTILITY. См. также График внедрения изменений цен

