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

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

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

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

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

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

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

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

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

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

• На открывшейся странице с Вашими приложениями нажмите "Создать приложение"

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

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

• На открывшейся странице "Товаров" предстоит настроить "Messеnger" и "Webhooks". Для начала переходим в "Messеnger" (нажатием на "Настроить")

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Опишите как приложение использует запрашиваемую функцию и загрузите скринкаст.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Далее необходимо скопировать ID страницы. Для этого перейдите "Messenger -> Настройки -> Маркеры доступа (или Webhooks) и под названием страницы скопируйте ID. Внесите данные в срм.

• Теперь необходимо сгенерировать маркер пользователя. Для этого перейдите по ссылке и нажмите page_messaging https://developers.facebook.com/tools/explorer/

• В выпадающем списке требуется выбрать 7 разрешенений для маркера: pages_show_list, read_page_mailboxes, pages_messaging, pages_read_engagement, pages_manage_metadata, pages_read_user_content, pages_manage_engagement, нажмите "Generate Accsess Token", авторизируйтесь в всплывающей форме (выберите страницу, которую Вы привязывали к приложению) и скопируйте токен (страницу не закрывайте).

• Вставьте его в поле "Маркер пользователя" в СРМ
• Вернитесь на страницу с токеном, нажмите на подсказку в виде буквы "i" возле него. Скопируйте номер возле поля "Пользователь" - это id пользователя внутри приложения. Вставьте его в срм. Сохраните все внесенные настройки

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

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

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

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

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

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

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

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

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



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



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