Для чего используется и как работает

Custom HTTPS (подключение через API Qolio) удобный инструмент, если вы хотите загружать свои звонки с внешнего сервиса через API. Он хорошо подойдет, если вы строите свою телефонию на базе таких продуктов как Oktell или Asterisk и у вас есть специалисты, которые занимаются поддержкой этих решений. Либо это решение поможет вам интегрироваться, если вы разрабатываете свое решение для телефонии или CRM.

Мы сотрудничаем с организациями, которые могут реализовать такую интеграцию для вас. Чтобы обсудить все детали, свяжитесь с нашим отделом продаж.

Общие сведения для подключения Oktell можно найти тут: https://www.notion.so/dealapp/Oktell-2716c45ab22f4969ac1c6f57ca6e8b61

При подключении Asterisk очень часто используется подход, когда с какой-то периодичностью запускается cron скрипт, который вытаскивает новые данные из базы и передает их через Custom HTTPS интеграцию (API) в Qolio.

Тут можно найти пример скрипта для подключения телефонии в Asterisk https://www.notion.so/dealapp/Asterisk-a36b9fb15734454eaf02902e49065cb5

Как установить и настроить интеграцию в приложении

<aside> 💡 В этой части находятся ссылки, которые помогут разобраться в настройке интеграции

</aside>

API запроса для регистрации звонка

Звонок создается через API endpoint, который вы можете найти в настройках интеграции приложения. Вам нужно сделать POST запрос на этот API endpoint в документе JSON и передать Authorization Token в headers. Authorization Token также можно найти в диалоге настройки интеграции.

Пример запроса с помощью утилиты curl

# значение AUTHORIZATION_TOKEN берется из модального диалога интеграции (Токен интеграции)
export AUTHORIZATION_TOKEN="0b23ffc3e579f863288f4462c8..."
# значение INTEGRATION_URL берется из модального диалога интеграции (URL интегрируемого приложения)                                       
export INTEGRATION_URL="<https://api.prod1.qolio.ru/api/v1/integrations/c34f637a-..../phone_calls>"  

curl --header "Content-Type: application/json" \\
     --request POST \\
     --header "Authorization: $AUTHORIZATION_TOKEN" \\
     --data '{
         "operator_id": "[email protected]",
         "started_at": "2020-06-21T09:51:13.588Z+03",
         "direction": "incoming",
         "duration": 410.1,
         "client_phone_number": "+375332222453",
         "media_url": "<https://file-examples.com/wp-content/uploads/2017/11/file_example_WAV_1MG.wav>",
         "uid": "7b2331ca-adcb-4f15-811b-6b6cfddb2baf",
         "client": {
            "id": "[email protected]",
            "company_name": "Test Company",
            "first_name": "John",
            "last_name": "Doe"
         },
         "custom_fields": {
           "opened_at": "2020-06-21T09:51:13.588Z",
           "reopen_count": 5,
           "topic": "Поддержка",
           "sub-topic": "Возобновление доступа"
         }
     }' \\
     $INTEGRATION_URL

Описание полей JSON документа

Возможные типы custom-fields

Вещи, на которые следует обратить внимание: