integrations:pyrus-integrations:api-telephony

API-телефония: заявки из звонков и история обращений клиента

Вы можете ускорить и облегчить обработку клиентских запросов, подключив функцию создания заявки от клиента при регистрации его звонка в колл-центр. Сделать это можно с помощью методов Pyrus API.

При телефонном обращении Pyrus тут же создаст заявку, которая откроется в отдельном окне вашего браузера. Очень удобно и не нужно идти во Входящие, чтобы взять заявку в работу.

При поступлении звонка вызовите метод POST /calls, с помощью которого регистрируется звонок и создаётся заявка. При ответе оператора следует вызвать метод POST calls/event, чтобы заявка открылась в отдельной вкладке. По окончании разговора с помощью метода PUT calls в заявку добавляется информация о звонке: входящий номер, длительность и время разговора, а также его запись.

Настраиваем расширение

1. Для настройки интеграции войдите в раздел пользователя в верхнем правом углу экрана. Выберите Расширения и нажмите иконку API-телефония.

Обратите внимание: для доступа в раздел Расширения из профиля пользователя вам необходимы права Администратора.

Подробнее о правах и доступах

Подсказка: подключить функцию можно и непосредственно из выбранной формы. Для этого зайдите в раздел Формы в левом меню, выберите нужную форму:

Откройте страницу Настройка и выберите API-телефония в списке доступных расширений:

2. Выберите форму, по которой будет создаваться заявка по звонку.

В открывшемся окне нажмите Настроить.

Теперь нужно распределить входящую информацию, которая поступает в систему API-телефонии, между полями выбранной формы Pyrus. Иными словами, связать поля формы и данные API. Есть поля, которые нужно привязать обязательно, чтобы расширение работало.

Если в выбранной форме таких полей нет, создать их можно здесь же, парой кликов.

Подсказка: для поля Ответственный настройте поле типа Контакт, для входящего и принимающего номера поле типа Телефон, для времени начала и окончания звонка поле типа Время, для длительности звонка — поле типа Число.

3. Скопируйте integration GUID – уникальный идентификатор, который нужно будет передавать при вызове функции POST calls, чтобы система определяла, по какой форме создавать задачу и используйте для вызова POST calls.

Далее о методах вызова функции читайте в разделе API для разработчиков.

Как отключить или удалить расширение

Зайдите в Расширения и нажмите на подключенную форму под значком API-телефония. Внизу открывшейся страницы нажмите Приостановить.

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

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

Была ли эта статья полезной?

Да, спасибо! Нет, остался вопрос