HTTP интерфейс active_calls¶
Возвращает список текущих активных звонков, которые поступают на внутренние телефоны, для данной учетной записи.
Обычно этот API используется в режиме опроса каждые 5-10 секунд CRM системами.
При обнаружении входящего звонка, CRM система может отображать Карточку контакта.
Обязательные аргументы¶
аргумент | описание |
_login | совпадает с логином пользователя/компании к личному кабинету |
_password | совпадает с паролем пользователя/компании к личному кабинету |
Возвращаемые данные¶
status | "ok", если операция завершилась без ошибки, "error", если произошла ошибка, или если не удалось вернуть полезные данные |
data | полезные данные, когда status = "ok" |
errors | ошибки, когда status = "error" |
calleridnum | внутренний номер, на который идет вызов |
connectedlinenum | номер звонящего |
connectedlinename | имя звонящего |
state | состояние звонка |
uniqueid | уникальный ID звонка, соответствует uniqueid из cdr и recordings |
Пример¶
запрос | GET "https://имя.вашего.сервера/api/active_calls?_login=LOGIN&_password=PASSWORD" |
ответ | { "data" : [ { "calleridnum" : "12123388100", "connectedlinenum" : "123737373737", "connectedlinename" : "John", "state" : "Ringing", "uniqueid" : "121223123.333" }, { "calleridnum" : "12124599066", "connectedlinenum" : "123445435567", "connectedlinename" : "Michael", "state" : "Ringing", "uniqueid" : "12122545.334" } ], "status" : "ok" } |