Перейти к основному содержанию
Этот архив сохраняет датированные записи из предыдущей документации API по 13 июля 2026 года. Историческое объявление описывает контракт на тот момент времени; более поздние записи и текущий справочник по API имеют преимущественную силу.
Актуальные тарифы см. в разделе Цены на WhatsApp.

​
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.

​
Добавлено

  • В перечисление статусов WhatsApp Business Username добавлено значение reserved.
  • Добавлен пример вебхука 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 Username.
  • Новые поля в объекте WhatsApp Phone Number:
    • businessUsername
    • businessUsernameStatus
    • requestedBusinessUsername
    • businessUsernameUpdatedAt
  • Новый тип события Webhook: whatsapp.phone_number.business_username_updated.

​
2026-05-25

  • Поддержка обновлений WhatsApp Business Account Partner Removed в вебхуках whatsapp.business_account.updated.
    • В полезные нагрузки Webhook WhatsApp Business Account добавлены removed, removedReason, removedInitiatedBy и removedTime.
    • В updateEvent WhatsApp Business Account добавлено PARTNER_REMOVED.
    • Задокументированы известные причины Partner Removed: ACCOUNT_DISCONNECTED, BUSINESS_DOWNGRADE, CHANGE_NUMBER, COMPANION_INACTIVITY, PRIMARY_INACTIVITY и USER_RE_REGISTERED.
    • Задокументированы известные инициаторы Partner Removed: USER и SYSTEM.

​
2026-05-19

Историческое объявление: эта запись не определяет текущую доступность вебхуков для групповых сообщений. Используйте актуальное руководство по группам и опубликованный каталог вебхуков для проверки поддерживаемых операций и событий.
  • Поддержка WhatsApp Groups API.
  • Поддержка операций с пригласительными ссылками в группы WhatsApp, запросами на вступление, участниками и настройками.
  • В параметры компонентов шаблонов WhatsApp добавлен group_id.
  • Добавлены типы событий Webhook для групп WhatsApp и полезные нагрузки whatsappGroup. См. также События и полезные нагрузки Webhook и Примеры полезных нагрузок Webhook.
  • В полезные нагрузки входящих сообщений WhatsApp для групповых сообщений добавлен groupId.

​
2025-05-08

В исходном журнале изменений эта дата указана как 2025-05-08. Ее расположение среди записей 2026 года сохранено без предположения иной даты релиза.

​
2026-04-29

  • В status шаблона WhatsApp добавлен ARCHIVED.
  • В statusUpdateEvent шаблона WhatsApp добавлены ARCHIVED и UNARCHIVED.
  • Добавлены примеры вебхуков для событий архивации и разархивации шаблонов WhatsApp. См. также Примеры вебхуков проверки шаблонов WhatsApp.
  • В эндпоинт получения списка шаблонов (GET /v2/whatsapp/templates) добавлен параметр filter.status для фильтрации шаблонов по статусу, включая ARCHIVED.

​
2026-03-13

  • В рамках поддержки внедрения Meta идентификатора BSUID, начиная с 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

  • В ответ эндпоинта получения списка отписавшихся (GET /v2/unsubscribers) добавлено поле source
  • В ответ эндпоинта получения списка всех отписавшихся по клиенту (GET /v2/unsubscribers/{customer}) добавлено поле source
  • В ответ эндпоинта получения информации об отписавшемся (GET /v2/unsubscribers/{customer}/{channel}) добавлено поле source
  • Добавлены новые типы событий 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: whatsapp-calling-examples

​
2025-08-04

  • Добавлена поддержка веб-страницы предварительного просмотра WhatsApp Flow (GET /v2/whatsapp/flows/{flowId}/preview)

​
2025-07-24

  • В эндпоинт Create a template (POST /v2/whatsapp/templates) добавлено новое поле массива supported_apps для определения нескольких имен пакетов приложений и хешей ключей подписи (до 5 приложений) в одном OTP-шаблоне (One-tap / Zero-tap).
    • Существующие поля package_name и signature_hash объявлены устаревшими в пользу новой структуры массива supported_apps

​
2025-07-10

  • Добавлена поддержка эндпоинта List contact attributes (GET /v2/contact/contacts/attributes) для запроса всех заданных атрибутов контактов.
  • Добавлены новые типы событий Webhook: contact.created, contact.deleted и contact.attributes_changed. См. также:
  • В следующие API эндпоинтов Webhook добавлено новое свойство eventProperties:
    • Create a webhook endpoint (POST /v2/webhookEndpoints)
    • Update a webhook endpoint (PATCH /v2/webhookEndpoints/{id})
    • List webhook endpoints (GET /v2/webhookEndpoints)
    • Retrieve a webhook endpoint (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) со следующими эндпоинтами:
    • Create a flow, List flows, Update flow metadata, Update flow structure, Delete a flow, Retrieve a flow, Publish a flow, Deprecate a flow

​
2024-10-10

​
2024-09-12

​
2024-08-22

  • Добавлен API Custom Events . См. Send an event (POST /v2/event/events).

​
2024-08-02

  • В объект Contact добавлено поле lastMessageToPhoneNumber. См. Retrieve a contact (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 Rates.
  • Добавлено свойство pricingCategory в объект WhatsApp Message. Если переписка категории «Аутентификация» тарифицируется по международному тарифу аутентификации, в вебхуках whatsapp.message.updated для свойства pricingCategory будет установлено значение authentication_international.
  • Добавлены свойства authIntlRateEligibilityCountries и primaryBusinessLocation в объект WhatsApp Business Account. Подпишитесь на вебхуки Authentication-International Rate Eligibility и Primary Business Location Update, чтобы получать уведомления.

​
2024-04-03

  • Добавлено свойство regionCode в объект WhatsApp Message.

​
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

  • Добавлен параметр externalId в эндпоинт Start a verification (POST /v2/verify/verifications).

​
2024-01-05

  • Добавлен эндпоинт Register a phone number (POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register).
  • Добавлено свойство id в объект WhatsApp Phone Number.
  • Добавлено свойство paymentMethodAttached в объект WhatsApp Business Account.

​
2023-12-21

​
2023-12-13

  • Добавлен параметр запроса filterUnsubscribed в эндпоинт Enqueue a WhatsApp message (POST /v2/whatsapp/messages). Если установлено значение 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

  • Добавлено свойство conversation.type в объект WhatsApp Message. Если оно присутствует, возможными значениями являются FREE_ENTRY, FREE_TIER и REGULAR.
  • Добавлено свойство isOfficialBusinessAccount в объект WhatsApp Phone Number.

​
2023-06-01

  • В каждый ответ добавлены заголовки ограничений частоты запросов. См. также Rate Limits.

​
2023-05-26

  • Добавлен тип события Webhook whatsapp.template.quality_updated, позволяющий отслеживать обновления WhatsApp Template Quality Rating. См. раздел Webhook Events & Payloads.
  • Добавлено свойство qualityRating в объект WhatsApp Template.

​
2023-05-16

  • Добавлен API для обмена сообщениями WhatsApp /v2/whatsapp/messages/sendDirectly. См. также WhatsApp Errors для обработки ошибок.
  • Добавлен API для удаления шаблонов WhatsApp DELETE /v2/whatsapp/templates/{wabaId}/{name}/{language}.
  • Добавлено свойство whatsappApiError в объект error тела ответа.
  • Добавлено свойство qualityUpdateEvent в объект WhatsApp Phone Number.
  • Добавлены свойства sendTime, deliverTime и readTime в объект WhatsApp Message.
  • Добавлено новое значение перечисления TIER_NOT_SET в messagingLimit объекта WhatsApp Phone Number.

​
2023-03-24

  • Плата за переписки WhatsApp списывается, когда первое сообщение этой переписки получает статус delivered, а не sent. Таким образом, поле totalPrice объектов сообщений WhatsApp до доставки сообщения является лишь ориентировочной стоимостью, и становится окончательной ценой, когда status принимает значение delivered или read. Баланс, заблокированный сообщениями, которые отправлены, но еще не доставлены, будет недоступен до тех пор, пока эти сообщения не будут сброшены (отправленные сообщения, которые не были доставлены в течение 30 дней, сбрасываются). Значение conversation.expireTime также является ориентировочным временем истечения срока действия до тех пор, пока первое сообщение этой переписки не перейдет в статус delivered или read.
  • Добавлен тип события Webhook whatsapp.template.category_updated, позволяющий отслеживать изменения категорий шаблонов WhatsApp. См. WhatsApp template category updated payload. Дополнительные сведения о миграции категорий шаблонов см. также в First template category migration.
  • Добавлены новые типы источников переписок WhatsApp: authentication, marketing, utility и service. Переход на новую модель тарификации состоится 1 июня 2023 года. См. также Новые тарифы на переписки, вступающие в силу 1 июня 2023 года.
  • Поддержка создания шаблонов аутентификации с кнопками одноразового пароля, которая станет доступна с 1 мая 2023 года и станет обязательной с 29 мая 2023 года.

​
2023-03-09