Платформа Messenger

Обмен сообщениями в Instagram с помощью платформы Messenger

On July 23, 2024 we launched the new Instagram API with Instagram Login. An Instagram professional account – Business or Creator account – will no longer need to be linked to a Facebook Page in order to have conversations with customers, followers, or Instagram users interested in their business or Instagram account, manage comments, or publish media. Learn more about this new version in our blog post.

See our Instagram API with Instagram Login to learn more.

Платформа Messenger позволяет создавать масштабируемые решения для обмена сообщениями для профессиональных аккаунтов Instagram.

Обмен сообщениями Instagram доступен для следующих аккаунтов:

  • профессиональный аккаунт Instagram компании;
  • профессиональный аккаунт Instagram автора.

Проверить доступность для аккаунтов, которыми вы управляете, можно с помощью API Conversations . Если обмен сообщениями для ваших аккаунтов ещё не доступен, будет возвращен код ошибки 36103.

Стандартное использование

  • Получение сообщений из вашей папки "Входящие" профессионального аккаунта Instagram.
  • Получение и отправка текстовых сообщений, медиафайлов, историй и т. д.
  • Отправка ответа с использованием личных сообщений человеку, который разместил общедоступную публикацию в вашем Instagram.
  • Отправка ответа с использованием личных сообщений человеку, который опубликовал комментарий в вашем Instagram.

Принцип работы

Платформа Messenger позволяет обмениваться сообщениями с людьми, которые интересуются вашей компанией или материалами, автором которых вы являетесь. Страница Facebook, связанная с вашим профессиональным аккаунтом Instagram, упрощает такое общение с использованием платформы Messenger. Когда человек отправляет вам сообщение в Instagram, оно будет доставлено в ваш ящик "Входящие" в Instagram, а на ваш сервер будет отправлено уведомление Webhooks. Чтобы ответить на это сообщение, у вашего приложения для обмена сообщениями есть 24 часа . Если для предоставления ответа оператору требуется больше времени, вы можете добавить метку в свой ответ, чтобы сообщение было отправлено вне стандартного 24-часового окна отправки сообщений.

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

Входящие в Instagram

Профессиональный аккаунт Instagram имеет входящие сообщения, которые позволяют вам проверять уведомления и упорядочивать сообщения. По умолчанию уведомления отключены. Уведомления можно включить в настройках Входящих. Входящие устроены в разных категориях, Основные, Общие и Запросы. По умолчанию все новые переписки от подписчиков будут появляться в папке "Основные". Разговоры, которые были начаты до внедрения обмена сообщениями в Instagram, будут находиться в папках, в которые вы их поместили.

Сообщения, полученные от пользователей, которые на вас не подписаны, будут в папке "Запросы". Эти запросы можно принимать или отклонять. Пока вы этого не сделаете, они не будут помечаться как просмотренные. После принятия запроса можно переместить переписку в папку "Основные" или "Общие". Все сообщения с запросами, на которые вы ответили с помощью стороннего приложения, будут перемещены в папку "Общие".

Ограничения Входящих

  • Если вы отвечаете на сообщение с помощью стороннего приложения, переписка будет перемещена в папку Общие независимо от конфигурации настроек.
  • Папки "Входящие" не поддерживаются и сообщения, доставляемые платформой Messenger, не содержат информацию о папке, которая отображается в папке "Входящие" приложения Instagram from Meta.
  • Уведомления Webhooks или сообщения, доставленные через API, не будут считаться прочитанными во входящих сообщениях приложения Instagram. Сообщение будет считаться прочитанным только после отправки ответа.

Вход в Instagram от имени компании

С 9 ноября 2022 г. мы ввели вход в Instagram от имени компании. Этот процесс входа позволяет человеку преобразовать свой аккаунт Instagram в профессиональный аккаунт, создать Страницу Facebook своей компании и подключить Страницу к профессиональному аккаунту Instagram в процессе входа.

Требования

Это руководство подразумевает, что вы ознакомились с обзором платформы Messenger и реализовали необходимые компоненты для отправки и получения сообщений и уведомлений.

  • API Graph для Instagram — позволяет компаниям и авторам управлять своим присутствием в Instagram, используя ваше приложение
  • Следующие разрешения:
    • instagram_basic
    • instagram_manage_messages
    • pages_manage_metadata
    • pages_showlist
    • business_management
  • Удаление сообщений, когда вы получаете уведомление Webhooks о том, что это надо сделать

Использование автоматизации

Вы можете обеспечить способ взаимодействия для автоматической отправки сообщений, используя что-либо из перечисленного ниже.

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

Информирование пользователей об использовании автоматического чата

Когда этого требует действующее законодательство, при использовании автоматического чата для общения с человеком вы должны сообщить ему об этом:

  • в начале переписки или ветки сообщений;
  • по истечении значительного количества времени; или
  • когда вместо живого человека с человеком начинает общаться чат-бот.

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

  • потребители или пользователи из Калифорнии;
  • потребители или пользователи из Германии.

Вот возможные примеры уведомлений об обслуживании с помощью чат-бота: "Я бот Страницы [название Страницы]", "Добро пожаловать в автоматический чат", "Вы общаетесь с ботом" или "Я автоматический чат-бот".

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

Подробнее см. наши Правила для разработчиков.

Только с участием оператора

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

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

Ограничения

  • Профессиональный аккаунт Instagram может переписываться только с одним клиентом в рамках одной переписки. Групповая переписка не поддерживается.
  • Переписки в папке "Запросы", которые остаются неактивными в течение 30 дней, не будут возвращаться в вызовах API.
  • Когда клиент отправляет сообщение с публикацией, в уведомление Webhooks добавляется только URL для предоставляемого медиафайла или публикации.
  • Прежде чем профессиональный аккаунт автора сможет получать уведомления Webhooks, он должен отправить запрос через Conversions API для Instagram.

Ограничения проверки

  • Приложения со стандартным уровнем доступа могут взаимодействовать только с пользователями, у которых есть роль в этом приложении.
  • Некоторые функции могут не работать надлежащим образом, пока вашему приложению не будет предоставлен расширенный уровень доступа.
  • Люди, тестирующие ваше приложение, должны иметь роль для работы с ним, предоставлять доступ ко всем необходимым разрешениям и иметь роль в профессиональном аккаунте Instagram.

Дальнейшие действия

См. также