Обзор платформы Messenger

В обзоре платформы Messenger описано, как работает эта платформа и какие компоненты необходимы для ее успешного внедрения.

Messenger from Meta — это служба обмена сообщениями, с помощью которой Страницы Facebook и профессиональные аккаунты Instagram, принадлежащие компаниям, могут отвечать заинтересованным людям. Переписки между пользователем и вашим аккаунтом должен начинать пользователь.

Вы можете пользоваться платформой Messenger бесплатно.

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

Человек, вошедший в Facebook или Instagram, отправляет сообщение Странице вашей компании или профессиональному аккаунту Instagram через платформу или через плагин Meta, когда использует ваше мобильное приложение или сайт. Страница компании или профессиональный аккаунт Instagram могут обработать сообщение через платформу Messenger: отправить автоматический ответ, подключить агента, который ответит человеку, либо использовать автоматизацию и агента одновременно.

Процесс обмена сообщениями

Когда человек отправляет сообщение Странице компании или профессиональному аккаунту Instagram, активируется Webhooks, который отправляет уведомление о том, что Страница или профессиональный аккаунт Instagram получили сообщение. Затем ваше приложение может выполнять вызовы к социальному графу Meta, чтобы получить переписку, определить подходящий ответ и отправить его человеку в течение 24 часов. Платформа позволяет масштабировать этот процесс, а также предоставляет целый ряд точек входа в переписку и типов сообщений.

Ограничения

• Человек, вошедший на Facebook, не может отправлять сообщения вашему профессиональному аккаунту Instagram, а человек, вошедший в Instagram, не может отправлять сообщения Странице Facebook компании или Странице Facebook, связанной с профессиональным аккаунтом Instagram, через платформу Messenger.
• Обмен сообщениями в Instagram доступен для всех профессиональных аккаунтов Instagram, принадлежащих компаниям и авторам.

Требования

Чтобы успешно внедрить платформу Messenger, вам необходимо понимать работу следующих компонентов.

Маркеры доступа

Маркер доступа — это строка с непрозрачной структурой, которая идентифицирует приложение, Страницу Facebook или пользователя. Приложение может использовать ее для безопасных вызовов социального графа Meta. Маркер доступа предоставляет временный защищенный доступ к конкретным конечным точкам, которые позволяют Странице компании или профессиональному аккаунту Instagram отправлять и получать сообщения от пользователей. Подробнее

Расширенный и стандартный доступ

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

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

Проверка приложения

Если вашему приложению требуется расширенный доступ, чтобы получать данные пользователей, у которых нет роли в приложении, на Странице компании или в профессиональном аккаунте Instagram, с которым связано приложение, оно должно пройти проверку. Подробнее

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

Подтверждение компании

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

URL сети распространения контента

Платформа Messenger использует URL-адреса сети распространения контента (CDN), которые позволяют отображать разнообразный мультимедийный контент, которым делятся пользователи. URL сети распространения контента учитывает требования конфиденциальности и не возвращает медиафайлы после удаления контента или истечения срока его действия.

Вход через Facebook

Чтобы отправлять сообщения со Страницы или из профессионального аккаунта Instagram, вы должны запросить разрешение пользователя. Чтобы запрашивать разрешения, вам понадобится реализовать вход через Facebook. Подробнее

Страница Facebook

Чтобы отправлять и получать сообщения на платформе Messenger, требуется Страница Facebook. Подробнее

Функции

Протокол передачи

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

Большое количество сообщений

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

Обмен сообщениями в Messenger

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

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

Обмен сообщениями в Instagram

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

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

• Ваше сообщение может доставляться с задержкой. Доставка вашего сообщения может занять больше времени, чем обычно, поскольку аккаунт [your-account-name] получает большое количество сообщений.

• Ваше сообщение не доставлено. Сообщение не доставлено, поскольку аккаунт [your-account-name] получает много сообщений. Повторите попытку позже.

Профессиональный аккаунт Instagram

Чтобы отправлять и получать сообщения в Instagram, у вас должен быть профессиональный аккаунт Instagram. Благодаря этому у вашего приложения будет доступ к данным конечных точек социального графа Meta через Страницу Facebook, связанную с вашим аккаунтом. Подробнее

Идентификаторы с областью действия Instagram

Когда человек отправляет сообщение профессиональному аккаунту Instagram, создается идентификатор с областью действия Instagram, который обозначает этого человека в приложении. Этот ID уникален для каждого человека и аккаунта Instagram, с которым он взаимодействует. Так профессиональный аккаунт Instagram может сопоставлять взаимодействия с одним и тем же человеком в разных приложениях для обмена сообщениями.

Регистрация в Meta

Чтобы выполнять вызовы к социальному графу Meta, вы должны зарегистрироваться как разработчик и зарегистрировать свое приложение в Meta. Подробнее

ID пользователей внутри Страницы

Когда человек отправляет сообщение Странице Facebook, создается ID пользователя внутри Страницы, который обозначает этого человека на Странице. Этот ID уникален для каждого человека и Страницы, с которой он взаимодействует. Так Страница может сопоставлять взаимодействия с одним и тем же человеком в разных приложениях для обмена сообщениями.

Задачи на Странице

Человек, запрашивающий маркер доступа к Странице, должен иметь возможность выполнять задачу MESSAGING для отправки сообщений и задачу MODERATE для ответа на комментарии на Странице Facebook, связанной с вашим приложением для обмена сообщениями. Подробнее

Каталог партнеров

Вы можете найти партнера, специализирующегося на платформе Messenger, в нашем каталоге партнеров Meta .

Разрешения

Для переписок в Messenger ваше приложение должно запросить через вход через Facebook следующие разрешения:

• pages_show_list
• pages_manage_metadata
• pages_messaging
• pages_read_engagement
• business_management

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

• instagram_basic
• instagram_manage_messages

Запрос разрешения business_management

Запрашивая разрешение business_management, вызовите следующее в своей заявке на проверку приложения:

1. Это разрешение запрашивается как зависимость для разрешений pages_messaging и pages_show_list.
2. Для обмена сообщениями в Instagram в вызове укажите, что это разрешение запрашивается как зависимость для разрешения instagram_manage_messages.
3. На скринкасте проверки приложения четко покажите, как администратор Страницы выполняет процесс входа через Facebook, выбирает страницы или дескрипторы Instagram и предоставляет необходимые разрешения приложению.

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

Правила

Чтобы получить и сохранять доступ к социальному графу Meta, вы должны соблюдать Политики платформы Messenger, Условия использования и политики платформы Meta, а также Нормы сообщества. Подробнее

Правила для ботов

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

Ограничение числа обращений

Webhooks

Webhooks Meta — это уведомления в режиме реального времени, которые позволяют получить информацию о сообщениях, отправляемых вашей Странице компании или профессиональному аккаунту Instagram, без необходимости вызывать социальный граф Meta (это может привести к ограничению числа обращений). Чтобы избежать ограничения числа обращений и получать уведомления о сообщениях, отправленных вашей Странице компании или профессиональному аккаунту Instagram, необходимо настроить Webhooks.

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

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

Статьи по теме

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