Инструкция по подключению и настройке интеграции UniTalk и KeepinCRM
Дата публикации: 06.09.2022
Примечание. Перед выполнением шагов инструкции необходимо быть авторизованным в личных кабинетах UniTalk и KeepinCRM с правами администратора. Кроме того необходимо иметь доступ к расширенному платному функционалу KeepinCRM.
Подключение интеграции
Для подключения интеграции с KeepinCRM необходимо:
1. Перейти в личный кабинет Unitalk на страницу “API” раздела “Интеграции” (Рис. 1);
Рис. 1
Примечание. В случае, если ключ API не был предварительно создан, в открытом разделе необходимо нажать кнопку “Создать” (Рис. 2).
Рис. 2
2. Скопировать ключ API (Рис. 3);
Рис. 3
3. Перейти в личный кабинет KeepinCRM на страницу “Інтеграції” раздела “Налаштування” (Рис. 4);
Рис. 4
4. На открытой странице нажать на карточку “UniTalk” (Рис. 5);
Рис. 5
5. На открывшейся странице нажать на кнопку “Добавить” в правом нижнем углу страницы (Рис. 6);
Рис. 6
6. В открытом диалоговом окне заполнить обязательные поля (Рис. 7):
Указать желаемое название канала в поле “Название”;
Вставить скопированный ранее ключ API в поле “UniTalk API Key”.
Рис. 7
7. Нажать кнопку “Добавить” в открытом диалоговом окне (Рис. 8);
Рис. 8
8. Включить push-уведомления и предоставить соответствующие разрешения в браузере (Рис. 9);
Рис. 9
9. В блоке “Асоціація SIP номерів та користувачів KeepinCRM”:
Нажать кнопку “Додати” (Рис. 10);
Рис. 10
10. Из выпадающего списка выбрать SIP линию сотрудника (Рис. 11);
Рис. 11
11. Из выпадающего списка выбрать пользователя KeepinCRM (Рис. 12);
Рис. 12
12. Повторить пункты 9.1 — 9.3 для всех сотрудников.
13. В нижней части страницы нажать на поле “Вебхук url” (Рис. 13);
Рис. 13
14. Перейти в личный кабинет Unitalk на страницу “API” раздела “Интеграции”, в блоке “Исходящие вебхуки” нажмите кнопку “Добавить” 3 раза, чтобы добавить 3 вида обработки событий (Рис. 14);
Рис. 14
15. Для созданных обработчиков установить из выпадающего списка “События” такие опции (Рис. 15):
Новый звонок;
Ответ на звонок;
Звонок завершен.
Рис. 15
16. Для созданных обработчиков вставить в поле “URL” ссылку на вебхук, скопированную в пункте 10 (Рис. 16);
Рис. 16
17. Нажать кнопку “Сохранить” (Рис. 17).
Рис. 17
Подключение интеграции звонков автообзвона
Для передачи информации о звонках автообзвона необходимо:
1. Перейти в личный кабинет KeepinCRM на страницу “Інтеграції” раздела “Налаштування” (Рис. 18);
Рис. 18
2. На открытой странице нажать на карточку “UniTalk” (Рис. 19);
Рис. 19
3. Если подключено более одного проекта, выбрать вкладку соответствующей интеграции (Рис. 20);
Рис. 20
4. В нижней части страницы нажать на поле “Autodial Webhook url” (Рис. 21);
Рис. 21
5. Перейти в личный кабинет Unitalk на страницу “Обработка событий”, в верхней части страницы нажать на кнопку “Добавить действие” (Рис. 22);
Рис. 22
6. В открывшемся блоке “Добавление нового действия” ввести желаемое название в поле “Название” и вставить в поле “URL” ссылку на вебхук, скопированную в пункте 4 (Рис. 23);
Рис. 23
7. Нажать кнопку “Сохранить” (Рис. 24);
Рис. 24
8. При создании или редактировании автообзвона/гарантированного дозвона перейти к блоку “Обработка событий” (Рис. 25);
Рис. 25
9. Для каждого события звонка необходимо:
Нажать на кнопку “Добавить” (Рис. 26);
Рис. 26
10. Из выпадающего списка выбрать созданный ранее вебхук (Рис. 27).
Рис. 27
11. Сохранить изменения в автообзвоне/гарантированном дозвоне.
Список событий звонка:
Абонент позвонил сам или был исходящий;
Звонок завершен — абонент разговаривает;
Звонок завершен — вне зоны или отключён;
Звонок завершен — занято или сброс;
Звонок завершен — не отвечено;
Звонок завершен — неверное направление;
Звонок завершен — недостаточно линий;
Звонок завершен — номер не существует;
Звонок завершен — отвечено абонентом и не было звонка операторам;
Звонок завершен — отвечено абонентом и не было свободных операторов;
Звонок завершен — отвечено абонентом и оператором
Звонок завершен — отвечено абонентом и операторы не приняли звонок;
Звонок завершен — ошибка аудио;
Звонок завершен — сбой соединения;
Звонок завершен неуспешно и закончились попытки повторного прозвона.
Подключение и настройка интеграции завершена. Информация о звонках передается в KeepinCRM и может быть просмотрена на странице “Дзвінки” (Рис. 28).
Рис. 28