- Сервис онлайн-консультирования Webim
- -
- База знаний
- -
- Интеграции
- -
- Социальные сети и мессенджеры
- -
- Facebook и Instagram*
- -
- Настройка интеграции с Facebook* (для версий до 10.0 включительно)
-
-
-
- API сервиса Webim
- Webim Mobile SDK и мобильное приложение Webim для посетителя
- Встраивание чата Webim на сайт
- Идентификаторы посетителя
- Интеграция со сторонними сервисами
- Интерфейс виджета чата
- Логика обработки чатов
- Настройка сервиса Webim
- Операторы и РМО
- Отделы в сервисе Webim
- Панель приборов: ответы на вопросы
- Эксплуатация сервиса Webim
- Основные понятия и термины
- Сброс пароля
- Система управления ролями и правами доступа
- Шаг 1. Установка виджета Webim на сайт
- Шаг 2. Начальная настройка сервиса
- Шаг 3. Регистрация оператора
- Шаг 4. Подключение каналов общения
-
-
-
- 01. Обнаружение нового посетителя, ожидающего ответа
- 02. Выбор посетителя сайта из списка и начало диалога
- 03. Набор ответа посетителю, выбор шаблона
- 04. Запрос контактной информации у посетителя
- 05. Отправка файла посетителю
- 06. «Телепортация» пользователей
- 07. Переадресация диалога другому оператору
- 08. Отправка переписки на адрес электронной почты оператора
- 09. Назначение категории посетителю
- 10. Блокировка посетителя
- 11. Вставка гиперссылки в сообщение
- 12. Добавление cкрытых сообщений
- 13. Проверка орфографии
- Agent`s Handbook
- Горячие клавиши в РМО
- Загрузка файлов в диалог
- Исходящие диалоги
- Как включить оповещения в Google Chrome
- Очереди в РМО
- Работа с офлайн-обращениями в РМО
-
- Автоприглашения
- Активность сотрудников
- Алгоритмы назначения чатов
- Видимость диалогов
- Возможности и ограничения Webim в каналах общения
- Вход в систему
- Геолокация посетителей
- График работы
- Добавление кнопки Webim в E-mail
- Закрытие диалогов
- Логотип компании в заголовке чата
- Маршрутизация чатов между операторами и ботами
- Маска телефонного номера
- Настройка языков
- Общие настройки организации
- Ограничения по длине сообщений и полей
- Особенности функционала «Начать чат» в каналах общения
- Отделы
- Оценки
- Переназначение специализированных клавиш управления в РМО
- Приоритетные страницы
- Рассылки
- Регистрация операторов и назначение супервизоров
- Системные сообщения
- Список тайм-аутов
- Финансы
- Шаблоны ответов
-
-
- Встраивание административного интерфейса через iframe
- Горизонтальное масштабирование (кластеризация)
- Интеграция с почтовыми серверами
- Обработка файлов, загружаемых в чат
- Описание сервисных периодов Webim
- Параметры настроек сервера
- Редактор настроек аккаунта (account config)
- Редактор ресурсов
- Сетевые конфигурации сервиса Webim
-
-
-
- Webim Mobile SDK 3.0 для интеграции в мобильные приложения iOS
- Информация о выпусках (Release notes) – Webim Mobile SDK 3 для Android
- Информация о выпусках (Release notes) – Webim Mobile SDK 3 для iOS
- Справочник по Webim Mobile SDK – SDK для интеграции в мобильные приложения iOS (iPhone/iPad)
- Справочник по Webim Mobile SDK для интеграции в мобильные приложения Android
- Push-уведомления
- Webim Cordova Plugin
-
- Webim CRM postMessage Interface
- Как сделать ссылку кнопкой старта чата
- Маршрутизатор чатов
- Обработчики событий чата
- Процедура установки чата Webim на сайт в iframe
-
-
-
- Настройка интеграции с Facebook* (для версий до 10.0 включительно)
- Настройка интеграции с Facebook* с помощью приложения Webim
- Настройка интеграции с Instagram* с помощью приложения Webim
- Настройка приложения для интеграции с Facebook* (для версий до 10.0 включительно)
- Создание бизнес-аккаунта в Instagram*
- Создание страницы организации в Facebook*
- Skype
- Telegram
- Viber
- ВКонтакте
- Одноклассники
-
-
Настройка интеграции с Facebook* (для версий до 10.0 включительно)
СОДЕРЖАНИЕ
В этой статье содержатся все сведения о канале общения операторов сервиса Webim через социальную сеть Facebook*. Данная статья актуальна для интеграции с Facebook* при использовании версий Webim до 10.0 включительно. Начиная с версии 10.1 интеграция настраивается намного проще и быстрее при помощи использования приложения Webim (см. ссылку).
Чат Facebook* можно подключить к сервису Webim в качестве канала общения. Все сообщения пользователей из чатов с Вашим сообществом попадут в общую очередь Webim и буду распределяться из неё между Вашими операторами. Общий интерфейс, общая очередь, общий список операторов и механизм обработки обращений. Это удобно и эффективно.
Вы можете подключить любое число Страниц Facebook* к своей учётной записи Webim.
NB: До перехода к подключению, собственно, самой интеграции, необходимо создать и настроить своё приложение в Facebook*. О том, как это сделать, подробно расписано в этой статье.
Добавление новой подписки:

.
Запрос разрешений:

Редактирование запроса:

.
Страница редактирования запроса:

.
Настройки приложения: 
Отправка на проверку:

Добавление канала общения в Webim
Первым делом нужно добавить канал общения в Webim:
Пример заполнения форм:

-
- Перейдите в раздел основных настроек приложения (Настройки (Settings) -> Основное (Basic)). Здесь запишите или скопируйте (например, в предварительно открытый текстовый документ) секрет приложения (App Secret), чтобы не потерять.
Секрет приложения: - В отдельной вкладке браузера откройте страницу Общих настроек Webim (Settings -> General). В разделе Каналы общения (Communication Channels) найдите Facebook* и нажмите "Добавить страницу" ("Add Page").
Добавление страницы Facebook: - Откроется форма Добавление страницы Facebook* (Adding a Facebook* Page). Заполните поля формы следующим образом:
- Название страницы (Page Name): введите любое удобное для вас название страницы.
- Маркер доступа страницы (Access Token): вставьте маркер доступа из Facebook*, сохранённый Вами в текстовом документе, в это поле.
- Код подтверждения (Confirmation Code): придумайте и введите здесь псевдослучайный набор знаков по тем же правилам, как придумываете пароли.
- Секрет приложения (App Secret): вставьте секрет приложения Facebook*, сохранённый Вами в текстовом документе, в это поле.
- Отдел (Department): если сообщения со страницы Facebook* нужно направлять в определённый ранее созданный отдел Webim, выберите его из списка. Если сообщения можно направлять операторам вне зависимости от того, к какому отделу они принадлежат, оставьте значение Без отдела.
- Вернитесь во вкладку с настройками приложения Facebook* (важно: вкладка с Webim должна оставаться открытой) и откройте Messenger -> Настройки (Settings). Здесь в разделе Webhooks нажмите кнопку "Добавить URL обратного вызова" ("Add Callback URL").
- В появившейся форме заполните поля URL обратного вызова (Callback URL) и Маркер подтверждения (Verify Token): скопируйте значения адреса сервера и кода подтверждения из вкладки с формой добавления страницы Facebook* в Webim, затем вернитесь на вкладку c Facebook* и вставьте скопированные значения в соответствующие поля формы. Для наглядности примеры заполнения обеих форм представлены в иллюстрации ниже (адрес сервера и код подтверждения копируются из формы справа и вставляются в форму слева).
- Перейдите в раздел основных настроек приложения (Настройки (Settings) -> Основное (Basic)). Здесь запишите или скопируйте (например, в предварительно открытый текстовый документ) секрет приложения (App Secret), чтобы не потерять.

- Сохраните заполненные формы сначала на вкладке с Webim, а затем c приложением Facebook*. В противном случае, на вкладке с приложением Facebook* Вы увидите сообщение об ошибке.
Настройка Webhooks
- Теперь в разделе Webhooks появится уже добавленная страница и рядом с ней появится кнопка "Добавить подписки" ("Add subscriptions"). Нажмите на эту кнопку.
Добавить подписки: - В появившейся форме поставьте галочку у messages и нажмите "Сохранить" ("Save").

Создайте запрос на проверку приложения
-
- Теперь перейдите в Проверка приложения (App Review) в раздел Разрешения и функции (Permissions and Features). В списке разрешений найдите 4 разрешения: pages_show_list, pages_messaging, pages_read_engagement и pages_manage_metadata. У каждого из этих разрешений нажмите кнопку "Запросить расширенный доступ" ("Request Advanced Access").

-
- Теперь на любом из разрешений нажмите кнопку "Редактировать запрос на отправку приложения" ("Edit App Review Request").

-
- После этого Вы попадёте на страницу редактирования запроса.

Заполнение форм
- Чтобы отправить приложение на проверку, Вас попросят заполнить следующие формы:
-
-
- Информация для подтверждения приложения.
- При заполнении информации для подтверждения приложения сначала Вас попросят указать платформу. Нажмите "Добавить платформу" ("Add platform"):
Добавление платформы: - Откроется вкладка с основными настройками приложения. В самом низу Вы увидите кнопку "Добавить платформу" ("Add platform"). Нажмите на неё и выберите Website.
Выбор платформы: - Укажите адрес сайта Вашей компании в появившемся поле.
Добавление сайта компании: - На этой же вкладке убедитесь, что у Вас указан адрес электронной почты для связи и ссылка на политику конфиденциальности Вашего сайта. Обычно эти данные подгружаются с информации, содержащейся на странице Вашей компании в Facebook*. Если Вы не указывали эти данные на странице, укажите их сейчас. Также добавьте значок приложения (1024х1024 пикселей) и укажите категорию приложения, которая соответствует целям Вашей компании. После этого сохраните изменения.NB: указывайте актуальную ссылку на политику конфиденциальности. Если будет указана неактуальная ссылка, Facebook* не даст сохранить информацию для подтверждения приложения.
Пример указанных данных: - Вернитесь на вкладку с запросом и снова откройте форму заполнения информации для подтверждения приложения. Откроется форма, в которой нужно будет написать пошаговую инструкцию для проверяющего в Facebook*, как протестировать интеграцию и указать все необходимые данные для входа (то есть, предполагается создание тестовой учётной записи в Webim для проверяющего из Facebook*).NB: убедитесь, что инструкция написана подробно и понятно и содержит всю необходимую для проверяющего информацию, иначе запрос может быть отклонён; также убедитесь, что Facebook* может использовать Ваши данные для входа (поставьте "да" в соответствующем поле). Писать инструкцию можно как на английском, так и на русском языке. После заполнения формы, сохраните её.
Пример написания инструкции:
- При заполнении информации для подтверждения приложения сначала Вас попросят указать платформу. Нажмите "Добавить платформу" ("Add platform"):
- Информация для подтверждения приложения.
- Запрашиваемые разрешения и функции.
- Теперь последовательно заполните 4 формы с информацией об использовании запрашиваемых разрешений (по одной форме для каждого запрашиваемого разрешения). В каждой форме необходимо описать, зачем запрашивается разрешение и как оно используется (pages_messaging используется для отправки сообщений; pages_manage_metadata используется для получения долгосрочного маркера доступа к странице Вашей компании в Facebook* и для его дальнейшего обновления; pages_read_engagement используется для получения фото профиля посетителей и их имён; pages_show_list позволяет использовать разрешения pages_manage_metadata и pages_read_engagement).
- Также напишите подробную инструкцию для тестирования интеграции (если требуется для конкретного разрешения), укажите страницу Вашей компании (если требуется для конкретного разрешения) и приложите запись экрана (скринкаст), в котором подробно показан процесс тестирования интеграции. По окончании заполнения формы подтвердите своё согласие с условиями пользования (поставьте галочку в конце формы).
Пример заполнения формы:
-
- Настройки приложения.

- После заполнения всех необходимых данных, нажмите "Отправка на проверку" ("Submit for Review").

Ожидание результатов проверки
- Прежде, чем отправить приложение на проверку, в целях безопасности Вас попросят ввести пароль от учётной записи Facebook*.
- Проверка приложения займёт примерно 5 дней. Статус текущего запроса можно смотреть в Проверка приложения (App Review) -> Запросы (Requests). Также уведомления о статусе запроса будут приходить на на адрес электронной почты, указанный Вами в качестве адреса для связи. Если приложение будет работать с данными других компаний, то потребуется подтвердить идентификационные данные Вашей компании или физического лица, имеющего роль в приложении (администратор/разработчик/...). Сделать это можно в любой момент.
Предложение подтверждения компании: - По прошествии 5 дней, либо как только Вы получите уведомление на электронную почту от Facebook*, можно узнать результаты проверки. Если всё сделано верно, то Вы увидите сообщение о том, что все разрешения одобрены для использования и приложение можно публиковать (делать его доступным для всех остальных пользователей Facebook*). В противном случае, Вы увидите сообщение о том, что одно или несколько разрешений не были одобрены. Также в этом сообщении будут отображены комментарии от Facebook* с рекомендациями, что нужно исправить для получения одобрения. После исправления запроса, его можно отправить на повторную проверку.NB: на повторную проверку отправляются только те разрешения, которые не были одобрены ранее, одобренные разрешения на проверку не отправляются.
Пример успешной проверки: Пример неуспешной проверки: - После того, как приложение прошло проверку, его можно публиковать. Для этого в верхней части страницы с запросами переключите ползунок из положения в "В разработке" ("In Development") в положение "Опубликовано" ("Released").
Публикация приложения:
Как использовать канал
Теперь канал общения Facebook* готов к работе.NB: в режиме разработки Facebook* предоставляет все разрешения для работы приложения пользователям, у которых есть роль в нём (администратор и назначенные им пользователи; следующую последовательность действий можно использовать для записи экрана (скринкаста) при отправке запроса на проверку приложения.
Прежде, чем начать использование приложения, отправьте тестовое сообщение. Для этого нужно выполнить следующие шаги:
На этом настройка интеграции между сервисами Webim и Facebook* завершена.
В некоторых случаях, приложение может оказаться заблокированным сразу после публикации. Чтобы снять блокировку приложения, подайте жалобу и пройдите дополнительные проверки подтверждения личности, если потребуется. После этих действий, блокировка приложения будет снята, и канал общения будет готов.
- Откройте страницу, на которой используется приложение Webim в Facebook*. Выберите способ взаимодействия от имени Вашей личной учётной записи.
Изменение взаимодействия: - После этого на странице появится кнопка "Сообщение". Нажмите на неё и наберите тестовое сообщение.
Набор тестового сообщения: - Если интеграция настроена верно, то операторы в Панели управления увидят набранное тестовое сообщение из Facebook*. Оно будет отображаться точно также, как и обычное сообщение от посетителя, при этом оператор будет видеть основные данные посетителя: имя и фамилия, фото профиля, точка входа (в данном случае, это сайт Facebook*). Также обращаем Ваше внимание, что, согласно правилам Facebook*, ответить на сообщения оператор может в течение 24 часов.
Диалог с посетителем через Facebook*: