Платформа Messenger

Справка по веб-плагинам

Платформа Messenger предлагает ряд удобных веб-плагинов, которые помогают начать переписку с посетителями сайта. Все плагины реализуются с помощью Facebook SDK для JavaScript.

Содержание

Плагин чата с клиентами (бета-версия)

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

Подробнее см. в статье Плагин чата с клиентами.

Формат

<div class="fb-customerchat"
 page_id="<PAGE_ID>">
</div>

Атрибуты

Атрибут Тип Описание

class

Строка

Должен иметь значение fb-customerchat.

page_id

Строка

ID вашей Страницы.

ref

Строка

Необязательный. Специально настроенная строка, которая передается в ваш Webhooks в событиях messaging_postbacks и messaging_referrals.

theme_color

Строка

Необязательный. Цвет темы оформления плагина, в том числе цвет фона значка для плагина чата с клиентами и цвет фона сообщений, отправляемых пользователями. Поддерживает шестнадцатеричные коды всех цветов со значком решетки в начале (например, #0084FF), кроме белого. Настоятельно рекомендуем выбирать цвет, контрастный белому.

logged_in_greeting

Строка

Необязательный. Текст приветствия, который будет отображаться, если пользователь вошел на Facebook. Не более 80 символов.

logged_out_greeting

Строка

Необязательный. Текст приветствия, который будет отображаться, если пользователь не вошел на Facebook. Не более 80 символов.

greeting_dialog_display

Строка

Необязательный. Режим показа диалога приветствия. Поддерживаются следующие значения:


  • show — диалог приветствия всегда отображается и остается видимым после загрузки плагина;
  • fade — диалог приветствия отображается и постепенно исчезает, после чего остается скрытым;
  • hide — диалог приветствия всегда скрыт и отображается только при нажатии плагина.

По умолчанию на ПК используется значение show, а на мобильных устройствах — hide.

greeting_dialog_delay

Строка

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

minimized

Логическое значение

Уведомление об упразднении

Этот атрибут больше не используется. Для настройки плагина следует использовать атрибут greeting_dialog_display. Атрибут greeting_dialog_delay теперь имеет приоритет над атрибутом minimized.

Необязательный.

  • Значение true дает тот же эффект, что и greeting_dialog_delay = "fade".
  • Значение false дает тот же эффект, что и greeting_dialog_delay = "show".

Плагин "Напишите нам"

Пригласите человека непосредственно в переписку в Messenger.

Подробнее см. в статье Плагин "Напишите нам".

Формат

<div class="fb-messengermessageus" 
  messenger_app_id="<APP_ID>" 
  page_id="<PAGE_ID>"
  color="<blue | white>"
  size="<standard | large | xlarge>">
</div>

Атрибуты

Атрибут Атрибут HTML5 Тип Описание

class

Строка

Должен иметь значение fb-messengermessageus.

page_id

Строка

ID вашей Страницы.

messenger_app_id

Число

ID приложения Facebook.

color

data-color

Строка

Цвет кнопки: blue или white.


Значение по умолчанию — blue.

size

data-size

Строка

Размер кнопки: standard, large или xlarge.


Значение по умолчанию — large

ref

Строка

Необязательный. Специально настроенная строка, которая передается в ваш Webhooks в событиях messaging_postbacks и messaging_referrals.

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

Отправляйте людям сообщения от бота Messenger в фоновом режиме и подписывайте их.

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

Формат

<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>

Атрибуты

Атрибут Тип Описание

class

Строка

Должен иметь значение fb-send-to-messenger.

page_id

Строка

ID вашей Страницы.

messenger_app_id

Число

ID приложения Facebook.

color

Строка

Необязательный. Цвет кнопки: blue или white.


Значение по умолчанию — blue.

size

Строка

Необязательный. Размер кнопки: standard, large или xlarge.


Значение по умолчанию — large

ref

Строка

Необязательный. Специально настраиваемый параметр состояния. Максимальное количество символов: 250.


Допустимые символы: a-z A-Z 0-9 +/=-._.


Из соображений безопасности он должен быть закодирован и зашифрован.

enforce_login

Логическое значение

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

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

Плагин с флажком

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

Подробнее см. в статье Плагин с флажком.

Формат

<div class="fb-messenger-checkbox"  
  origin=<PAGE_DOMAIN>
  page_id=<PAGE_ID>
  messenger_app_id=<APP_ID>
  user_ref="<UNIQUE_REF_PARAM>"
  allow_login="<true>"
  size="<small | medium | large | standard | xlarge>"
  skin="<light|dark>"
  center_align="<true|false>">
</div>

Атрибуты

Атрибут Тип Описание

class

Строка

Должен иметь значение fb-messenger-checkbox.

page_id

Число

ID Страницы Facebook, связанной с ботом.

messenger_app_id

Число

ID приложения Facebook.

user_ref

Строка

Уникальный параметр для ссылки на пользователя. Максимальное количество символов: 250.


Допустимые символы: a-z A-Z 0-9 +/=-._.

allow_login

Логическое значение

Необязательный. Позволяет людям выполнить вход при отсутствии активного сеанса. Значение по умолчанию — true.

size

Строка

Необязательный. Размер плагина: small, medium, large, standard, xlarge.


Значение по умолчанию — large

skin

Строка

Необязательный. Цветовая тема для контента в плагине. Поддерживаемые варианты:

  • light — темный текст;
  • dark — белый текст, прозрачный значок Messenger и белый значок молнии.

Значение по умолчанию — light.

center_align

Логическое значение

Необязательный. Указывает, нужно ли выравнивать контент в плагине по центру.


Значение по умолчанию — false.