Интеграция по API для IP-телефонии и чатов
Last updated
Last updated
Для того чтобы звонки и/или чаты, совершенные вашими операторами появились в Qolio, необходимо настроить интеграцию вашей IP-телефонии и/или системы управления чатами и dealapp. Интегрировать систему по API вы сможете самостоятельно в личном кабинете с правами администратора, следуя простым шагам в инструкции.
1. Выбор типа интеграции:
войдите в аккаунт администратора вашей компании в сервисе https://app.qolio.ru/login - пройдите в “Личный кабинет”;
в меню личного кабинета слева выберите раздел - “Интеграции” - затем нажмите на кнопку “Добавить интеграцию”;
на странице создания интеграции, которая откроется после нажатия на кнопку, необходимо выбрать настраиваемый вами тип интеграции: “API-телефония” или "API для текстовых коммуникаций";
после выбора типа укажите название интеграции в соседнем поле - и нажмите “Продолжить”.
Пример настройки первого этапа:
2. Добавление пользователей:
после нажатия кнопки “Продолжить” откроется страница добавления пользователей с выбором способа: вручную или через csv файл
выберите подходящий для вас способ
Если вы выбрали добавление вручную:
в открывшемся интерфейсе нажмите “Добавить”, чтобы внести пользователей и заполните поля: имя, фамилия, email и id (из интегрируемой системы) пользователя;
для добавления нового пользователя нажимаем кнопку "Добавить" еще раз;
когда все пользователи внесены - нажмите “Продолжить” в верхнем правом углу блока.
Пример добавления пользователей вручную:
Обратите внимание, из ручного добавления можно сразу перейти в режим добавления пользователей через csv.
Если вы выбрали добавление через файл csv:
перед добавлением пользователей вы можете скачать шаблон csv файла или создать самостоятельно, следуя инструкции;
когда файл готов, нажмите добавить “через csv” - загрузите файл в систему Qolio;
после успешной загрузки аккаунтов пользователей система уведомит через всплывающее диалоговое окно о результате - нажмите “Продолжить”.
Пример добавления пользователей через csv
Подробнее о том, как заполнять CSV файл, здесь.
3. Проверка интеграции:
после загрузки пользователей и перехода по кнопке "продолжить" откроется интерфейс со всеми настройками и возможностями текущей интеграции;
внизу страницы есть блок “Тестовый запрос”, который позволяет создать тестовую коммуникацию и проверить интеграцию;
в блоке с параметрами запроса замените operator_id на id любого из добавленных вами ранее пользователей (операторов);
сделайте запрос, нажав для этого кнопку внизу в блоке;
проверьте на странице “Список коммуникации”, выставив при этом фильтр по дате коммуникации (дата должна быть такая же как и в запросе) появление коммуникации.
Пример тестового запроса
Интеграция создана!
Все созданные интеграции будут доступны в разделе "Интеграции" в личном кабинете, с той же страницы вы всегда сможете перейти вновь в интеграцию для дополнительных настроек, добавления новых пользователей или удаления интеграции.
Блоки и возможности на странице интеграции
На странице интеграции доступны следующие блоки:
Тип и название интеграции - отображает название и тип просматриваемой интеграции, в данном блоке доступна функция удаления всей интеграции.
Пользователи - отображает информацию по текущим пользователям интегрированной системы, доступны функции поиска пользователя, добавления новых новых пользователей как в ручном режиме, так и через загрузку csv. Важно знать, что при повторной загрузке через csv - текущие аккаунты будут удалены, если их нету в новом импортируемом файле.
Настройки интеграции - блок представлен двумя полями: URL и Токен, который необходим для авторизации сторонних сервисов в dealapp API при отправке запроса, в блоке есть возможность обновить токен по необходимости.
Настройки пользовательских полей - блок предназначен для создания и настройки передачи дополнительной информации про коммуникацию в систему dealapp, подробнее о возможностях и управлении читайте тут.
Тестовый запрос - блок для генерации тестовых запросов и проверке интеграции.
