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 endpoint, который вы можете найти в настройках интеграции приложения. Вам нужно сделать POST запрос на этот API endpoint в документе JSON и передать Authorization Token в headers. Authorization Token также можно найти в диалоге настройки интеграции.
# значение 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
Вещи, на которые следует обратить внимание: