Этот документ содержит журнал изменений текущих версий платформы Messenger. На платформе Messenger поддерживается управление версиями Graph API.
Последняя версия: v21.0
response_feedback
.Новое событие Webhooks response_feedback
уведомляет вас о том, что пользователь оставил отзыв на отправленное вами сообщение, нажав одну из кнопок "Большой палец вверх", "Большой палец вниз", "Хороший ответ", "Плохой ответ". Подробнее об этом Webhooks см. в этой статье.
Если сообщение содержит текст, ссылки, реакции или стикеры, приложение может выполнять 300 вызовов (до 100) в секунду для каждого профессионального аккаунта Instagram. Подробнее…
Компоненты этого нового Instagram API:
graph.instagram.com
;instagram_business_basic
;instagram_business_content_publishing
;instagram_business_manage_comments
;instagram_business_manage_messages
.Информацию об изменениях, в том числе об исправлении ошибок и новых функциях, см. в журнале изменений платформы Instagram.
Теперь для Webhooks сообщений поддерживается тип вложения ig_reel
. Вложения Instagram Reels будут иметь тип ig_reel
. Их полезные данные будут содержать заголовок, URL и ID видео Reels.
Теперь для Webhooks сообщений поддерживаются типы вложений ig_reel
и reel
. Вложения Instagram Reels будут иметь тип ig_reel
. Их полезные данные будут содержать заголовок, URL и ID видео Reels. Вложения Facebook Reels будут иметь тип reel
. Их полезные данные будут содержать заголовок, URL и ID видео Reels.
Компании, использующие маршрутизацию переписок в Messenger, теперь могут настраивать возможность управления потоками на уровне отдельных приложений. Исходная конфигурация, связанная с приложением по умолчанию, упразднена, а все значения перенесены. Подробнее см. в этом разделе.
Относится ко всем версиям.
Если кто-либо прокомментировал продвигаемую или рекламную публикацию в Instagram, в дополнение к параметрам ad_id
и ad_title
в объекте media
объекта value
поля comments
будет возвращаться параметр original_media_id
. Подробнее см. в статье Настройка Webhooks для Instagram.
message_edits
Новое событие Webhooks message_edits
уведомляет вас о том, что пользователь отредактировал ранее отправленное сообщение. Подробнее об этом событии Webhooks см. в этой статье.
Процессы приветственных сообщений для рекламы с переходом в переписку теперь можно настраивать с помощью Marketing API. Подробнее о рекламе с переходом в Messenger см. в этой статье, а о рекламе с переходом в Instagram — в этой.
Теперь Webhooks сообщений для переписок в Messenger поддерживают тип вложения "Видео Reels". Вложения Reels будут категоризироваться как тип reel
. Их полезные данные будут включать заголовок, URL и ID видео Reels.
Команды — это ключевые слова, которые пользователь может нажимать, чтобы выполнить определенные действия в Messenger. Команды состоят из собственно команды и подсказки, которая сообщает пользователям о том, что делает эта команда. Например, если пользователь пишет "помоги мне забронировать перелеты и отели в Мексику в последнюю неделю декабря", он вызывает команды "перелеты" и "отели", настроенные компанией, организующей путешествия. Подробнее см. в этой статье.
Мы представляем новое меню команд, которое будет отображаться автоматически, если у вас настроены команды. Если у вас в Messenger уже настроено постоянное меню, оно будет заменено меню команд. Подробнее см. в этом разделе.
Теперь люди могут делиться вашими сообщениями со страницы профиля компании в Messenger. Это поможет привлечь дополнительное внимание к вашему Messenger. Подробнее см. в этом разделе.
Когда вы настроите команды в Messenger, они будут отображаться в профиле компании. Люди смогут перейти в профиль компании, нажав имя страницы вверху и ознакомиться с командами, которые вы предлагаете в своем Messenger.
На экране приветствия отображается список команд, поддерживаемых при переписке, так что люди легко поймут, какие действия они могут выполнить в Messenger. Подробнее см. в этом разделе.
Если вы разрабатываете приложение для обмена сообщениями для своей собственной страницы, проходить проверку этого приложения не нужно. Обратите внимание: если вы планируете получать информацию из профиля пользователя, вам всё равно нужно будет пройти проверку приложения, чтобы получить разрешения для доступа к User Profile API.
Маршрутизация переписок стала доступна в Instagram. Маршрутизация переписок позволяет Meta направлять переписки между вашей компанией и текущими либо потенциальными клиентами в приложения, которые вы определили для ответа в переписке. Благодаря такой маршрутизации ваша компания может более эффективно переписываться с людьми и сократить количество вызовов API к серверам Meta.
Восстановлен доступ к Custom Labels и Personas API для компаний, работающих в Европе, и для людей в Европе и Японии, которые подключаются к компаниям по всему миру.
Теперь компании и агентства могут легко связать свои рекламные объявления с переходом в Messenger и в Instagram Direct с приветственным сообщением, созданным в партнерском приложении, не используя фрагменты кода JSON. Приветственное сообщение появится в раскрывающемся списке в менеджере рекламных объявлений при создании рекламы с переходом в Messenger и с переходом в Instagram Direct. Подробнее см. в этой статье.
На комментарии к видео Reels на Facebook теперь можно отвечать в личных сообщениях.
Обновлены ответы в личных сообщениях для групп. В Webhooks group_feed
добавлены новые поля from
для информации о комментирующем пользователе и parent_id
для информации о родительском контексте. Для обработки этих новых полей вам, возможно, потребуется обновить сервер Webhooks.
Ваша компания может использовать несколько сторонних сервисов, чтобы вести с клиентами разные переписки, например для генерации лидов, рассылки маркетинговых предложений о продуктах или оказания поддержки. Маршрутизация переписок позволяет определить сторонние сервисы, которые будут управлять переписками с клиентами в конкретное время, чтобы клиенты получали нужную им информацию. Создавать правила маршрутизации сообщений и управлять ими можно в настройках Страницы.
Шаблон с кнопками отправляет текстовое сообщение, к которому можно прикрепить до трех кнопок. Этот шаблон будет полезен, чтобы предлагать получателям различные варианты на выбор, например заранее определенные ответы на вопросы или какие-либо действия. Поддерживаются кнопки типа postback
и web_url
.
Ваша компания может использовать несколько сторонних сервисов, чтобы вести с клиентами разные переписки, например для генерации лидов, рассылки маркетинговых предложений о продуктах или оказания поддержки. Маршрутизация переписок позволяет определить сторонние сервисы, которые будут управлять переписками с клиентами в конкретное время, чтобы клиенты получали нужную им информацию. Создавать правила маршрутизации сообщений и управлять ими можно в настройках Страницы.
Шаблон с кнопками отправляет текстовое сообщение, к которому можно прикрепить до трех кнопок. Этот шаблон будет полезен, чтобы предлагать получателям различные варианты на выбор, например заранее определенные ответы на вопросы или какие-либо действия. Поддерживаются кнопки типа postback
и web_url
.
Обмен сообщениями в Instagram теперь доступен для всех профессиональных аккаунтов Instagram, принадлежащих компаниям или авторам.
Теперь вы можете добавить подсказку "Позвонить", чтобы клиенты или люди, которые заинтересовались вашей компанией, могли позвонить в вашу компанию.
Вы можете создавать рекламу с переходом к подписке, которая позволяет спросить клиентов или людей, которые заинтересовались вашей компанией, хотят ли они подписаться на маркетинговые сообщения от вас.
Маршрутизация в нескольких приложениях теперь доступна в Instagram Direct и Messenger.
Ответы в личных сообщениях
Ваша компания может отправлять ответы в личных сообщениях пользователям, оставившим комментарий к публикации в группе на Facebook.
Регулярные уведомления
Регулярные уведомления теперь называются маркетинговыми сообщениями.
Шаблоны
Для сбора информации о доставке от клиента теперь доступны структурированные шаблоны.
Регулярные уведомления для платформы Messenger
Свойство title
больше не требуется для запросов согласия на рассылку регулярных уведомлений. Если свойство title
не задано, по умолчанию устанавливается значение "Новости и промоакции". Это изменение действует для запросов согласия, отправленных со Страницы Facebook или от профессионального аккаунта Instagram.
Регулярные уведомления для платформы Messenger
Свойство notification_messages_frequency
для запросов согласия на получение регулярных уведомлений больше не поддерживается и не возвращается в запросах GET
и уведомлениях Webhooks. Однако маркеры сообщений с уведомлениями, созданные до 2 февраля 2023 г., для еженедельных или ежемесячных уведомлений по-прежнему поддерживаются, и свойство notification_message_frequency
в уведомлениях Webhooks возвращается.
Человеку, который дал согласие на получение регулярных уведомлений, можно отправить до трех последующих сообщений. Все три сообщения должны быть отправлены в течение двух минут после первого.
Конечная точка GET /PAGE-ID/notification_message_tokens
теперь доступна для обмена сообщениями в Instagram.
Также стало доступно свойство next_eligible_time
для конечных точек маркеров сообщений с уведомлением. Это поле возвращает время, когда можно отправить следующее регулярное уведомление с использованием маркера сообщения с уведомлением.
Messenger API for Instagram
Теперь с помощью Messenger API for Instagram в сообщениях, отправляемых из профессионального аккаунта Instagram, можно отправлять файлы .gif.
Attachment Upload API теперь поддерживает загрузку медиафайлов для сообщений, отправляемых из профессионального аккаунта Instagram.
Информация реферала для объявлений с переходом к переписке в Instagram (CTD) теперь возвращается в уведомлениях Webhooks сообщений.
С 31 марта 2023 года вы более не сможете загружать файл CVS с панели Аналитики Messenger. Чтобы узнать, как получить эту статистику, перейдите на страницу Page Messaging Insights API.
Вход в Instagram от имени компании упрощает вам подключение пользователей Instagram, которым всё ещё необходимо настроить свой аккаунт для доступа API с помощью модальных всплывающих окон и меньшего количества шагов.
Мы упростили следующие параметры рекламы для генерации лидов с переходом в Messenger, внедрив:
Events API для обмена сообщениями поддерживает событие lead_submitted
. Компании могут использовать это событие, чтобы сообщить об отправке лидов из рекламы с переходом в Messenger. Это новое событие обмена сообщениями выпущено как открытая бета-версия. Отчетность в Ads Manager будет реализована в ближайшее время.
Постоянное меню теперь доступно для обмена сообщениями в Instagram.
Функция обмена сообщениями в Instagram теперь поддерживает ответы в личных сообщениях для комментариев в публикациях, размещенных относительно историй и прямых эфиров в Instagram и рекламных объявлений. Для обработки этих новых полей вам, возможно, потребуется обновить сервер Webhooks.
Теперь вы можете получить список всех действительных маркеров сообщений с уведомлением с помощью конечной точки GET /PAGE-ID/notification_message_tokens
.
ID приложений больше не связаны с маркерами сообщений с уведомлением. Все приложения, связанные со Страницей, теперь будут получать уведомление Webhooks, когда пользователь дает согласие на получение регулярных уведомлений.
Добавлены следующие поля полезных данных для вложений в сообщения:
image_aspect_ratio
— выбор горизонтального или квадратного соотношения сторон изображения для запросов на согласие;elements
— создание кольцевой галереи изображений для запроса на согласие;notification_message_tokens
— получение списка текущих маркеров сообщений с уведомлением; notification_messages_cta_text
— настройка текста для призыва к действию в запросах на согласие.Добавлены следующие способы отправки запроса согласия на получение регулярных уведомлений:
В регулярные уведомления Webhooks добавлено поле title
.
На комментарии к видео Reels в Instagram теперь можно отвечать в личных сообщениях.
Теперь в Instagram можно отправлять сообщения с аудио или видео, которые вы загрузили на сервер Meta или которые находятся на вашем сервере.
User Profile API теперь поддерживает получение поля имени пользователя в Instagram через Graph API версии 14.0 и более поздних.
Регулярные уведомления — это новая важная функция Messenger API, которая позволяет компаниям отправлять актуальные автоматизированные сообщения, чтобы повторно вовлекать клиентов. Благодаря регулярным уведомлениям компании предоставляют клиентам персонализированные и полезные сообщения на каждом этапе их пути.
Регулярные уведомления для Messenger API for InstagramОбъявляем о внедрении бета-версии регулярных уведомлений для Messenger API for Instagram. Разработчики могут записаться в список потенциальных участников бета-тестирования до июля.
Повышение ограничения числа обращений Instagram Send APIМы повысили ограничение числа обращений для Send API до 100 вызовов API в секунду для каждого профессионального аккаунта Instagram.
Параметр перенаправления ig.meКомпании могут указывать ссылки ig.me на сайтах, в электронных письмах и на упаковке товара, чтобы предоставить клиентам возможность легко начать переписку с компанией в Instagram. Теперь мы добавили возможность указать параметр перенаправления для этих ссылок, чтобы персонализировать переписку.
Новый процесс подключения для Instagram APIМы представляем бета-версию нового процесса подключения для Instagram API. Разработчики могут записаться в список потенциальных участников бета-тестирования до 29 июня.
Мы запустили постоянное меню для Messenger API for Instagram. С его помощью пользователи могут пользоваться основными функциями Страницы.
Согласно сообщению от 14 сентября 2021 г., все Страницы Facebook перейдут на поддержку нового протокола передачи. Планируется, что переход завершится к 18 марта 2022 г. Подробнее см. в разделе важных изменений. Ниже кратко описаны основные улучшения, о которых было объявлено ранее.
Мы усовершенствуем протокол передачи, который помогает разработчикам и компаниям быстрее создавать решения (приложения) для обмена сообщениями, позволяющие передавать контроль над беседой от одного приложения к другому и повышать удобство работы для пользователя за счет того, что посторонние приложения не будут вмешиваться в текущую беседу. К числу основных улучшений относятся эксклюзивный режим, неактивный режим, новые API для более гибкого управления правом владения перепиской и устранение требований по назначению приложениям основных и дополнительных ролей.
Мы добавили возможность настройки точки входа для плагина чата через API, а также запустили свой собственный инструмент настройки. Это позволит компаниям выбрать из набора предустановок значок и подпись точки входа, которые будут лучше всего соответствовать их бренду. Подробнее см. в документации для разработчиков.
Messenger API for Instagram теперь доступен для аккаунтов авторов Instagram, имеющих менее 500 тыс. подписчиков. Подробнее см. в документации для разработчиков.
https://ig.me/m/{ig_profile_handle}
на сайтах, в электронной почте и т. д. Подробнее см. в документации для разработчиков.Улучшения в протоколах передачи
Custom Labels API: мы вносим важные изменения в Custom Labels API, благодаря чему компании смогут создавать, обновлять и удалять метки, а также синхронизировать их между входящими на Странице Facebook и другими инструментами, с помощью которых они взаимодействуют с клиентами.
name
в Custom Labels API для Graph API версии v12.0
и более поздних будет заменено полем page_label_name
. Это изменение вступит в силу для всех предыдущих версий Graph API 14 декабря 2021 г. Разработчикам следует использовать поле page_label_name
в различных вызовах API и Webhooks CRUD (создание, получение, обновление, удаление).Обновление Messenger API для Европы и Японии. Мы восстановили в Messenger API шаблон отзыва клиента, который был недоступен компаниям в Европе, а также обычным пользователям из Европы и Японии, которые общаются с компаниями со всего мира. Подробнее см. в этой статье.
Изменения в Messenger API for Instagram
Webhooks реакций. Мы обновили реакции в виде смайликов: теперь данные возвращаются в новом формате Юникод и поддерживаются разные реакции в виде смайликов. Ознакомьтесь с документацией для разработчиков и перейдите на новую версию до 14 декабря 2021 г., чтобы сохранить поддержку реакций в виде смайликов.
User Profile API. Мы обновили User Profile API, добавив в него общедоступные поля приложения Instagram. Дополнительные сведения см. в документации для разработчиков.
Упразднение IGID. В Conversations API больше не поддерживается поле IGID
: теперь используется только поле IGSID
. Подробные сведения о том, как выполнить соответствующий переход до 14 декабря 2021 г., см. в документации для разработчиков.
API настройки плагина чата для Facebook. Мы добавляем возможность настраивать параметры плагина чата через API. В новом выпуске разработчики смогут менять такие параметры, как положение, цвет, приветствия, настройки гостевого режима и т. д., которые сейчас доступны только в наших собственных инструментах.
Webhooks эхо сообщений теперь содержит ID приложения для входящих Страницы Facebook в Graph API v12.0
. Когда компания отвечает в переписке Messenger из входящих Страницы Facebook, другие подключенные к этой Странице приложения могут отслеживать Webhooks с эхо сообщений. Такие приложения будут получать Webhooks эхо с ID приложения входящих Страницы Facebook (263902037430900
).
Эти изменения относятся к версии 11.0 и более поздним.
Добавление <mid>
в события messaging_postback
для Messenger и Messenger API for Instagram в Graph API версии 11.0 и более поздних. Мы добавляем ID сообщения (поле <mid>
) в полезные данные messaging_postback
, чтобы партнеры, которым приходилось использовать Conversations API для получения истории бесед и ее сравнения с событиями Webhooks, смогли упростить свой программный код. Более подробные сведения см. в этой статье.
Упразднены шаблоны для авиакомпаний: начиная с версии 11 Graph API шаблоны для авиакомпаний не поддерживаются. Их упразднение для предыдущих версий Graph API произойдет через 6 месяцев после объявления об этом изменении, т. е. 6 декабря 2021 г. Мы рекомендуем авиакомпаниям отправлять шаблоны посадочного талона и регистрации в виде изображений, как они обычно отправляются по другим каналам.
Messenger API for Instagram: мы сделали Messenger API for Instagram доступным для всех разработчиков, которые создают решения для автоматизированного обмена сообщениями в Instagram для компаний. Теперь разработчики могут добавлять средства обмена сообщениями через Instagram в свои приложения и использовать их в своих продуктах. Тем самым они получают возможность помочь компаниям задействовать различные приложения в рамках текущих рабочих процессов, повысить полезность бесед с клиентами и их удовлетворенность, а также увеличить продажи. Более подробные сведения см. в этом разделе. Использование Messenger API должно соответствовать правилам для разработчиков, в частности перечисленным в разделе "Messenger и Messaging API в Instagram", а также технической документации.
Всем разработчикам теперь доступна метка сообщений "Оператор": с ней компании могут отвечать на сообщения пользователей в Messenger и Instagram вручную за пределами стандартного 24-часового окна ответа в течение до 7 суток. Эта метка особенно полезна, например, если компания закрыта на выходные, а также для обращений, обработка которых требует более 24 часов. Разработчик должен подать заявку для получения разрешения на использование метки "Оператор" через панель приложений, даже если для приложения ранее уже было одобрено использование метки сообщений "Оператор". Для этого перейдите в раздел "Разрешения и функции" панели приложений и подайте заявку на разрешение "Оператор". Подробнее см. в этом разделе.
Шаблон обратной связи клиентовдоступен в рамках бета-тестирования: мы вводим нативный шаблон в Messenger для распространенных видов опросов, например CSAT (удовлетворенность клиентов), NPS (показатель лояльности клиентов), CES (индекс потребительских усилий) и текст в свободной форме. Нативный шаблон легче интегрировать, так как он основан на Send API, устраняет необходимость в создании собственных решений для проведения опросов с использованием функций веб-просмотра, а также упрощает разработчикам агрегацию показателей по разным каналам с использованием схожих форматов опросов. Подробнее см. в этом разделе.