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

​
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, добавленное 25.05.2026.
  • События удаления партнера теперь передаются через полезные нагрузки Webhook whatsapp.business_account.deleted вместо whatsapp.business_account.updated.
  • Параметры removedReason, removedInitiatedBy и removedTime сохранены как необязательные метаданные удаления в полезных нагрузках Webhook для удаленных WhatsApp Business Account.

​
Добавлено

  • Добавлено поле PARTNER_APP_UNINSTALLED в WhatsappBusinessAccountUpdateEventEnum.

​
2026-06-08

​
Добавлено

  • Новое поле в объекте WhatsApp Phone Number:
    • updateEvent
  • Добавлено поле updateEvent в полезные нагрузки Webhook whatsapp.phone_number.quality_updated для идентификации события обновления аккаунта, вызвавшего изменение статуса номера телефона, например 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

  • Поддержка обновлений об удалении партнера (Partner Removed) WhatsApp Business Account в Webhook whatsapp.business_account.updated.
    • Добавлены поля removed, removedReason, removedInitiatedBy и removedTime в полезные нагрузки Webhook WhatsApp Business Account.
    • Добавлено значение 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.
  • Добавлен параметр filter.status в эндпоинт получения списка шаблонов (GET /v2/whatsapp/templates) для фильтрации шаблонов по статусу, включая 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

  • В ответ эндпоинта получения списка отписавшихся пользователей (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 в несколько эндпоинтов:
    • Эндпоинты получения списка WABA (GET /v2/whatsapp/businessAccounts) и получения информации о WABA (GET /v2/whatsapp/businessAccounts/{id})
    • Эндпоинты получения списка телефонных номеров (GET /v2/whatsapp/phoneNumbers) и получения информации о телефонном номере (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber})
    • Полезная нагрузка Webhook whatsapp.phone_number.quality_updated

​
2025-10-10

  • Добавлены businessId, businessStatus и businessName в ответ эндпоинта получения списка WABA (GET /v2/whatsapp/businessAccounts) и эндпоинта получения информации о WABA (GET /v2/whatsapp/businessAccounts/{id})

​
2025-09-24

  • Добавлена поддержка эндпоинта обновления отображаемого имени телефонного номера
  • Добавлено newName в ответ эндпоинта получения списка телефонных номеров (GET /v2/whatsapp/phoneNumbers) и эндпоинта получения информации о телефонном номере (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}).
  • Добавлены verifiedName, nameStatus и newName в ответ эндпоинта получения профиля телефонного номера (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile)
  • Добавлено поле whatsappBusinessManagerMessagingLimit в полезную нагрузку Webhook whatsapp.phone_number.quality_updated

​
2025-09-01

  • Добавлена поддержка функции перенаправления эндпоинта WhatsApp Flow
    • Добавлен параметр endpointUri в API создания Flow (POST /v2/whatsapp/flows) для указания URI эндпоинта Flow
    • Добавлен параметр endpointUri в API обновления метаданных Flow (PATCH /v2/whatsapp/flows/{flowId}/metadata) для настройки эндпоинта
    • Добавлен ресурс endpointUrl, возвращаемый в API получения сведений о Flow (GET /v2/whatsapp/flows/{flowId})

​
2025-08-28

​
2025-08-20

​
2025-08-04

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

​
2025-07-24

  • Добавлено новое поле-массив supported_apps в создание шаблона (POST /v2/whatsapp/templates) для определения имен нескольких пакетов приложений и хешей ключей подписи (до 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. См. также:
  • Добавлено новое свойство eventProperties в следующие API эндпоинтов Webhook:
    • Создать эндпоинт 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 пользовательских событий . См. Отправить событие (POST /v2/event/events).

​
2024-08-02

  • Добавлено поле lastMessageToPhoneNumber в объект Contact. См. Получить контакт (GET /v2/contact/contacts/{id}).

​
2024-07-18

  • Добавлено поле filterBlocked в эндпоинт отправки сообщения WhatsApp в очередь (POST /v2/whatsapp/messages). Если установлено значение true, сообщения пользователям из вашего списка блокировки отправляться не будут.

​
2024-05-24

  • С 1 июня 2024 года WhatsApp вводит новый международный тариф на аутентификацию (authentication-international rate) в Индонезии и Индии. См. Международные тарифы на аутентификацию.
  • Добавлено свойство pricingCategory в объект WhatsApp Message. Если переписка для аутентификации тарифицируется по международному тарифу аутентификации, для свойства pricingCategory в Webhook whatsapp.message.updated будет установлено значение authentication_international.
  • Добавлены свойства authIntlRateEligibilityCountries и primaryBusinessLocation в объект WhatsApp Business Account. Подпишитесь на Webhook 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.
  • Изменен срок жизни (TTL) шаблонных сообщений аутентификации с 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.
  • Добавлен срок жизни сообщений (TTL) для шаблонов аутентификации. По умолчанию составляет 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). См. также Rate Limits.

​
2023-05-26

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

​
2023-05-16

  • Добавлены эндпоинты WhatsApp messaging API /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.
  • Добавлено новое значение enum TIER_NOT_SET для свойства WhatsApp Phone Number messagingLimit.

​
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