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

Для початку роботи з модулем необхідно створити та налаштувати додаток Facebook. 

Для створення додатку виконайте наступні дії: 

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

• Введіть дані свого Facebook акаунту і натисніть "Вхід"

• Вас знову перенаправить на головну сторінку, де необхідно натиснути "Почати роботу"

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

• На другому ввести свій номер телефону і отримати код для верифікації номера в смс повідомленні

• На третьому підтвердіть адресу електронної пошти (буде відправленно листа на пошту, яку ви вказали у своєму профілі Facebook при реєстрації, або не буде надіслано нічого, якщо пошта вже верифікована)

• На фінальному кроці оберіть роль, яка найбільш точно описує вашу участь в Facebook додатку. Роль не впливає на доступний функціонал, тому обрати можна будь-яку.

• На сторінці з Вашими додатками (яка відкриється після вибору ролі) натисніть "Створити додаток"

• У вспливаючому вікні оберіть тип додатку "Компанія" і натисніть "Продовжити"

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

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

• Виберіть тип Web

• Введіть Ваш домен Perfectum CRM+ERP.

• Всі інші кроки можна пропускати

• Перейдіть в налаштування входу через Facebook

• У дозволені домени пропишіть домен Вашої системи, включіть "Вхід за допомогою SDK JavaScript" і збережіть налаштування

• На сторінці налаштувань натисніть "Додати або видалити сторінки"

• В вспливаючому вікні натисніть "Продовжити як.."

• Далі відобразиться список сторінок, прив'язанных до вашого профілю. Можна вибрати з існуючих, або натиснути "Створити Сторінку" (сторінка, яку Ви оберете на даному етапі буде використовуватися для отримання повідомлень від клієнтів у 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 додатку та Секрет додатку за шляхом "Налаштування -> Основне" і вставте в поля СРМ

• Покроково виберіть усі раніше налаштовані сторінки та надайте всі дозволи. Натисніть “Синхронізувати” після входу

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

• Щоб протестувати модуль, перейдіть на звичайну платформу 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.