Настройка модуля "Единый чат с Facebook"

30 октября 2023
👁 4078

В Perfectum CRM+ERP разработан модуль "Единый чат с Facebook", который дает возможность осуществлять коммуникацию с клиентами, используя Facebook внутри Perfectum CRM.

Для начала работы с модулем необходимо создать и настроить приложение Facebook.

Для создания приложения выполните следующие действия:

  • Перейдите на страницу https://developers.facebook.com, авторизуйтесь с помощью кнопки "Вход" в правом верхнем углу

fb

  • Введите данные своего Facebook аккаунта и нажмите "Вход"

fb

  • Вас снова перенаправит на главную страницу, где необходимо нажать "Начать работу"

fb

  • Далее откроется форма регистрации аккаунта Facebook for Developers (который необходимо иметь для создания и управления приложениями)
  • На первом шаге необходимо согласиться с условиями платформы

fb

  • На втором ввести свой номер телефона и получить код для верификации номера в смс сообщении

fb

fb

  • На третьем подтвердить адрес электронной почты (будет отправлено письмо на почту, которую Вы указывали в своем профиле Facebook при регистрации, либо ничего не будет отправлено, если почта уже верифицирована)

fb

  • На финальном шаге выбрать роль, которая наиболее точно описывает ваше участие в Facebook приложении. Роль не влияет на доступную функциональность, поэтому выбрать можно любую.

fb

  • Во всплывающем окне установите тип приложения "Компания" и нажмите "Продолжить"

fb

  • Придумайте название для Вашего приложения, задайте email (для контакта с модераторами Facebook, в случае проблем с приложением), установите назначение приложения "Вы или принадлежащая вам компания" и нажмите "Создание приложения" (после нажатия требуется ввести свой пароль от аккаунта Facebook)

fb

fb

  • На странице товаров предстоит настроить "Messеnger", "Webhooks" и "Вход через Facebook". Для начала переходим в "Вход через Facebook" (нажатием на "Настроить")

inst_sett

inst_sett

  • Выберите тип Web

inst_sett

  • Введите Ваш домен Perfectum CRM+ERP

inst_sett

  • Все остальные шаги можно пропускать

inst_sett

  • Перейдите в настройки входа через Facebook

inst_sett

  • В разрешенные домены пропишите домен Вашей системы, включите "Вход с помощью SDK JavaScript" и сохраните настройки

inst_sett

  • На странице настройки нажмите "Добавить или удалить страницы"

fb

  • Во всплывающем окне нажмите "Продолжить как.."

fb

  • Далее отобразится список страниц, привязанных к Вашему профилю. Можно выбрать из существующих, либо нажать "Создать Страницу" (страница, которую Вы выберите на данном этапе будет использоваться для получения сообщений от клиентов в CRM, при необходимости в будущем ее можно будет изменить)

fb

  • Если Вы нажали "Создать страницу", то в открывшейся вкладке необходимо заполнить данные для страницы. Название, категорию (может быть любой), описание (по желанию) и подтвердить создание

fb

  • Вернитесь во вкладку настройки "Messеnger" после создания, и повторно добавьте уже созданную страницу

fb

  • Далее обязательно предоставьте доступ к перепискам от имени страницы и нажмите "Готово"

fb

  • После всех проделанных действий появится сообщение о том, что страница привязана к приложению. Нажмите "ОК"

fb

  • Выбранная страница должна появиться в списке на странице настроек мессенджера

fb

  • Далее необходимо перейти на главную Панель ("Панель" в боковом меню слева) и выбрать Вебхуки

fb

  • В открывшихся настройках Вебхуков выберите "Page" в выпадающем списке и подпишитесь

fb

  • Откроется форма. В поле "URL обратного вызова" пропишите ссылку следующего формата: https://{{domain}}/gateways/facebook (где {{domain}} - домен Вашей CRM системы), в поле "Маркер подтверждения" пропишите произвольный маркер латиницей (такой же маркер необходимо будет прописать в соответствующем поле в СРМ по пути "Настройки -> Конфигурация -> Приложения -> Facebook -> Маркер подтверждения для вебхука". Маркер придумываете Вы). Сохраните форму (Важно: Сначала маркер нужно внести и сохранить в СРМ (другие поля заполнять для этого не нужно. А потом сохранять форму на странице настроек вебхуков)
  • >

fb

fb 25

  • Вернитесь на страницу настроек Мессенджера. В блоке Webhooks появится перечень страниц с возможностью добавить подписки.

fb

  • Нажмите добавить подписки возле страницы

fb

  • Выберите 3 поля подписки (messages, messaging_postbacks и message_echoes) и сохраните.

fb

  • Перейдите в раздел "Проверка приложения -> Разрешения и функции" (Примечание: Следующие шаги по настройке разрешений можно временно пропустить и протестировать работу модуля "Единый чат с Facebook" через профили, которые являются администраторами приложения. Подробнее читайте ниже.)

fb

  • Выберите 4 разрешения: pages_manage_metadata, pages_messaging, pages_read_engagement, pages_show_list и нажмите на "Запросить расширенный доступ" возле каждого разрешения (для поиска разрешений можно воспользоваться поиском). После, нажмите на кнопку "Продолжить оформление запроса", когда все разрешения будут выбраны.

fb

  • Откроется страница запроса на проверку. И 6 шагов (их число может измениться, в зависимости от количества выбранных разрешений)

fb

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

fb

fb

fb

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

Пример инструкции (все доступы создайте специально для модератора фейсбук):

  1. Перейти на тестовую страницу {{тестовая страница фейсбук}} и написать сообщение. (Доступы для тестового пользователя: email - {{email пользователя facebook}} password - {{пароль пользователя}})
  2. Перейти по ссылке https://{{домен вашей срм}}/admin/ и авторизоваться. (Доступы для тестового пользователя: логин - {{логин пользователя срм}} password - {{пароль пользователя}}).
  3. Перейти на страницу https://{{домен вашей срм}}/admin/facebook
  4. Открыть чат с тестовым пользователем, нажав на первую кнопку в столбце
  5. Отправить сообщение тестовому пользователю
  6. Если необходимо изменить настройки интеграции, перейдите в https://{{домен вашей срм}}/admin/settings?group=facebook

fb

  • Перейдите ко второму шагу, который касается разрешения pages_show_list

fb

  • Опишите пути использования разрешения и загрузите запись экрана с демонстрацией того, как приложение использует это разрешение.

Пример описания использования: Разрешение необходимо для корректной работы разрешений pages_read_engagement и pages_manage_metadata.

fb

Скринкаст можно использовать такой же как и для функции pages messaging.

  • Перейдите к третьему шагу, который касается разрешения pages_read_engagement

fb

  • Опишите как приложение использует запрашиваемую функцию и загрузите скринкаст.
  • Пример описания использования: При получении существующих или новых переписок приложение получает информацию о потенциальном клиенте.

    Пример скринкаста:

fb

  • Перейдите к четвертому шагу, который касается разрешения pages_messaging

fb

  • Опишите как приложение будет использовать разрешение и загрузите скринкаст

Пример описания использования: Данная функция используется для отправки сообщений пользователям, которые напишут на страницу компании через чат системы.

Пример инструкции (все доступы создайте специально для модератора фейсбук):

  1. Перейти на тестовую страницу {{тестовая страница фейсбук}} и написать сообщение. (Доступы для тестового пользователя: email - {{email пользователя facebook}} password - {{пароль пользователя}})
  2. Перейти по ссылке https://{{домен вашей срм}}/admin/ и авторизоваться. (Доступы для тестового пользователя: логин - {{логин пользователя срм}} password - {{пароль пользователя}}).
  3. Перейти на страницу https://{{домен вашей срм}}/admin/facebook
  4. Открыть чат с тестовым пользователем, нажав на первую кнопку в столбце
  5. Отправить сообщение тестовому пользователю

Пример скринкаста:

fb

  • Перейдите к пятому шагу, который касается разрешения pages_manage_metadata

fb

  • Опишите как приложение будет использовать разрешение и загрузите скринкаст.
  • Пример описания использования: Приложение подписывается на Webhook для получения новых сообщений от пользователей.

    Пример скринкаста:

fb

  • Перейдите к шестому шагу, в котором требуется указать настройки приложения

fb

  • Он будет выполнен, если при добавлении платформы Вы заполнили все требуемые поля и категорию. Можно проверить корректность данных.

fb

  • После заполнения всех разрешений нажмите "Отправка на проверку" внизу страницы и подтвердите действие паролем.

fb

fb

  • Появится уведомление о том, что приложение отправлено на проверку. (Результатов проверки ожидать около 5-ти дней)

fb

  • Для проверки работы единого чата можно использовать профили администраторов приложения. Для этого перейдите в "Роли -> Администраторы -> Добавить администратора" (можете добавить второго администратора, либо писать на страницу с того профиля, к которому привязано приложение)

fb

  • Далее необходимо сгенерировать данные для полей настроек в Perfectum CRM

fb 50

  • Для начала скопируйте ID приложения и Секрет приложения по пути "Настройки -> Основное" и вставьте в поля СРМ

fb

  • Пошагово выберите все ранее настроенные страницы и предоставьте все разрешения. Нажмите “Синхронизировать” после входа.

fb 52

fb 53

fb

fb 55

fb

fb

fb

  • После проделанных выше указанных действий, нажмите кнопку “Синхронизировать”, для того чтобы сгенерировать маркеры доступа к страницам

fb 58

  • Перейдите на обычную платформу Facebook под своим профилем (важно, чтобы он был в администраторах приложения)
  • В мессенджере найдите свою страницу по названию и отправьте сообщение

fb

  • Проверьте сообщение в СРМ по пути "Приложения -> Facebook"

fb

Функциональность страницы с чатами:

  1. Фильтр по оператору (выводится список всех сотрудников, которые являются операторами минимум в одном чате)
  2. Фильтр по статусу чата (Новый / Отвеченный / В обработке / Завершен)
  3. Фильтр по периоду (по дате последнего контакта)
  4. Поле для выбора количества отображаемых чатов на странице (10,25,50...)
  5. Экспорт таблицы чатов в форматы Эксель / СSV / PDF / Печать
  6. Массовые действия (в данном случае массовое удаление) по выбранным чекбоксам
  7. Кнопка "Обновить" - для обновления таблицы чатов
  8. Графа "Поиск" - для поиска чатов по ключевым словам
  9. Чек-боксы для массовых действий
  10. Поле "№" - указывает уникальный номер чата в системе - после нажатия открывается окно чата
  11. Поле "Связь" - указывает связь с чатом (Контакт/Лид/ Заказ)
  12. Статус чата (с возможностью изменения статуса из таблицы)
  13. Поле "Операторы" - указывает изображение сотрудников которые указаны как операторы чата. При нажатии открывает профиль сотрудника.
  14. Кнопка для просмотра чата (без назначения сотрудника, который просматривает чат оператором)
  15. Кнопка для удаления чата

fb

Возможности чата:

  1. Кнопка для перехода на страницу со всеми чатами
  2. Статус текущего открытого чата
  3. Кнопка для смены статуса чата на "В обработке"
  4. Контактная информация чата если создать связь с контактом
  5. Кнопка для создания нового лида / контакта / заказа, либо перехода в карточку лида / контакта / заказа, если чат уже был к ним привязан
  6. Кнопка для создания связи чата с лидом / контактом / заказом
  7. Кнопка "Добавить оператора" - для добавления оператора в чат из списка сотрудников
  8. Кнопка для завершения чата
  9. Кнопка "Покинуть чат" - для того чтобы выйти из чата
  10. Поле "Вставить готовый ответ" - для использования готовых ответов в чате
  11. Текстовая область для введения сообщения
  12. Кнопка для отправки сообщения
  13. Кнопка для отправления файлов

fb

При создании связи чата с контактом / лидом, в их карточках появляются ссылки на чат и соответствующие записи:

fb

fb

Дополнительная информация

  • Согласно новым правилам Facebook, теперь нужно пройти обязательное подтверждение компании и отправить запрос на получение доступа к расширениям для правильной работы приложения. Для подтверждения компании перейдите в основные настройки и заполните все выделенные поля:

fb

Далее нужно пролистать ниже и пройти процесс подтверждения нажав на соответствующую кнопку:

fb

  • Также необходимо пройти проверку использования данных. На Facebook введена ежегодная Проверка использования данных. Администратор программы должен подтвердить соответствие допустимому использованию, а также соблюдение всех применимых условий и правил. Если не пройти проверку, они могут ограничить доступ к API.

fb

Корпоративное обучение

Специалисты учебного центра помогут понять общие принципы
работы и обучат вашу команду эффективным приемам.