# Интеграция по API для IP-телефонии и чатов Для того чтобы звонки и/или чаты, совершенные вашими операторами появились в Qolio, необходимо настроить интеграцию вашей IP-телефонии и/или системы управления чатами и dealapp. Интегрировать систему по API вы сможете самостоятельно в личном кабинете с правами администратора, следуя простым шагам в инструкции. #### Этапы настройки интеграции: 1\. Выбор типа интеграции: * войдите в аккаунт администратора вашей компании в сервисе - пройдите в “Личный кабинет”; * в меню личного кабинета слева выберите раздел - “Интеграции” - затем нажмите на кнопку “Добавить интеграцию”; * на странице создания интеграции, которая откроется после нажатия на кнопку, необходимо выбрать настраиваемый вами *тип интеграции*: “API-телефония” или "API для текстовых коммуникаций"; * после выбора типа укажите название интеграции в соседнем поле - и нажмите “Продолжить”. Пример настройки первого этапа: ![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_24de7cj4mk_c9ec434882b2eef22e55c144cdd2211b752957f6009e626c885c912ab62ad00c.png) 2\. Добавление пользователей: * после нажатия кнопки “Продолжить” откроется страница добавления пользователей с выбором способа: *вручную или через csv файл* * выберите подходящий для вас способ Если вы выбрали добавление вручную: * в открывшемся интерфейсе нажмите “Добавить”, чтобы внести пользователей и заполните поля: имя, фамилия, email и id (из интегрируемой системы) пользователя; * для добавления нового пользователя нажимаем кнопку "Добавить" еще раз; * когда все пользователи внесены - нажмите “Продолжить” в верхнем правом углу блока. Пример добавления пользователей вручную: ![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_s7st3dik1j_7f9a2a9fdf5195d1d88d5b3eadb8192ea887a1c0c1b764bb6f198b91d61208d8.jpeg) Обратите внимание, из ручного добавления можно сразу перейти в режим добавления пользователей через csv. **Если вы выбрали добавление через файл csv:** * перед добавлением пользователей вы можете скачать шаблон csv файла или создать самостоятельно, следуя инструкции; * когда файл готов, нажмите добавить “через csv” - загрузите файл в систему Qolio; * после успешной загрузки аккаунтов пользователей система уведомит через всплывающее диалоговое окно о результате - нажмите “Продолжить”. Пример добавления пользователей через csv ![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_odgf7oj12r_cbef910074e3964963f10d4895906ac0d4e056e4e274fc5b1e7a182d4a5d24c3.png) Подробнее о том, как заполнять CSV файл, [здесь](/qolio-or-baza-znanii/integracii/podklyuchenie-po-api/sozdanie-csv-faila-dlya-dobavleniya-polzovatelei-pri-integracii-po-api.md). 3\. Проверка интеграции: * после загрузки пользователей и перехода по кнопке "продолжить" откроется интерфейс со всеми настройками и возможностями текущей интеграции; * внизу страницы есть блок “Тестовый запрос”, который позволяет создать тестовую коммуникацию и проверить интеграцию; * в блоке с параметрами запроса замените *operator\_id* на *id* любого из добавленных вами ранее пользователей (операторов); * сделайте запрос, нажав для этого кнопку внизу в блоке; * проверьте на странице “Список коммуникации”, выставив при этом фильтр по дате коммуникации (дата должна быть такая же как и в запросе) появление коммуникации. Пример тестового запроса ![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_t3s777064f_ef04a7bd4ee9ad3489e96327dab56517275d04ba54df38d0a74eea10a5b86212.jpeg) Интеграция создана! Все созданные интеграции будут доступны в разделе "Интеграции" в личном кабинете, с той же страницы вы всегда сможете *перейти вновь в интеграцию для дополнительных настроек, добавления новых пользователей или удаления интеграции.* Блоки и возможности на странице интеграции На странице интеграции доступны следующие блоки: * Тип и название интеграции - отображает название и тип просматриваемой интеграции, в данном блоке доступна функция удаления всей интеграции. * Пользователи - отображает информацию по текущим пользователям интегрированной системы, доступны функции поиска пользователя, добавления новых новых пользователей как в ручном режиме, так и через загрузку csv. Важно знать, что при повторной загрузке через csv - текущие аккаунты будут удалены, если их нету в новом импортируемом файле. * Настройки интеграции - блок представлен двумя полями: URL и Токен, который необходим для авторизации сторонних сервисов в dealapp API при отправке запроса, в блоке есть возможность обновить токен по необходимости. * Настройки пользовательских полей - блок предназначен для создания и настройки передачи дополнительной информации про коммуникацию в систему dealapp, подробнее о возможностях и управлении читайте [тут](/qolio-or-baza-znanii/integracii/podklyuchenie-po-api/sozdanie-i-upravlenie-polzovatelskimi-polyami-pri-integracii-po-api.md). * Тестовый запрос - блок для генерации тестовых запросов и проверке интеграции. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.qolio.ru/qolio-or-baza-znanii/integracii/podklyuchenie-po-api/integraciya-po-api-dlya-ip-telefonii-i-chatov.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.