Перейти к основному содержанию
Отслеживайте изменения API и обновления руководств и справочников. Записи с меткой Обновления документации используют дату обновления документации. Исторические записи о релизах до 13 июля 2026 года сохраняют свои исходные даты. Более поздние записи и актуальный справочник API имеют приоритет над историческими анонсами.
Информацию об актуальных тарифах см. в разделе Цены на 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

Обновления документации

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

Обновления документации

2026-09-14

Обновления документации

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 в updateEvent WhatsApp Business Account.
    • Задокументированы известные причины Partner Removed: ACCOUNT_DISCONNECTED, BUSINESS_DOWNGRADE, CHANGE_NUMBER, COMPANION_INACTIVITY, PRIMARY_INACTIVITY и USER_RE_REGISTERED.
    • Задокументированы известные инициаторы Partner Removed: USER и SYSTEM.

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 год сохранена без предположений о другой дате выпуска.

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

2026-01-28

2025-12-15

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

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

2025-08-28

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)
  • Добавлены 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})
  • В объект 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

2024-09-12

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

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

2023-10-18

2023-10-12

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

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