> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Журнал изменений API

> История релизов, дополнений и изменений совместимости YCloud API с марта 2023 года по июль 2026 года.

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

<Note>
  Актуальные тарифы см. в разделе [Цены WhatsApp](/ru/documentation/pricing-and-billing/whatsapp-pricing-and-billing).
  Информация о [миграции ценообразования 2025 года](/ru/api-reference/getting-started/changelog/whatsapp-pricing-2025)
  сохранена отдельно для интерпретации старых записей.
</Note>

## 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

<Note>
  Историческое объявление: эта запись не отражает текущую доступность Webhook
  для групповых сообщений. Используйте актуальное [руководство по группам](/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-groups)
  и опубликованный каталог Webhook для проверки поддерживаемых операций и событий.
</Note>

* Поддержка WhatsApp Groups API.
* Поддержка операций со ссылками-приглашениями в группы WhatsApp, запросами на присоединение, участниками и настройками.
* Добавлен параметр `group_id` в параметры компонентов шаблонов WhatsApp.
* Добавлены типы событий Webhook для групп WhatsApp и полезные нагрузки `whatsappGroup`. См. также [События и полезные нагрузки Webhook](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples) и [Примеры полезных нагрузок Webhook](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Добавлено поле `groupId` в полезные нагрузки входящих сообщений WhatsApp для групповых сообщений.

## 2025-05-08

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

* Поддержка WhatsApp [inbound-unsupported-message](/ru/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-unsupported-message) `UNSUPPORTED_TYPE`

## 2026-04-29

* Добавлено поле `ARCHIVED` в `status` шаблона WhatsApp.
* Добавлены поля `ARCHIVED` и `UNARCHIVED` в `statusUpdateEvent` шаблона WhatsApp.
* Добавлены примеры Webhook для событий архивации и разархивации шаблонов WhatsApp. См. также [Примеры Webhook для проверки шаблонов WhatsApp](/ru/api-reference/guides/examples/webhook-examples/whatsapp-template-reviewed-webhook-examples).
* Добавлен параметр `filter.status` в эндпоинт получения списка шаблонов (`GET /v2/whatsapp/templates`) для фильтрации шаблонов по статусу, включая `ARCHIVED`.

## 2026-03-13

* Для поддержки внедрения BSUID со стороны Meta, начиная с 31 марта 2026 года, YCloud обновил ряд полезных нагрузок Webhook, связанных с обменом сообщениями и идентификацией пользователей. См. [Обновления Webhook, связанные с BSUID](/ru/api-reference/guides/whatsapp-platform/use-business-scoped-user-ids)

## 2026-03-04

* Поддержка WhatsApp [interactive-media-carousel-messages-with-quick-reply-buttons](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-media-carousel-messages-with-quick-reply-buttons)

## 2026-01-28

* Поддержка WhatsApp: [создание Gif-шаблона](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#marketing-template-with-gif)/[отправка сообщений по Gif-шаблону](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#gif-template-message)

## 2025-12-15

* Поддержка WhatsApp [deep link template](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#android-deep-link-template)

## 2025-12-03

* Поддержка WhatsApp [interactive-media-carousel-messages](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#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** . См. также:
  * [Примеры Webhook создания отписки контакта](/ru/api-reference/guides/examples/webhook-examples/contact-unsubscribe-created-webhook-examples)
  * [Примеры Webhook удаления отписки контакта](/ru/api-reference/guides/examples/webhook-examples/contact-unsubscribe-deleted-webhook-examples)

## 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](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 2025-10-10

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

## 2025-09-24

* Добавлена поддержка эндпоинта [обновления отображаемого имени телефонного номера](/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers)
* Добавлено `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](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 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

* Добавлены новые Webhook WhatsApp Smb
  * [Примеры Webhook WhatsAppSmbAppStateSync](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 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
  * [Примеры Webhook установки соединения вызова whatsapp-calling-connect](/ru/api-reference/guides/examples/webhook-examples/whatsapp-calling-connect-webhook-examples)
  * [Примеры Webhook обновления статуса вызова whatsapp-calling-status-update](/ru/api-reference/guides/examples/webhook-examples/whatsapp-calling-status-update-webhook-examples)
  * [Примеры Webhook завершения вызова whatsapp-calling-terminate](/ru/api-reference/guides/examples/webhook-examples/whatsapp-calling-terminate-webhook-examples)
* Руководство по использованию звонков WhatsApp: [whatsapp-calling-examples](/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-calls)

## 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`. См. также:
  * [Примеры Webhook создания контакта](/ru/api-reference/guides/examples/webhook-examples/contact-created-webhook-examples)
  * [Примеры Webhook удаления контакта](/ru/api-reference/guides/examples/webhook-examples/contact-deleted-webhook-examples)
  * [Примеры Webhook изменения атрибутов контакта](/ru/api-reference/guides/examples/webhook-examples/contact-attributes-changed-webhook-examples)
* Добавлено новое свойство `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

* Поддержка сообщений WhatsApp [сведения о заказе](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-details-template-message) и [статус заказа](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-status-template-message).
* Добавлен новый тип события Webhook `whatsapp.payment.updated`. См. также [Примеры Webhook обновления платежа в WhatsApp](/ru/api-reference/guides/examples/webhook-examples/whatsapp-payment-updated-webhook-examples).

## 2024-09-12

* Поддержка [WhatsApp Flows](https://developers.facebook.com/docs/whatsapp/flows). См. также [Шаблон Flow](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#flow-template), [Шаблонное сообщение Flow](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#flow-template-message), [Интерактивное сообщение Flow](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-flow-message) и [Входящий интерактивный ответ на сообщение Flow](/ru/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-interactive-flow-response-message).

## 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) в Индонезии и Индии. См. [Международные тарифы на аутентификацию](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates).
* Добавлено свойство `pricingCategory` в объект WhatsApp Message. Если переписка для аутентификации тарифицируется по международному тарифу аутентификации, для свойства `pricingCategory` в Webhook [whatsapp.message.updated](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples) будет установлено значение `authentication_international`.
* Добавлены свойства `authIntlRateEligibilityCountries` и `primaryBusinessLocation` в объект WhatsApp Business Account. Подпишитесь на Webhook [Authentication-International Rate Eligibility](/ru/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples#authentication-international-rate-eligibility) и [Primary Business Location Update](/ru/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples#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](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-location-request-message).
* Добавлена поддержка WhatsApp [Inbound Request Welcome message](/ru/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#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

* Добавлены эндпоинты [Unsubscribers](/ru/api-reference/guides/customer-data-and-operations/manage-unsubscribers).

## 2023-12-13

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

## 2023-11-24

* Добавлена поддержка WhatsApp [Catalog template](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#catalog-template) и [Catalog template message](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#catalog-template-message).
* Добавлена поддержка WhatsApp [Multi-Product Message template](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#multi-product-message-template) и [MPM template message](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#mpm-template-message).
* Добавлена поддержка WhatsApp [Interactive Catalog message](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-catalog-message).
* Добавлен эндпоинт Update commerce settings (`PATCH /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings`) для включения или отключения корзины либо каталога товаров для конкретного бизнес-номера телефона.

## 2023-11-02

* Добавлена поддержка WhatsApp [Zero-Tap Authentication template](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#zero-tap-authentication-template).
* Добавлен срок жизни сообщений (TTL) для шаблонов аутентификации. По умолчанию составляет 600 секунд для вновь создаваемых шаблонов аутентификации.

## 2023-10-27

* Добавлена поддержка WhatsApp [Limited-Time Offer template](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#limited-time-offer-template) и [Limited-Time Offer template message](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#limited-time-offer-template-message).
* Добавлена поддержка WhatsApp [Carousel template](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#carousel-template) и [Carousel template message](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#carousel-template-message).

## 2023-10-18

* Добавлена поддержка сообщений WhatsApp Interactive CTA URL Button. См. также [Interactive CTA URL Message Example](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-cta-url-message).

## 2023-10-12

* Добавлены типы событий Webhook [whatsapp.business\_account.deleted](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples) и [whatsapp.phone\_number.deleted](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Добавлена поддержка WhatsApp [Coupon Templates](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/coupon-templates). Дополнительные примеры см. в разделах [Coupon template](/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#coupon-template) и [Coupon template message](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#coupon-template-message).

## 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](/ru/api-reference/guides/api-fundamentals/rate-limits).

## 2023-05-26

* Добавлен тип события Webhook `whatsapp.template.quality_updated`, позволяющий отслеживать изменения [Template Quality Rating](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/#quality-rating) в WhatsApp. См. [Webhook Events & Payloads](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Добавлено свойство `qualityRating` в объект WhatsApp Template.

## 2023-05-16

* Добавлены эндпоинты WhatsApp messaging API `/v2/whatsapp/messages/sendDirectly`. Информацию об обработке ошибок см. в разделе [WhatsApp Errors](/ru/api-reference/guides/whatsapp-platform/handle-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](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples). Подробнее о миграции категорий шаблонов см. в разделе [First template category migration](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#first-template-category-migration).
* Добавлены новые типы источников переписок WhatsApp: `authentication`, `marketing`, `utility` и `service`. Переход на новую модель ценообразования произойдет 1 июня 2023 года. См. также [Новые тарифы на переписки](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#new-conversation-rates), вступающие в силу с 1 июня 2023 года.
* Добавлена поддержка создания [шаблонов аутентификации с кнопками одноразового пароля](https://developers.facebook.com/docs/whatsapp/business-management-api/authentication-templates), которые станут доступны с 1 мая 2023 года и будут обязательными с 29 мая 2023 года.

## 2023-03-09

* Добавлен заголовок ответа `YCloud-Request-ID` для каждого запроса. См. [Идентификатор запроса](/ru/api-reference/guides/api-fundamentals/handle-errors#request-correlation).
* В объект ответа `error` добавлено поле `requestId`. См. [Ошибки](/ru/api-reference/guides/api-fundamentals/handle-errors#request-correlation).
* Добавлены новые категории шаблонов WhatsApp: `AUTHENTICATION` и `UTILITY`. См. также [График запуска изменений цен](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#new-template-categories)

<br />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.