Интеграция по API для IP-телефонии и чатов

Для того чтобы звонки и/или чаты, совершенные вашими операторами появились в 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, подробнее о возможностях и управлении читайте тут.
  • Тестовый запрос - блок для генерации тестовых запросов и проверке интеграции.