Project

General

Profile

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" 
}

English translation

Also available in: PDF HTML TXT