Этот документ представляет собой журнал изменений в платформе WhatsApp Business.
Облачный API
Business Management API
Облачный API
Облачный API
Облачный API, локальный API
Облачный API
biz_opaque_callback_data
увеличено с 256 до 512.Business Management API
cta_url_link_tracking_opted_out
, позволяющее включать и отключать отслеживание нажатия кнопок.UTILITY
.Business Management API
Облачный API
health_status
для проверки статуса работоспособности сообщений.biz_opaque_callback_data
в сообщения в свободной форме для добавления произвольных строк в Webhooks объекта messages.Business Management API
Business Management API, облачный API, локальный API
Flows
Облачный API
data_localization_region
для включения локального хранилища.Business Management API, облачный API, локальный API
code_expiration_minutes
(а не значение по умолчанию, равное 10 минутам). Это позволяет определить, какая кнопка должна отображаться в доставленном сообщении с шаблоном: кнопка автоматического заполнения или кнопка копирования кода.code_expiration_minutes
. Если оно не указано, будет действовать значение по умолчанию: 10 минут.Облачный API
limited_time_offer
.Облачный API
referral
в messages webhooks добавлено свойство ctwa_clid
. В нем указывается ID клика, который генерируется, когда пользователь нажимает рекламу с переходом WhatsApp, чтобы отправить сообщение.Облачный API, локальный API
Business Management API
add_security_recommendation
и code_expiration_minutes
в значении параметра component
.200
, если пользователю, идентифицируемому маркером, не был предоставлен надлежащий доступ к аккаунту WhatsApp Business.Облачный API
Облачный API, локальный API
Облачный API, локальный API
Инструменты
Business Management API
Регистрация на сайте поставщика
Business Management API
VERIFIED
теперь присваивается на 28 дней (а не через 14).Облачный API
Business Management
Инструменты
Business Management
2494100
Business Management API. Он означает, что номер телефона компании временно находится в режиме обслуживания.Облачный API
Инструменты
Облачный API
132015
, а не 132001
.132016
, а не 132001
.Локальный API
2061
.2062
.Business Management API
Облачный API
Локальный API
Business Management API
account_alerts
webhooks добавлены новые Webhooks для уведомления об отказе в повышении ограничения на числа сообщений.AUTHENTICATION
, MARKETING
или UTILITY
.Business Management API
hsm_id
в конечную точку DELETE Аккаунт WhatsApp Business > Шаблоны сообщений. В случае добавления это поле удаляет один шаблон, которые соответствует предоставленному ID (вместо удаления всех шаблонов, которые соответствуют предоставленному имени).Облачный API
last_onboarded_time
. Указывает, когда пользователь создал номер телефона компании в своем аккаунте WhatsApp Business, выполнив процедуру регистрации на сайте поставщика.Облачный API
Регистрация на сайте поставщика
Business Management API, облачный API, локальный API
allow_category_change
в конечную точку POST Аккаунт WhatsApp Business > Шаблоны сообщений.previous_category
в шаблоны сообщений WhatsApp.Business Management API
template_category_update
. Если вы подписаны на это поле, то при каждом изменении категории шаблона вы будете получать Webhooks с указанием предыдущей и новой категории.Облачный API
Локальный API
Облачный API, локальный API
Business Management API
Облачный API, локальный API
Business Management API, облачный API
Облачный API
AUTHENTICATION
MARKETING
UTILITY
code
и details
."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
.Облачный API
Неподтвержденные компании могут начинать до 250 переписок в течение 24-часового периода.
Относится ко всем версиям облачного API.
Для конечной точки Media добавлено необязательное поле phone_number_id
. Если вы зададите этот параметр и укажете ID номера телефона компании, операция будет обрабатываться только в том случае, если ID номера телефона совпадает с ID номера, для которого был загружен медиафайл.
HTTP-кэширование медиафайлов для облачного API теперь доступно для всех разработчиков.
Теперь облачный API будет продолжать попытки доставить уведомления Webhooks в течение 7 дней, а не 30. См. раздел об ошибках при доставке Webhooks.
Относится ко всем версиям.
template_performance_metrics
. Предоставляет еженедельные уведомления о метриках эффективности шаблонов, в том числе о количестве отправленных и открытых сообщений, а также об основных причинах блокирования.Относится ко всем версиям.
Новое поле 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:
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
.
Теперь облачный API по запросу поддерживает до 500 (ранее 350) текстовых сообщений и сообщений с медиафайлами в секунду (вместе взятых). Подробности см. в разделе Пропускная способность.
Если вы уже отправляете и получаете 350 сообщений в секунду, это ограничение автоматически повысится до 500. Если вы уже запросили пропускную способность в 350 сообщений в секунду, но процесс ещё не завершен, по его завершении вам будет предоставлена пропускная способность в 500 сообщений в секунду.
Мы проводим бета-тестирование HTTP-кэширования медиафайлов в облачном API. Партнерам по решениям необходимо ознакомиться с разделом, посвященным HTTP-кэшированию медиафайлов. В нем содержится информация о том, как использовать заголовки в ответах сервера, чтобы мы кэшировали медиафайлы для повторного использования в будущих сообщениях.
Облачный API теперь поддерживает подписи-комментарии к документам, которыми вы обмениваетесь с клиентами. См. раздел Объект медиаданных в справке по медиафайлам.
Теперь аккаунты WhatsApp Business могут иметь до 6 000 шаблонов сообщений, если их родительская компания подтверждена и по крайней мере у одного из аккаунтов WhatsApp Business родительской компании есть номер телефона с одобренным отображаемым именем.
Версии шаблонов сообщений, переведенные на другие языки, учитываются в общем количестве доступных шаблонов сообщений аккаунта WhatsApp Business.
Компании из Индии теперь могут использовать кредитные карты для оплаты отправленных через платформу сообщений. См. статью Добавление кредитной карты в аккаунт на платформе WhatsApp Business.
Теперь номер телефона компании можно переносить между аккаунтами WhatsApp Business через облачный API. См. статью Перенос номера телефона в другой аккаунт WhatsApp Business.
Только для облачного API.
Теперь для каждого аккаунта WhatsApp Business можно использовать отдельные URL обратных вызовов. Создавать отдельные приложения для каждого аккаунта не требуется. Подробнее см. в статье Переопределение URL обратного вызова.
Все конечные точки облачного API теперь поддерживают вызовы версии 15.
Только для облачного API.
Параметры текста (components.parameters.text
) для шаблонов сообщений, которые используют только компонент body (components.type:body
), теперь могут иметь длину до 32 768 символов. См. раздел Объект параметров.
Только для облачного API.
Теперь облачный API по запросу поддерживает до 350 (ранее 250) текстовых сообщений и сообщений с медиафайлами в секунду (вместе взятых). Подробности см. в разделе Пропускная способность.
Если вы уже отправляете и получаете 250 сообщений в секунду, это ограничение автоматически повысится до 350. Если вы уже запросили пропускную способность в 250 сообщений в секунду, но процесс ещё не завершен, по его завершении вам будет предоставлена пропускная способность в 350 сообщений в секунду.
Реализована поддержка реакций. Информацию о том, как отправлять и получать реакции, см. в разделе Отправка сообщений — сообщения с реакциями. Примеры полезной нагрузки уведомлений Webhooks см. в разделе Примеры полезной нагрузки — сообщения с реакциями.
Для профилей компании теперь поддерживается поле about
. Подробнее см. в статье Профили компании.
Вышла новая документация по запросу перехода с пропускной способности в 80 сообщений в секунду на 250 сообщений в секунду (вместе взятых отправленных и полученных текстовых сообщений или сообщений с медиафайлами). См. статью Пропускная способность.
Теперь вы можете добавлять анимированные стикеры в исходящие начатые компанией сообщения и получать Webhooks сообщений с их описанием точно так же, как при отправке сообщений со стикерами без анимации. См. информацию о свойстве sticker
объекта Сообщение и требования к использованию объекта анимированных стикеров.
Теперь вы можете добавлять товары и услуги в сообщения, отправляемые клиентам, а они могут добавлять их в корзину, не выходя из чата. Информацию о том, как отправлять клиентам сообщения с одним или несколькими товарами, см. в руководстве по продаже товаров и услуг.
Теперь компании могут отвечать на любые сообщения в переписке. Ответ будет содержать сообщение, на которое компания отвечает. Информацию о том, как отвечать на сообщение, см. в руководстве по отправке сообщений.
Теперь облачный API по запросу поддерживает до 250 вместе взятых отправленных и полученных сообщений в секунду (в том числе текстовых сообщений и сообщений с медиафайлами). Корпоративные партнеры могут обратиться в прямую поддержку и запросить пропускную способность 250 сообщений в секунду. Для этого выберите тему запроса "Cloud API Issues", тип запроса "Request to migrate to 250 MPS throughput" и введите необходимую информацию.
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
.
v2.41.3
)2.41.3
В версии v2.41.3
клиента Business API добавлен новый индекс таблицы для message_receipt_log
. Он будет полезен партнерам, которым требуется высокая пропускная способность. В частности, благодаря этому обновлению партнеры могут отправлять более 200 сообщений в секунду.
v2.41.2
)В версии 2.41.2 внедрены изменения схемы базы данных, что повышает производительность системы. Из-за этого на обновление с версий 2.37.2 и 2.39.x с большими базами данных, в которых содержатся миллионы сообщений и контактных данных, потребуется больше времени, чем обычно.
Рекомендуем выполнять обновления в периоды с наименьшим количеством трафика, и обновлять сначала конфигурации с меньшей пропускной способностью.
Для больших баз данных выполните следующие действия:
До начала обновления запустите сбор мусора через конечную точку /services/message/gc и дождитесь его завершения.
До начала обновления обновите схемы баз данных с помощью инструмента dbupgrade. После этого вы сможете обновить версию API с минимальными задержками. Перед использованием инструмента dbupgrade настоятельно рекомендуется остановить работу клиента API. Убедитесь, что инструмент завершил операцию (код выхода 0). Ограничьте или полностью запретите отправку запросов API на период обновления.
Рекомендуем увеличить время ожидания для запросов на серверах базы данных до одного часа (до тех пор, пока обновление не будет завершено).
Эта версия клиента содержит перечисленные далее функции и обновления.
delivered
и read
. Это можно сделать с помощью конечной точки settings/applications.namespace
.С сегодняшнего дня облачный API WhatsApp Business открыт для всех разработчиков, работающих над созданием продуктов и услуг для себя или организаций. Чтобы начать работу, ознакомьтесь с нашим руководством. Если вы хотите предлагать доступ к API своим клиентам, запишитесь в список ожидания.
Для параметра category
конечной точки /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template
в версии v14.0
и более поздних упразднены следующие значения:
|
|
|
Следующие значения добавлены:
TRANSACTIONAL
;MARKETING
.Эта версия клиента содержит все функции и исправления, входящие в версию v2.39.1
. Кроме того, в этом выпуске:
v2.39.2
.v2.39.3
.v2.39.4
компании будут проинформированы о получении исчезающего сообщения посредством уведомлений Webhooks, тип которых указан как "ephemeral"
. Компании не смогут просматривать контент сообщения.После запуска v2.39.3
проблема с исчезающими сообщениями автоматически обрабатывалась приложением WhatsApp, которое отключало эти сообщения в чате с клиентом. Для версии v2.39.4
мы не будем этого делать. В этой версии компании, которые получают исчезающие сообщения, должны попросить клиента отключить такие сообщения и повторно отправить свое последнее сообщение.
2.3.8
С сегодняшнего дня в облачный API внесены следующие обновления:
2.3.7
С сегодняшнего дня облачный API доступен всем существующим партнерам по решениям и их прямым клиентам. Кроме того, мы выпускаем следующие функции для разработчиков, работающих с облачным API:
POST
к PHONE_NUMBER_ID/deregister
для удаления номера телефона из WhatsApp Business API. Дополнительную информацию см. в документации по регистрации.referral
Webhooks облачного API отличается от объекта referral
локального API.Кроме того, мы объявляем, что проверка приложения для разработчиков, использующих облачный API для разработки в личных целях, больше не требуется. Ограничения на сообщения на платформе WhatsApp Business распространяются на всех разработчиков.
В этой версии представлены все те же функции, что и в версии 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"]
С сегодняшнего дня разработчикам доступна версия v2.39.3
нашего клиента WhatsApp Business API. Новый клиент содержит два исправления и дополнительные журналы для поддержки отладки. Реализованы следующие два изменения:
С сегодняшнего дня пользователи бета-версии облачного API могут отправлять сообщения со списками и кнопками ответа. Дополнительные сведения:
С сегодняшнего дня пользователи бета-версии облачного API могут добавлять в текстовые сообщения, содержащие URL, поле его предпросмотра. Дополнительные сведения:
Мы только что выпустили локальный API v2.39.2
. В этой версии исправлена ошибка, из-за которой в некоторых случаях не отправлялись видеосообщения.
С сегодняшнего дня пользователи бета-версии облачного API могут отправлять и получать видеосообщения. Дополнительные сведения:
С сегодняшнего дня в WhatsApp на смену ценовой модели на основе уведомлений пришла ценовая модель на основе переписок. Счета компаниям выставляются по количеству переписок (одна переписка — это все сообщения, доставленные в течение 24-часового интервала). Подробнее см. в статье Плата за переписку.
С сегодняшнего дня пользователи бета-версии облачного API могут отправлять и получать сообщения, содержащие местоположение и контакты. Дополнительные сведения:
Внедрена поддержка пиковой пропускной способности в 80 сообщений в секунду на номер телефона. В это число входят входящие и исходящие сообщения, а также текстовые сообщения, шаблоны и сообщения с медиафайлами.
2.39.1
)Начиная с сегодняшнего дня разработчики могут использовать версию 2.39.1
нашего клиента WhatsApp Business API. В новом клиенте реализованы следующие функции и возможности:
Начиная с новой версии клиента API вы можете представить сертификат своего телефона при настройке множественного подключения. Это означает, что при вызове конечной точки /v1/account/shards в поле сертификата (cert) можно добавить сертификат в кодировке Base64. Дополнительные сведения см. в статье о масштабировании клиента API с помощью распределения нагрузки.
Мы добавили graph.whatsapp.com
в список имен хостов серверов WhatsApp, к которым клиенту Business API необходим доступ. Сведения см. в статье о настройке и отладке сети, раздел "Имена хостов".
В версии v2.39
мы добавили код ошибки 1031
. Эта ошибка возникает, если ваш аккаунт заблокирован из-за нарушения политики надлежащего поведения и вы больше не можете отправлять сообщения. Дополнительные сведения см. в статьях о сообщениях об ошибках и кодах статусов и о применении политик.
hsm
упразднен в версии v2.39
. Вместо него следует использовать тип template
.webhook_payload_conversation_pricingmodel_disabled
.При определенных условиях не отправляются некоторые видеосообщения.