Плагин "Отправить в Messenger"

С 30 сентября 2024 г. эта функция станет недоступна. Вы сможете по-прежнему использовать такие функции, как ссылки m.me, выполняющие перенаправление на человека, страницу, в переписку или в Messenger.

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

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

При первом нажатии этой кнопки появится всплывающее окно с подтверждением.

Требования

Facebook SDK для JavaScript

Чтобы использовать плагин Messenger, добавьте Facebook SDK для JavaScript на страницу, где будет отображаться плагин.

Инструкции по добавлению SDK см. в этой статье.

Настройка

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

Полное описание доступных атрибутов см. в справке по плагину "Отправить в Messenger".

Подписка на события

Подписка на события плагина.

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

Поля события

Имя поля	Тип	Описание
`event`	Перечисление	Имя события. Возможные значения: `rendered`, `clicked`, `not_you`, `opt_in`.
`ref`	Строка	Содержит значение, заданное в параметре `data-ref` плагина. Поддерживаются только буквы и цифры, а также символы -, _, и =.
`is_after_optin`	Логическое значение	Указывает, произошло ли событие после подтверждения во всплывающем окне.
`pluginID`	Не определено	Поле не используется.

Событие Webhooks

Плагин "Отправить в Messenger" активирует событие Webhooks messaging_optins.

Настройка процесса входа

Если пользователь не вошел в Facebook, плагин будет отображаться без указания личности пользователя. Если нажать кнопку, пользователь получит предложение войти.

Если задать для allow_login значение false, плагин не будет отображаться людям, которые не вошли в аккаунт.

Обратите внимание: плагин будет работать без активного сеанса Facebook, только если приложение одобрено и доступно всем.

Вариант текста с призывом к действию

Плагин "Отправить в Messenger" поддерживает атрибут cta_text. С его помощью можно выбирать текст кнопок в плагине из заранее определенного списка строк. Когда используется атрибут cta_text, большинству вошедших пользователей потребуется только нажать кнопку в плагине, чтобы дать согласие. Повторное подтверждение согласия во всплывающем уведомлении не потребуется. Сразу после этого будет доставлено событие messaging_optins.

Атрибут cta_text поддерживает следующие значения:

GET_THIS_IN_MESSENGER;
RECEIVE_THIS_IN_MESSENGER;
SEND_THIS_TO_ME;
GET_CUSTOMER_ASSISTANCE;
GET_CUSTOMER_SERVICE;
GET_SUPPORT;
LET_US_CHAT;
SEND_ME_MESSAGES;
ALERT_ME_IN_MESSENGER;
SEND_ME_UPDATES;
MESSAGE_ME;
LET_ME_KNOW;
KEEP_ME_UPDATED;
TELL_ME_MORE;
SUBSCRIBE_IN_MESSENGER;
SUBSCRIBE_TO_UPDATES;
GET_MESSAGES;
SUBSCRIBE;
GET_STARTED_IN_MESSENGER;
LEARN_MORE_IN_MESSENGER;
GET_STARTED.