Звонки, метод: /api/registercall/
Пример:
№ | Поле | Тип | Описание | Обязательное или нет | Коментарий |
1 | login | string | Логин в системе BOX | Обязательное поле. | |
2 | password | string | Пароль в формате md5 | Обязательное поле. | Напишите в техподдержку и мы выдадим вам hash для API |
3 | channel | string | Канал звонка (идентификатор звонка) | Обязательное поле. | |
4 | status | string | Статус звонка | Обязательное поле. | Звонок может создатся со статусами: LOCAL, INCOMING, OUTGOING, TRANSFER. Если вы передадите статусы завершающего звонка (CANCEL, ANSWER, CONGESTION, CHANUNAVAIL, BUSY, INVALID, TRANSFER), то звонок закроется. Подробно о каждом статусе: LOCAL - Локальный звонок (внутрений) INCOMING - Входящий звонок OUTGOING - Исходящий звонок TRANSFER - Звонок переведён CANCEL - caller положил трубку ANSWER - Есть ответ на звонок (есть разговор) CONGESTION - линия перегружена CHANUNAVAIL - линия недоступна BUSY - линия занята NOANSWER - callee не ответил на звонок INVALID - некорректный номер/перевод |
5 | caller | integer | Кто звонит (номер телефона) | Обязательное поле. | |
6 | callee | integer | Кому звонит (номер телефона) | Не обязательное поле. | Если не указывать тут ничего то система при входящем звонке будет подставлять сюда номера по умолчанию |
7 | pickup | integer | кто поднял трубку при групповом звонке | Не обязательное поле. | |
8 | duration | integer | длительность вызова | Не обязательное поле. | Передавайте сюда длительность звонка при зарешающих статусах (CANCEL, ANSWER, CONGESTION, CHANUNAVAIL, BUSY, INVALID, TRANSFER) |
8 | filename | string | Путь и имя аудио файла при звонках | Не обязательное поле. | Передавайте сюда имя аудиофайла звонка при зарешающих статусах (CANCEL, ANSWER, CONGESTION, CHANUNAVAIL, BUSY, INVALID, TRANSFER) |
9 | comment | text | Комментарий к звонку | Не обязательное поле. | Комментарий к звонку будет записан как описание события |
10 | closed | bool | Закрыть звонок и всплывающее окно | Не обязательное поле. | Не обязательное поле.Если будет передан аргумент closed=1 то окно закроется, если closed=0 то нет (это все при статусах звонка ANSWER или CANCEL или CONGESTION или CHANUNAVAIL или BUSY или INVALID) . Так же рекомендуется передавать closed=0 в момент когда начался разговор |
Возможные варианты ответа на запрос
№ | Статус | Сообщение | Описание сообщения |
1 | ok | Регистрация звонка прошла успешно | |
2 | fail | Login is empty! | Отсутствует логин |
3 | fail | Password is empty! | Отсутствует пароль |
4 | fail | Login or password not correct! | Неправильный логин или пароль |
5 | fail | Bad user level! | Низкий уровень пользователя, для выполнения данного действия(нужен level 2 и выше) |
6 | fail | No channel | Отсутствует канал звонка |
7 | fail | No status | Отсутствует статус звонка |
8 | fail | No caller | Отсутствует номер звонившего |