[Из песочницы] AMI. Разносторонний Originate. Применение в CTI приложении
Originate можно перевести с английского как «давать начало». Возможности команды весьма широки и не все очевидны. Originate, среди разработчиков CTI приложений — это одна из наиболее популярных команд AMI. Чаще ее используют для инициации исходящих вызовов и организации обратных звонков. В рамках данной статьи мы рассмотрим расширенные возможности.
[general]
enabled = yes
port = 5038
bindaddr = 0.0.0.0
[1cami] ;
secret=PASSWORD1cami
deny=0.0.0.0/0.0.0.0
permit=0.0.0.0/0.0.0.0
; Достаточно ограниченного набора прав.
read=call
write=originate
Далее необходимо в CLI консоли Asterisk выполнить команду:
module reload manager
Для подключения будем использовать средства telnet:
~ # telnet 127.0.0.1 5038
Asterisk Call Manager/1.2
Как только появится приглашение »Asterisk Call Manager», можно вводить команды. Первой командой должна быть авторизация.
Action: Login
Username: 1cami
Secret: PASSWORD1cami
Завершением ввода команды служит пустая строка. В случае успеха, получаем ответ:
Response: Success
Message: Authentication accepted
Базовый пример Originate
- Channel — Имя канала. Формат type/identifier. Type — тип канала, в зависимости от используемого драйвера SIP / IAX2 / DAHDI
- Context — Имя контекста для совершения вызова. Следует использовать совместно с параметрами Exten и Priority
- Exten — номер телефона, определенный в контексте «Context»
- Priority — Приоритет, позиция в Context, с которой начнеться обработка вызова
- Timeout — Таймаут в милисекундах. Если инициатор исходящего звонка не ответил, вызов будет завершен
- CallerID — значение callerid для исходящего звонка. Формат «ИмяСотрудника <НомерТелефона>»
- Variable — установка переменных для порожденных Originate каналов
- Account — Значение поля accauntcode для исходящих вызовов
- Application — команда dialplan, которая будет выолнена, используется совместно с параметром «Data»
- Async — признак асинхронного выполнения команды. Если установлен в значение »1», результат будет возвращен в пакете типа «Event» с именем «OriginateResponse»Data — Параметры команды dialplan
- ActionID — идентификатор запроса, полезно использовать при несколькоих одновренменных асинхронных запросах. Позволяет сопоставить результат с исходных запросом
Коды ответа «Event» с именем «OriginateResponse»
- 0 = Номер не найден в Context
- 1 = Нет ответа (no answer)
- 4 = Успешное выполнение (answered)
- 8 = Перегрузка или абонент не доступен (congested or not available)
Рассмотрим инициацию вызова с SIP канала 104 на номер 74952293042 в контексте from-internal:
Action: Originate
Channel: SIP/104
Context: from-internal
Exten: 74952293042
Priority: 1
Callerid: 104
Variable: SIPADDHEADER="Call-Info:\;answer-after=0"
В результате этой команды, зазвонит внутренний телефон, связанный с каналом SIP/104. После поднятия трубки, вызов пойдет на номер 74952293042 в контекст from-internal, приоритет 1.
В некоторых случаях удобно совмещать исходящий вызов с intercom, для этого следует задействовать параметр Variable.
Для Cisco, Linksys, Yealink и некоторых программных телефонов, подойдет установка переменной »SIPADDHEADER» в значение:»Call-Info:\; answer-after=0»
Допустим, на рабочем месте используется телефон Linksys. В результате Originate, сработает автоматический ответ на вызов, на телефоне, связанном с каналом SIP/104.
Перехват вызова
Все слышали о функции перехвата вызова, поступившего на соседний телефонный аппарат.
Обычно функция реализуется «старкодом» *8.
Для реализации перехвата, в dialplan можно задействовать приложение PickUp или PickupChan, сети довольно много примеров использования.
Как организовать эту функцию средствами AMI?
Для захвата вызова можно воспользоваться командой Originate. У нее есть два интересных параметра:
- Application — приложение, которое должно быть запущено
- Data — данные приложения
Опишем пример перехвата вызова, поступившего на sip аккаунт 104:
Action: Originate
Channel: SIP/104
Application: PickupChan
Data: SIP/104-0000003c
Priority: 1
Callerid: 104
Variable: SIPADDHEADER="Call-Info:\;answer-after=0"
Особенность этого Originate — нет необходимости описывать параметр «context».
Но появляется потребоность отслеживать каналы, которые мы можем перехватить. В данном примере канал описан как «SIP/104–0000003b».
Отслеживать появление новых каналов возможно в event »Newstate», где »ChannelState» установлено в значение »5» (Ringing). Ниже пример event:
Event: Newstate
Privilege: call,all
Channel: SIP/104-0000003c
ChannelState: 5
ChannelStateDesc: Ringing
CallerIDNum: 104
CallerIDName: Default Extension
ConnectedLineNum: 104
ConnectedLineName:
Uniqueid: askozia-1438348824.146
Как только поступит event »Newstate», где »ChannelState» установлено в значение »6» (Up) — на вызов уже ответили:
Event: Newstate
Privilege: call,all
Channel: SIP/104-0000003c
ChannelState: 6
ChannelStateDesc: Up
CallerIDNum: 104
CallerIDName: Default Extension
ConnectedLineNum: 104
ConnectedLineName:
Uniqueid: askozia-1438348824.146
Внимательный читатель заметит в примере некоторую несуразицу:
Action: Originate
Channel: SIP/104
Application: PickupChan
Data: SIP/104-0000003b
Ошибки нет. Вызов выполняем с Channel SIP/104, PickupChan выполняем для канала SIP/104–0000003b. То есть для своего же канала.
Прокомментирую на примере
Эту функцию мы запустили в повседневное использование. На моем рабочем месте установлен IP телефон. К телефону подключена гарнитура.
- Мне поступает входящий вызов;
- Жму кнопку «Ответить на вызов» в нашем CTI приложении;
- Выполняется описанный выше пример originate;
- Благодаря установленному «SIPADDHEADER» происходит автоответ;
- Телефон выполняет исходящий звонок и «пикапит» вызов.
Физически, я не поднимаю трубку телефона. Общаюсь с клиентом по гарнитуре. Руки свободны — профит на лицо.
Прослушать запись разговора
В некоторых случаях удобно прослушать запись разговора с телефонного аппарата в виде обратного звонка. На наш номер 104 поступит вызов. При ответе мы услышим запись разговора.
Пример AMI:
Action: Originate
Channel: SIP/104
Application: Playback
Data: /storage/usbdisk1/test_file
Priority: 1
Callerid: Playback
Variable: SIPADDHEADER="Call-Info:\;answer-after=0"
Используется приложение »Playback», в качестве данных передаем полное имя файла без расширения »/storage/usbdisk1/test_file».
Подслушать разговор
Для обучения новых сотрудников мы начали использовать необычный подход. Каждый стажер может подслушивать / прослушивать разговоры своего куратора. Благодаря этому, сотрудник быстрее начинает понимать, как построить разговор с клиентом.
В этом случае мы используем приложение »ChanSpy»:
Action: Originate
Channel: SIP/104
Application: ChanSpy
Data: SIP/105,qx
Priority: 1
Callerid: Spy-105 <105>
Variable: SIPADDHEADER="Call-Info:\;answer-after=0"
- q — «тихий режим», присоединение к разговору не анонсируется в разговор.
Присоединиться к разговору
В некоторых случаях куратору необходимо присоединиться к разговору и «вырулить» ситуацию. В этом случае используем следующий пример:
Action: Originate
Channel: SIP/104
Application: ChanSpy
Data: SIP/105,qBx
Priority: 1
Callerid: Spy-105 <105>
Variable: SIPADDHEADER="Call-Info:\;answer-after=0"
- B — оба канала могут слышать присоединившегося абонента
Режим суфлера
Куратор может присоединиться к разговору и подсказывать стажеру:
Action: Originate
Channel: SIP/104
Application: ChanSpy
Data: SIP/105,wx
Priority: 1
Callerid: Spy-105 <105>
Variable: SIPADDHEADER="Call-Info:\;answer-after=0"
- w — режим шепота, присоединившегося абонента будет слышать только канал, за которым «шпионим»
Заключение
Описанные команды отлично вписываются в CTI приложения и значительно могут улучшить удобство работы и эффективность сотрудников.
При разработке я рекомендую обратить внимание на проекты PAMI, NAMI и Shift8.
Надеюсь эта статья поможет в понимании работы команды originate, что позволит сделать ваши CTI приложения более функциональными.
