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

Этот документ представляет собой журнал изменений в платформе WhatsApp Business.

10 апреля 2024 г.

Облачный API

• Добавлена библиотека шаблонов категории "Услуги"

10 апреля 2024 г.

Облачный API

• Добавлено переопределение URL обратного вызова для Webhooks для номеров телефона компаний.

18 марта 2024 г.

Облачный API

• Добавлен Conversational Components API.

13 февраля 2024 г.

Облачный API

• Изменены ограничения на количество попыток регистрации и отмены регистрации для номеров телефонов компаний. Теперь она составляет 10 запросов для одного номера телефона компании в течение скользящего 72-часового окна (раньше оно действовало в течение скользящего недельного окна).

6 февраля 2024 г.

Облачный API, локальный API

• Чтобы обеспечить максимальное удобство для пользователей, мы добавили ограничения количества сообщений с шаблоном типа "Маркетинг" на пользователя.

26 января 2024 г.

Облачный API

• Время жизни для повторных попыток доставить сообщений с шаблонами в облачном API теперь составляет 30 дней, а не 24 часа. Вы по-прежнему можете переопределить это значение для шаблонов категории "Аутентификация".
• Максимальное количество символов для biz_opaque_callback_data увеличено с 256 до 512.

18 января 2024 г.

Облачный API

• Добавлены компоненты переписок.

18 декабря 2023 г.

Облачный API

• Добавлены сообщения с запросом геоданных.

12 декабря 2023 г.

Business Management API

• В узел шаблона сообщения WhatsApp добавлено поле cta_url_link_tracking_opted_out, позволяющее включать и отключать отслеживание нажатия кнопок.
• В аналитику шаблонов теперь добавляются нажатия кнопок в шаблонах категории UTILITY.

20 ноября 2023 г.

Business Management API

• Добавлена регистрация консоли для помощи при отладке шаблонов для аутентификации с одним нажатием и без нажатия.

14 ноября 2023 г.

Облачный API

• В некоторые узлы добавлено поле health_status для проверки статуса работоспособности сообщений.
• Добавлено поле biz_opaque_callback_data в сообщения в свободной форме для добавления произвольных строк в Webhooks объекта messages.

3 ноября 2023 г.

Business Management API

• При создании шаблона с кольцевой галереей теперь требуется хотя бы одна кнопка.

23 октября 2023 г.

Business Management API, облачный API, локальный API

• Добавлены сообщения для аутентификации без нажатия.

10 октября 2023 г.

Flows

• Стали доступны WhatsApp Flows.

Облачный API

• В конечную точку Номер телефона WhatsApp Business > Зарегистрировать добавлено новое поле data_localization_region для включения локального хранилища.
• Добавлены новые кнопки призыва к действию с URL для отправки интерактивных сообщений в свободной форме.

4 октября 2023 г.

Business Management API, облачный API, локальный API

• В шаблонах категории "Аутентификация", в которых используется предупреждение об истечении срока действия кода, теперь применяется значение code_expiration_minutes (а не значение по умолчанию, равное 10 минутам). Это позволяет определить, какая кнопка должна отображаться в доставленном сообщении с шаблоном: кнопка автоматического заполнения или кнопка копирования кода.
• Кнопки автоматического заполнения, отображаемые в доставленном сообщении с шаблоном, будут отключаться по истечении времени, указанного в параметре code_expiration_minutes. Если оно не указано, будет действовать значение по умолчанию: 10 минут.

2 октября 2023 г.

Облачный API

• Добавлены новые шаблоны для ограниченных предложений и новый компонент шаблонов limited_time_offer.

27 сентября 2023 г.

Облачный API

• В объект referral в messages webhooks добавлено свойство ctwa_clid. В нем указывается ID клика, который генерируется, когда пользователь нажимает рекламу с переходом WhatsApp, чтобы отправить сообщение.

18 сентября 2023 г.

Облачный API, локальный API

• Устаревшие шаблоны категории "Аутентификация" (шаблоны категории "Аутентификация", в которых нет кнопок одноразового пароля), по-прежнему можно отправлять, редактировать и обжаловать до 1 апреля 2024 г. (ранее срок заканчивался 2 октября 2023 г.).

12 сентября 2023 г.

Business Management API

• Ответы на запросы GET для шаблонов категории "Аутентификация" теперь содержат компоненты шаблона add_security_recommendation и code_expiration_minutes в значении параметра component.
• Добавлены новые уровни доступа к аккаунту WhatsApp Business для более точного контроля.
• Запросы GET к конечным точкам Аккаунт WhatsApp Business > Номера телефонов и Аккаунт WhatsApp Business > Шаблоны сообщений теперь возвращают ошибку с кодом 200, если пользователю, идентифицируемому маркером, не был предоставлен надлежащий доступ к аккаунту WhatsApp Business.
• Добавлен перенос шаблонов.

Облачный API

• В номера телефонов WhatsApp Business добавлены поля throughput и platform_type.
• Добавлены шаблоны кольцевых галерей.

Облачный API, локальный API

• При переносе номеров телефонов компании, использующей конфигурацию с распределением нагрузки с 2 и более сегментами, с локального API в облачный эти номера автоматически получают более высокую пропускную способность облачного API.

28 августа 2023 г.

Облачный API, локальный API

• Добавлено оценивание шаблона (бета-версия, для отдельных стран).

15 августа 2023 г.

Business Management API

• Добавлено поле template_analytics (бета-версия).

8 августа 2023 г.

Инструменты

• На страницу статуса WhatsApp Business API добавлен статус локального хранилища облачного API.

Business Management API

• Добавлен компонент кнопки копирования кода для использования с шаблонами кодов купонов.
• Общий лимит компонентов кнопок шаблона увеличен до 10. Кнопки быстрого ответа теперь можно комбинировать с кнопками других типов, а лимит кнопок с URL увеличен до 2.
• Добавлено массовое управление шаблонами.
• Добавлен предварительный просмотр шаблонов для предпросмотра текста шаблона на нескольких языках.

Регистрация на сайте поставщика

• Добавлена возможность отключать выбор номера телефона при регистрации на сайте поставщика.
• Добавлена программная/массовая регистрация номеров телефонов компании.
• Добавлена массовая регистрация предварительно подтвержденных номеров телефонов компании.
• Добавлена передача предварительно подтвержденных номеров телефонов компании.

2 августа 2023 г.

Business Management API

• Предварительно подтвержденным номерам телефонов статус VERIFIED теперь присваивается на 28 дней (а не через 14).

11 июля 2023 г.

Облачный API

• Чтобы запланировать и изменить пропускную способность номера телефона компании, больше не требуется звонить.
• Теперь время запланированного изменения можно указать при отправке запроса на изменение пропускной способности в прямую поддержку.
• Время простоя при изменении пропускной способности сокращено и не превышает 5 минут.

7 июля 2023 г.

Business Management

• Указывать текст кнопки копирования и автозаполнения кода при создании шаблона категории "Аутентификация" теперь не обязательно.

13 июня 2023 г.

Инструменты

• На страницу статуса WhatsApp Business API добавлена задержка.

Business Management

• Добавлен код ошибки 2494100 Business Management API. Он означает, что номер телефона компании временно находится в режиме обслуживания.

Облачный API

• Добавлена функция проверки изменения идентификационных данных.
• Добавлены сообщения каталога.
• Добавлены шаблоны каталога.

26 мая 2023 г.

Инструменты

• Добавлены сигналы ошибок, которые могут помочь в отладке шаблонов категории "Аутентификация" с кнопками автоматического заполнения одноразовых паролей.

23 мая 2023 г.

Облачный API

• При отправке приостановленного шаблона сообщения с использованием версии 17 или более поздней теперь возвращается код ошибки 132015, а не 132001.
• При отправке отключенного шаблона сообщения с использованием версии 17 или более поздней теперь возвращается код ошибки 132016, а не 132001.

Локальный API

• При отправке приостановленного шаблона сообщения теперь возвращается код ошибки 2061.
• При отправке отключенного шаблона сообщения теперь возвращается код ошибки 2062.

9 мая 2023 г.

Business Management API

• Добавлены шаблоны сообщений с несколькими товарами.

Облачный API

• Добавлены платежи через Stripe (только для Сингапура).
• Добавлены сообщения с адресом для запроса адресов клиентов (только для Сингапура и Индии).
• Добавлена пропускная способность в 1 000 сообщений в секунду.

Локальный API

• Добавлены платежи через Stripe (только для Сингапура).
• Добавлены сообщения с адресом для запроса адресов клиентов (только для Сингапура и Индии).

1 мая 2023 г.

Business Management API

• В поле account_alerts webhooks добавлены новые Webhooks для уведомления об отказе в повышении ограничения на числа сообщений.
• Все шаблоны теперь должны иметь одну из следующих категорий: AUTHENTICATION, MARKETING или UTILITY.

26 апреля 2023 г.

Business Management API

• Добавлено поле hsm_id в конечную точку DELETE Аккаунт WhatsApp Business > Шаблоны сообщений. В случае добавления это поле удаляет один шаблон, которые соответствует предоставленному ID (вместо удаления всех шаблонов, которые соответствуют предоставленному имени).

18 апреля 2023 г.

Облачный API

• В узел номера телефона WhatsApp Business добавлено поле last_onboarded_time. Указывает, когда пользователь создал номер телефона компании в своем аккаунте WhatsApp Business, выполнив процедуру регистрации на сайте поставщика.

11 апреля 2023 г.

Облачный API

• Добавлена конечная точка Номер телефона WhatsApp Business > Информация о соответствии компании для добавления или обновления информации о соответствии номера телефона в Индии.

Регистрация на сайте поставщика

• Добавлены следующие конечные точки для поддержки предварительно одобренных номеров телефонов для пользователей с регистрацией на сайте поставщика:

  • Предварительно одобренный номер телефона WhatsApp Business
  • Предварительно одобренный номер телефона WhatsApp Business > Запрос кода
  • Предварительно одобренный номер телефона WhatsApp Business > Подтверждение кода
  • Компания > Добавление номеров телефонов

4 апреля 2023 г.

Business Management API, облачный API, локальный API

• Первый перенос категорий шаблонов завершен.
• Проверка категории теперь является частью проверки шаблона, выполняемой для новых шаблонов. Относится к версии 16.0 и более поздним.
• Ответы API на запросы создания или редактирования шаблона теперь содержат статус шаблона и его категорию. Относится ко всем версиям API.
• Добавлен параметр allow_category_change в конечную точку POST Аккаунт WhatsApp Business > Шаблоны сообщений.
• Добавлено INCORRECT_CATEGORY как новое значение отклонения reason для Webhooks статуса шаблона.
• Шаблонам, которые зависят от переменных, теперь требуются примеры значений после создания или редактирования. Относится ко всем версиям.
• Добавлено поле previous_category в шаблоны сообщений WhatsApp.
• Переписки, начатые компаниями, более не входят в переписки в рамках бесплатного плана. Если ваш аккаунт WhatsApp Business использует услуги партнера по решениям или партнера Meta, эти изменения вас не коснутся до 1 июня 2023 г.

17 марта 2023 г.

Business Management API

• Добавлено новое поле подписки Webhookstemplate_category_update. Если вы подписаны на это поле, то при каждом изменении категории шаблона вы будете получать Webhooks с указанием предыдущей и новой категории.
• Ответы API на запросы создания и редактирования шаблона теперь содержат статус и категорию шаблона.

14 марта 2023 г.

Облачный API

• Чтобы делиться с пользователями информацией о местоположении, можно добавить в шаблон заголовок Location.

Локальный API

• Теперь пользователи могут делиться информацией о своем местоположении с компаниями, используя сообщения с запросом геоданных.

1 марта 2023 г.

Облачный API, локальный API

• Перенос номеров телефонов компаний, находящихся в Индии, из локального в облачный API теперь не приводит к удалению персональных данных, полученных при онлайн-продажах. Вам больше не придется вручную заполнять эти данные после переноса.

15 февраля 2023 г.

Business Management API

• Добавлена новая конечная точка сравнения шаблонов, с помощью которой можно сравнить количество отправок и блокировок шаблонов.

3 февраля 2023 г.

Облачный API, локальный API

• Чтобы включить или отключить корзину или каталог товаров для конкретного номера телефона компании, теперь можно использовать новую конечную точку Номер телефона WhatsApp Business > Параметры торговли WhatsApp. Инструкции по использованию и информацию о том, как эти параметры помогают продавать товары и услуги, см. в руководствах по настройке параметров торговли для облачного и локального API.

2 февраля 2023 г.

Business Management API, облачный API

• Вышла версия 16 для Graph API. В этой версии изменения коснулись категорий шаблонов сообщений. ответов API на ошибки и Webhooks.

Облачный API

• Шаблоны, созданные или отредактированные в версии 16.0, теперь должны классифицироваться согласно перечисленным ниже категориям. Все прочие категории больше не поддерживаются. Относится к облачному API версии 16 и более поздних. Начнет действовать для всех версий с 1 мая 2023 г. Эти изменения связаны с переходом на новую модель платы за переписку, которая начинает действовать с 1 июня 2023 г.

  • AUTHENTICATION
  • MARKETING
  • UTILITY
• Поддержка подкодов ошибок, которые редко используются и не являются надежным источником сведений, в ответах на ошибки в версии 16.0 и более поздних прекращена. Используйте вместо них code и details.
• Код ошибки 100 ("code":100) имел несколько уникальных заголовков, описывающих причину ошибки 100. Теперь все ошибки 100 используют в качестве заголовка Invalid parameter. Прежние заголовки, описывающие природу ошибки, перенесены в свойство details. Это изменение также касается полезных данных Webhooks, описывающих ответ на ошибку 100.

Webhooks облачного API

• Объект errors в Webhooks, которые активируются ошибками при вызовах в версии 16.0 и более поздних, теперь содержит свойства message и error_data.details. Значения title изменены для нескольких кодов ошибок. Объект errors будет иметь следующую структуру и данные.

[
  {
    "code": <CODE>,
    "title" : "<TITLE>",
    "message": "<MESSAGE>",
    "error_data": {
      "details": "<DETAILS>"
    }
  },
  ...
]

• Свойство title обновлено для следующих кодов ошибок. Старые значения будут отображаться в error_data.details.

  • Ошибка 130470 теперь называется Re-engagement message
  • Ошибка 130429 теперь называется Rate limit hit
  • Ошибка 131045 теперь называется Incorrect certificate
  • Ошибка 131031 теперь называется Business Account locked
  • Ошибка 131053 теперь называется Media upload error
  • Ошибка 131027 теперь называется Something went wrong
  • Ошибка 131042 теперь называется Business eligibility payment issue
  • Ошибка 131026 теперь называется Message Undeliverable
  • Ошибка 131000 теперь называется Something went wrong
• Значение свойства message совпадает со значением свойства title — названием кода ошибки. Свойство соответствует свойству message в полезных данных ответов на ошибки API.
• Свойство error_data.details теперь содержит названия кодов ошибок из списка выше и указывает на причину ошибки. Значение соответствует свойству details в полезных данных ответов на ошибки API.

Эти изменения отражены в свойствах errors в связанных с ошибками Webhooks:

• entry.changes.value.errors;
• entry.changes.value.messages.errors;
• entry.changes.value.statuses.errors.

30 января 2023 г.

Облачный API

Неподтвержденные компании могут начинать до 250 переписок в течение 24-часового периода.

13 декабря 2022 г.

Проверка разрешений для медиафайлов

Относится ко всем версиям облачного API.

Для конечной точки Media добавлено необязательное поле phone_number_id. Если вы зададите этот параметр и укажете ID номера телефона компании, операция будет обрабатываться только в том случае, если ID номера телефона совпадает с ID номера, для которого был загружен медиафайл.

8 декабря 2022 г.

HTTP-кэширование медиафайлов

HTTP-кэширование медиафайлов для облачного API теперь доступно для всех разработчиков.

Webhooks

Теперь облачный API будет продолжать попытки доставить уведомления Webhooks в течение 7 дней, а не 30. См. раздел об ошибках при доставке Webhooks.

23 ноября 2022 г.

Новое поле Webhooks

Относится ко всем версиям.

• Добавлено поле template_performance_metrics. Предоставляет еженедельные уведомления о метриках эффективности шаблонов, в том числе о количестве отправленных и открытых сообщений, а также об основных причинах блокирования.

22 ноября 2022 г.

Новые поля Webhooks и их значения

Относится ко всем версиям.

Новое поле account_alerts:

• добавлено поле account_alerts, которое уведомляет об оповещениях для компании, аккаунта WhatsApp Business и номера телефона компании.

Новые значения поля account_update:

• добавлено новое значение для поля account_update.events — ACCOUNT_DELETED, которое означает, что номер телефона удален из аккаунта WhatsApp Business или больше не связан с ним;
• добавлено новое значение message_template_status_update.events — PENDING_DELETION, которое указывает, что шаблон сообщения помечен для удаления.

Примеры уведомлений Webhooks, которые отправляются при запуске новых событий:

• ACCOUNT_DELETED — аккаунт WhatsApp Business удален;
• PENDING_DELETION — шаблон сообщения ожидает удаления.

Новые поля узла аккаунта WhatsApp Business

Добавлены следующие поля узла аккаунта WhatsApp Business:

• country (для v15.0+);
• ownership_type (для v15.0+);
• business_verification_status (для всех версий).

Новые фильтры конечной точки компании

Относится к версии 15.0 и более поздним.

Добавлены следующие параметры фильтрации для конечной точки client_whatsapp_business_accounts:

• фильтрация по полю creation_time аккаунта WhatsApp Business с операторами GREATER_THAN, LESS_THAN или IN_RANGE;
• фильтрация по полю ownership_type аккаунта WhatsApp Business с операторами EQUAL и IN.

Добавлены следующие параметры фильтрации для конечной точки owned_whatsapp_business_accounts:

• фильтрация по полю creation_time аккаунта WhatsApp Business с операторами GREATER_THAN, LESS_THAN или IN_RANGE;
• фильтрация по полю ownership_type аккаунта WhatsApp Business с операторами EQUAL и IN;
• фильтрация по полю country аккаунта WhatsApp Business с операторами EQUAL и IN.

Новые поля узла номера телефона

Относится к версии 15.0 и более поздним.

Добавлены следующие поля узла номера телефона WhatsApp Business:

• is_official_business_account
• messaging_limit_tier

Кроме того, конечную точку номеров телефонов аккаунта WhatsApp Business можно фильтровать по параметру is_official_business_account.

3 ноября 2022 г.

Количество сообщений в секунду

Теперь облачный API по запросу поддерживает до 500 (ранее 350) текстовых сообщений и сообщений с медиафайлами в секунду (вместе взятых). Подробности см. в разделе Пропускная способность.

Если вы уже отправляете и получаете 350 сообщений в секунду, это ограничение автоматически повысится до 500. Если вы уже запросили пропускную способность в 350 сообщений в секунду, но процесс ещё не завершен, по его завершении вам будет предоставлена пропускная способность в 500 сообщений в секунду.

HTTP-кэширование медиафайлов

Мы проводим бета-тестирование HTTP-кэширования медиафайлов в облачном API. Партнерам по решениям необходимо ознакомиться с разделом, посвященным HTTP-кэшированию медиафайлов. В нем содержится информация о том, как использовать заголовки в ответах сервера, чтобы мы кэшировали медиафайлы для повторного использования в будущих сообщениях.

Подписи к документам

Облачный API теперь поддерживает подписи-комментарии к документам, которыми вы обмениваетесь с клиентами. См. раздел Объект медиаданных в справке по медиафайлам.

25 октября 2022 г.

Увеличение ограничения на количество шаблонов сообщений

Теперь аккаунты WhatsApp Business могут иметь до 6 000 шаблонов сообщений, если их родительская компания подтверждена и по крайней мере у одного из аккаунтов WhatsApp Business родительской компании есть номер телефона с одобренным отображаемым именем.

Версии шаблонов сообщений, переведенные на другие языки, учитываются в общем количестве доступных шаблонов сообщений аккаунта WhatsApp Business.

20 октября 2022 г.

Биллинг

Компании из Индии теперь могут использовать кредитные карты для оплаты отправленных через платформу сообщений. См. статью Добавление кредитной карты в аккаунт на платформе WhatsApp Business.

12 октября 2022 г.

Миграция номера телефона компании

Теперь номер телефона компании можно переносить между аккаунтами WhatsApp Business через облачный API. См. статью Перенос номера телефона в другой аккаунт WhatsApp Business.

6 октября 2022 г.

Переопределение обратных вызовов

Только для облачного API.

Теперь для каждого аккаунта WhatsApp Business можно использовать отдельные URL обратных вызовов. Создавать отдельные приложения для каждого аккаунта не требуется. Подробнее см. в статье Переопределение URL обратного вызова.

Вызовы версии 15

Все конечные точки облачного API теперь поддерживают вызовы версии 15.

Шаблоны сообщений

Только для облачного API.

Параметры текста (components.parameters.text) для шаблонов сообщений, которые используют только компонент body (components.type:body), теперь могут иметь длину до 32 768 символов. См. раздел Объект параметров.

Количество сообщений в секунду

Только для облачного API.

Теперь облачный API по запросу поддерживает до 350 (ранее 250) текстовых сообщений и сообщений с медиафайлами в секунду (вместе взятых). Подробности см. в разделе Пропускная способность.

Если вы уже отправляете и получаете 250 сообщений в секунду, это ограничение автоматически повысится до 350. Если вы уже запросили пропускную способность в 250 сообщений в секунду, но процесс ещё не завершен, по его завершении вам будет предоставлена пропускная способность в 350 сообщений в секунду.

Облачный API — 22 сентября 2022 г.

Реакции

Реализована поддержка реакций. Информацию о том, как отправлять и получать реакции, см. в разделе Отправка сообщений — сообщения с реакциями. Примеры полезной нагрузки уведомлений Webhooks см. в разделе Примеры полезной нагрузки — сообщения с реакциями.

Профиль компании

Для профилей компании теперь поддерживается поле about. Подробнее см. в статье Профили компании.

Облачный API — 7 сентября 2022 г.

Количество сообщений в секунду

Вышла новая документация по запросу перехода с пропускной способности в 80 сообщений в секунду на 250 сообщений в секунду (вместе взятых отправленных и полученных текстовых сообщений или сообщений с медиафайлами). См. статью Пропускная способность.

Облачный API — 25 августа 2022 г.

Анимированные стикеры

Теперь вы можете добавлять анимированные стикеры в исходящие начатые компанией сообщения и получать Webhooks сообщений с их описанием точно так же, как при отправке сообщений со стикерами без анимации. См. информацию о свойстве sticker объекта Сообщение и требования к использованию объекта анимированных стикеров.

Сообщения с товарами

Теперь вы можете добавлять товары и услуги в сообщения, отправляемые клиентам, а они могут добавлять их в корзину, не выходя из чата. Информацию о том, как отправлять клиентам сообщения с одним или несколькими товарами, см. в руководстве по продаже товаров и услуг.

Облачный API — 21 июля 2022 г.

Ответы

Теперь компании могут отвечать на любые сообщения в переписке. Ответ будет содержать сообщение, на которое компания отвечает. Информацию о том, как отвечать на сообщение, см. в руководстве по отправке сообщений.

Количество сообщений в секунду

Теперь облачный API по запросу поддерживает до 250 вместе взятых отправленных и полученных сообщений в секунду (в том числе текстовых сообщений и сообщений с медиафайлами). Корпоративные партнеры могут обратиться в прямую поддержку и запросить пропускную способность 250 сообщений в секунду. Для этого выберите тему запроса "Cloud API Issues", тип запроса "Request to migrate to 250 MPS throughput" и введите необходимую информацию.

Уведомление для разработчиков: в версиях 2.43 и 2.45 будут введены функции без обратной совместимости

v2.43, 11 октября 2022 г.

• Начиная с версии v2.43 в работу конечной точки contacts будут внесены изменения

  • Ответы при запросе поля status будут изменены. Вне зависимости от того, есть ли у пользователя аккаунт WhatsApp, в ответе всегда будет возвращаться wa_id, а для поля status будет указываться значение valid. При этом не гарантируется, что возвращенный wa_id будет действительным. Эти изменения действуют как для прямых ответов, так и для ответов Webhooks для неблокирующих вызовов
  • Убедитесь, что ваш код не требует получения status и wa_id в ответе от узла contacts. Кроме того, при отправке сообщений в версии v2.39.1 и более новых необязательно вызывать узел contacts.

• Убедитесь, что ваш код может обрабатывать ошибку 1013Недействительный пользователь. Она может возникать при отправке шаблона сообщения на номер телефона, с которым не связан аккаунт WhatsApp

• Если сообщение не является шаблоном и отправляется на номер телефона, с которым не связан аккаунт WhatsApp, будет возвращаться ошибка 470.

v2.45, 10 января 2023 г.

• Начиная с версии v2.45необязательный параметр cert узла shards станет обязательным для всех запросов. Обновите свою интеграцию: при вызове к узлу shards она должна всегда использовать действительный cert.

• Начиная с версии v2.41.2 компании могут использовать узел application, чтобы отфильтровывать статусы исходящих сообщений, которые им не нужны. Для этого нужно использовать объект message в объекте webhooks. В версии v2.45 параметр sent_status использовать объект webhooks на узле application.

• Начиная с версии v2.39.1 параметр recipient_id может использоваться как в объекте statuses, так и в объекте message. В версии v2.45 параметр recipient_id будет удален из объекта statuses, поэтому ваша интеграция должна использовать recipient_id в объекте message.

Локальный API — 19 сентября 2022 г. (v2.41.3)

Выпуск 2.41.3

В версии v2.41.3 клиента Business API добавлен новый индекс таблицы для message_receipt_log. Он будет полезен партнерам, которым требуется высокая пропускная способность. В частности, благодаря этому обновлению партнеры могут отправлять более 200 сообщений в секунду.

Локальный API — 27 июня 2022 г. (v2.41.2)

Эта версия клиента содержит перечисленные далее функции и обновления.

• Снижена задержка при выполнении массовых запросов /contacts от конечных точек, устранены проблемы взаимной блокировки.
• Повышена производительность и надежность сборки мусора.
• Расширены возможности управления уведомлениями Webhooks для сообщений: теперь компании могут включать и отключать уведомления Webhooks delivered и read. Это можно сделать с помощью конечной точки settings/applications.
• Для объекта template необязательно заполнять поле namespace.
• Повышено качество обработки ошибок скачивания медиа: компании будут реже сталкиваться с проблемами при скачивании медиафайлов, полученных от клиентов.
• Исправлены другие ошибки, повышена надежность процессов регистрации и отправки сообщений.

Облачный API WhatsApp Business — 19 мая 2022 г.

С сегодняшнего дня облачный WhatsApp Business API открыт для всех разработчиков, работающих над созданием продуктов и услуг для себя или организаций. Чтобы начать работу, ознакомьтесь с нашим руководством. Если вы хотите предлагать доступ к API своим клиентам, запишитесь в список ожидания.

WhatsApp Business Management API — 19 мая 2022 г.

Категории шаблонов сообщений

Для параметра category конечной точки /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template в версии v14.0 и более поздних упразднены следующие значения:

Следующие значения добавлены:

• TRANSACTIONAL;
• MARKETING.

Локальный API WhatsApp — 10 мая 2022 г. (версия 2.39.4)

Эта версия клиента содержит все функции и исправления, входящие в версию v2.39.1. Кроме того, в этом выпуске:

• Исправлена ошибка, из-за которой видеосообщения в некоторых случаях не отправлялись. Это исправление также вошло в версию v2.39.2.
• Исправлена ошибка, из-за которой компании не могли отправлять сообщения клиенту, если он первым начал переписку между двумя сторонами в WhatsApp, и это происходило более 7 дней назад. Это исправление также вошло в версию v2.39.3.
• Исправлена ошибка, из-за которой компании не могли получать исчезающие сообщения от клиентов. После установки версии v2.39.4 компании будут проинформированы о получении исчезающего сообщения посредством уведомлений Webhooks, тип которых указан как "ephemeral". Компании не смогут просматривать контент сообщения.

После запуска v2.39.3 проблема с исчезающими сообщениями автоматически обрабатывалась приложением WhatsApp, которое отключало эти сообщения в чате с клиентом. Для версии v2.39.4 мы не будем этого делать. В этой версии компании, которые получают исчезающие сообщения, должны попросить клиента отключить такие сообщения и повторно отправить свое последнее сообщение.

Локальный API WhatsApp — шаблоны AWS — 4 мая 2022 г.

Выпуск 2.3.8

URL шаблонов

• Enterprise: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=0pACuWHFUL7U1RjxGcTkAsza7rj._5tK
• DB: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=4BtYzof0_z0yl7Pbat9mln8Xj5CYS07Z
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=o1JUcpuOHKfTU_hRExFxhib5YCeXeZx.
• Network: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=_D2yaFcS1zEqRLf23t2Wesnh3M.Qw1UF
• Monitoring: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_monitoring.yml?versionId=H534ejFNiHnMpWyy1ERh3kr9TvM5VtyS

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

• Обновление AMI для машин с CentOS 7

Облачный API — 3 мая 2022 г.

С сегодняшнего дня в облачный API внесены следующие обновления:

• исправлена проблема с исчезающими сообщениями от пользователей;
• повышено качество миниатюр в сообщениях с медиафайлами.

Локальный API WhatsApp — шаблоны AWS — 26 апреля 2022 г.

Выпуск 2.3.7

URL шаблонов

• Enterprise: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=bNECfwPYZZNGlhzkfCyheoQugydIiui4
• DB: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=RRa0vGtuodHnWNyww8uLyZUAWFOfQ7hN
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=Sp2BO2LgxkVWH2XTxZ6pgOx3yf1xEqUQ
• Network: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=uNubDzGLs1WddCGB0EgEa6OMSF1vw4Mn
• Monitoring: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_monitoring.yml?versionId=HyC5PA5IZy9d.CFDkNTGDBEyxSHf5gHI

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

• Переход от использования pip к pip3 для установки скриптов начальной загрузки AWS.
• Устранена проблема с установкой awscli.

Облачный API — 5 апреля 2022 г.

С сегодняшнего дня облачный API доступен всем существующим партнерам по решениям и их прямым клиентам. Кроме того, мы выпускаем следующие функции для разработчиков, работающих с облачным API:

• Сообщения со стикерами. Отправка сообщений со статическими стикерами сторонних авторов. Дополнительные сведения см. в справке по сообщениям и справке по медиафайлам. Мы поддерживаем как входящие, так и исходящие стикеры. Для исходящих сообщений поддерживаются только статические стикеры сторонних авторов. Для входящих поддерживаются стикеры всех типов.
• API отмены регистрации номера телефона. Вызовы POST к PHONE_NUMBER_ID/deregister для удаления номера телефона из WhatsApp Business API. Дополнительную информацию см. в документации по регистрации.
• Новый способ подтверждения номера телефона. Подтверждение номера телефона с помощью вызовов Graph API. См. статью о номерах телефонов.
• Новые Webhooks рефералов. Уведомления Webhooks, когда пользователь нажимает рекламу с переходом в WhatsApp и отправляет сообщение компании. Дополнительную информацию см. в документации по Webhooks. Обратите внимание: объект referral Webhooks облачного API отличается от объекта referral локального API.

Кроме того, мы объявляем, что проверка приложения для разработчиков, использующих облачный API для разработки в личных целях, больше не требуется. Ограничения на сообщения на платформе WhatsApp Business распространяются на всех разработчиков.

Локальный API — 26 марта 2022 г.

В этой версии представлены все те же функции, что и в версии v2.37.1, но срок их действия изменен. Срок действия v2.37.2 истекает 22 сентября 2022 года.

Известные проблемы

Некоторые разработчики Kubernetes могут увидеть CrashLoopBackOff для своего контейнера webapp, и их контейнер может не запуститься. Чтобы исправить эту ошибку, добавьте в файл YML развертывания Kubernetes в конфигурации webapp следующую строку:

command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]

Локальный API — 25 марта 2022 г.

С сегодняшнего дня разработчикам доступна версия v2.39.3 нашего клиента WhatsApp Business API. Новый клиент содержит два исправления и дополнительные журналы для поддержки отладки. Реализованы следующие два изменения:

• Исправлена ошибка, из-за которой компании не могли отправлять сообщения клиенту, если он первым начал переписку между двумя сторонами в WhatsApp, и это происходило более 7 дней назад.
• Исправлена ошибка, из-за которой компании не могли получать исчезающие сообщения от клиентов. После установки версии 2.39.3 компании будут проинформированы о получении исчезающего сообщения посредством уведомлений Webhooks. На своей стороне клиенты увидят уведомление о том, что режим исчезающих сообщений отключен.

Облачный API — 15 марта 2022 г.

Сообщения со списками и кнопки ответа

С сегодняшнего дня пользователи бета-версии облачного API могут отправлять сообщения со списками и кнопками ответа. Дополнительные сведения:

• справка по сообщениям;
• Webhooks, сообщения со списками и кнопки ответа;
• компоненты Webhooks.

Предпросмотр URL

С сегодняшнего дня пользователи бета-версии облачного API могут добавлять в текстовые сообщения, содержащие URL, поле его предпросмотра. Дополнительные сведения:

• справка по сообщениям.

Новые руководства

• Перенос между локальным и облачным API

Локальный API — 4 марта 2022 г.

Мы только что выпустили локальный API v2.39.2. В этой версии исправлена ошибка, из-за которой в некоторых случаях не отправлялись видеосообщения.

Известные проблемы

• Имеется ошибка, из-за которой компании не могут отправлять сообщения клиенту, если он первым начал переписку между двумя сторонами в WhatsApp, и это произошло более 7 дней назад.
• Имеется ошибка, из-за которой компании не могут получать исчезающие сообщения от клиентов.

Облачный API — 1 марта 2022 г.

Видеосообщения

С сегодняшнего дня пользователи бета-версии облачного API могут отправлять и получать видеосообщения. Дополнительные сведения:

• загрузка медиафайлов;
• поддерживаемые типы медиафайлов;
• сообщения, примеры, сообщения с медиафайлами;
• компоненты Webhooks.

1 февраля 2022 г.

Платформа WhatsApp Business

С сегодняшнего дня в WhatsApp на смену ценовой модели на основе уведомлений пришла ценовая модель на основе переписок. Счета компаниям выставляются по количеству переписок (одна переписка — это все сообщения, доставленные в течение 24-часового интервала). Подробнее см. в статье Плата за переписку.

Облачный API

Сообщения с местоположением и контактами

С сегодняшнего дня пользователи бета-версии облачного API могут отправлять и получать сообщения, содержащие местоположение и контакты. Дополнительные сведения:

• справка по сообщениям, местоположение и контакты;
• Webhooks, примеры: полученные сообщения.

Обновление пиковой пропускной способности

Внедрена поддержка пиковой пропускной способности в 80 сообщений в секунду на номер телефона. В это число входят входящие и исходящие сообщения, а также текстовые сообщения, шаблоны и сообщения с медиафайлами.

Локальный API (2.39.1)

Начиная с сегодняшнего дня разработчики могут использовать версию 2.39.1 нашего клиента WhatsApp Business API. В новом клиенте реализованы следующие функции и возможности:

• новое поле для Set Shards API;
• в требования к сети добавлено новое имя хоста;
• новый код ошибки 1031;
• упразднены тип hsm и настройка приложения webhook_payload_conversation_pricingmodel_disabled.

Set Shards API

Начиная с новой версии клиента API вы можете представить сертификат своего телефона при настройке множественного подключения. Это означает, что при вызове конечной точки /v1/account/shards в поле сертификата (cert) можно добавить сертификат в кодировке Base64. Дополнительные сведения см. в статье о масштабировании клиента API с помощью распределения нагрузки.

Новое имя хоста

Мы добавили graph.whatsapp.com в список имен хостов серверов WhatsApp, к которым клиенту Business API необходим доступ. Сведения см. в статье о настройке и отладке сети, раздел "Имена хостов".

Обновления кодов ошибок

В версии v2.39 мы добавили код ошибки 1031. Эта ошибка возникает, если ваш аккаунт заблокирован из-за нарушения политики надлежащего поведения и вы больше не можете отправлять сообщения. Дополнительные сведения см. в статьях о сообщениях об ошибках и кодах статусов и о применении политик.

Упразднения

• Messages API: тип hsm упразднен в версии v2.39. Вместо него следует использовать тип template.
• Настройка приложения: упразднена настройка приложения webhook_payload_conversation_pricingmodel_disabled.

Известные проблемы

При определенных условиях не отправляются некоторые видеосообщения.