Api управление sip телефона
Введение История Asterisk API и Основные понятия в ARI Операции и их категории Настройка ARI на стороне Asterisk Введение С появлением Asterisk 12 в 2013 году был представлен Asterisk REST Interface – набор правил REST API для создания своих правил обработки вызовов на базе Asterisk. Данная статья поможет вам разобраться с Asterisk API, а также […]
С появлением Asterisk 12 в 2013 году был представлен Asterisk REST Interface – набор правил REST API для создания своих правил обработки вызовов на базе Asterisk. Данная статья поможет вам разобраться с Asterisk API, а также настроить и запустить его на PBX.
Изначально Asterisk разрабатывался, как самостоятельный программный комплекс соединения телефонных линий. Настройка такой конструкции осуществлялась с помощью конфигурационных файлов, а управление вызовами — через определенный conf файл (extensions.conf), вся логика сокращенно называется «диалпланом». Пока пользовались АТС, возникали потребности, требующие нестандартного подхода, выходящего за рамки использования встроенных функций и приложений диалплана. Для этого программистами разрабатывались отдельные модули на языке C, получающие доступ к данным каналов, медиа, бриджей и конечных устройств. При разработке многих нюансов — не предусмотришь, поэтому возникали баги и недочеты в кастомных модулях, что приводило к краху системы. Для этого были разработаны два интерфейса, AMI и AGI, управления приложениями диалплана, а также получения мета-данных с каналов, устройств и т. д.
AGI – аналог CGI в Apache. AGI является прослойкой между диалпланом Asterisk и внешней программой, управляющей каналом. Это синхронный интерфейс выполняющий действия на канале и возвращающий результаты, пока не завершится процесс.
AMI – асинхронный событийный интерфейс, позволяющий отслеживать информацию о происходящих процессах в Asterisk, также выполнять и изменять объекты Asterisk. В отличии от AGI. Сессия подключения стороннего приложения устанавливается по протоколу TCP/IP. В конфигурационных файлах Asterisk по умолчанию — это порт подключения 5038. Что позволяет отправлять астериску запрос, на что склиенсткая программа получает ответ-событие.
Из этого следует вывод:
- AGI блокирует поток в Астериске, пока не закончится действие.
- В AGI невозможно отслеживание событий DTMF, состояния канала и т. д.
- Интерфейсы AMI и AGI морально устарели.
Поэтому было принято решение объединить AGI и AMI, так и появился Asterisk REST Interface (ARI).
Основной замысел ARI интерфейса заключается в следующем:
- Использование как остлеживания и изменения состояния звонка, так и вызов функций диалплана
- Интерфейс работает асинхронно
- Выдает значения по типам — каналы, медиа-потоки, бриджы, устройства и т. д.
- Данные отображаемых групп передаются через WebSocket в формате JSON
Существует три основных понятия в ARI, они как аксиомы в математике:
- RESTful интерфейс, используемый клиентской стороной для управления вызовами
- WebSocket, передающий события клиенту в JSON формате
- Приложение, используемое в диалплане, Stasis. Управление вызовом передаётся клиентскому приложению.
Пример использования приложения Stasis:
RESTful — архитектурный стиль для взаимодействия с программными компонентами.(вики)
WebSocket —относительноновый протокол связи клиентской стороны с сервером в режиме realtime. В случае с ARI, вебсокет используется для асинхронной передачи событий от астериска к киенту.
Stasis – позволяет через диалплан астериска передать управление каналом внешнему приложению.
Для подключения IP-телефонии к 1С обычно используются внешние компоненты, такие как, например:
Плюсами таких решений является универсальность и простота запуска (при настроенной АТС). Сложности возникают, когда требуется какой-то более-менее сложный алгоритм обработки звонка, который зависит от данных CRM-системы. Так же сложности возникают из-за того, что обраотка звонка в подобных решения идет не централизованно, а на конкретных рабочих местах пользователей, где установлена специализированная компонента. В этой публикации описано, как можно обработку звонков "повесить" на сервер 1С, который уже будет определять, на кому из менеджеров перевести звонок.
Исходящие звонки
Тут нет ничего сложного.
В настройках необходимо прописать код клиента и ключ интеграции
Которые мы можем посмотреть в личном кабинете облачной АТС Sipuni
При записи настроек автоматически создастся свойство "Внутренний номер" у справочника пользователей - это внутренние телефонные номера, которые присваиваются в личном кабинете АТС. Необходимо будет у пользователей, которые будут совершать звонки, заполнить внутренние телефонные номера.
Все, можно звонить. Нажимаем "Заполнение - Позвонить через Sipuni", появляется список доступных телефонных номеров клиента, выбираем номер. При этом автоматически АТС вызывает наш софтфон (я использую Zoiper, он бесплатный и удобный), нажимаем снять трубку, после чего начинается дозвон клиенту. Выглядит это примерно так:
Сразу хочу предупредить, что данное решение не является полностью готовым модулем, а представляет собой концепт, который хоть и является работоспособным, но требует настройки специалистом уже под конкретное предприятие. Модуль представляет собой расширение конфигурации.
Далее необходимо указать URL, куда будет "стучаться" облачная АТС. В качестве адреса необходимо ввести следующую строку:
- fromnum - с какого номера пришёл вызов
- tonum - на какой номер пришёл вызов
- time - время прихода вызова в АТС
Обработчик скрипта ищет телефонный номер по всем телефонным номерам, содержащимся в базе в:
- Партнерах
- Контактных лицах партнеров
После того, как будет найден партнер, определяется основной менеджер по данному партнеру, и его внутренний телефонный номер. В ответе АТС отправляется найденный внутренний номер, после чего АТС предпринимает попытку перевести звонок на этот внутренний номер.
В это время в 1С создается документ "Телефонный звонок", и записывается "Напоминание пользователю" для указанного основного менеджера. У менеджера должна быть запущена встроенная обработка "Помощник продаж" (автоматическое открытие этой обработки можно настроить в Администировании) - именно в ней производится мониторинг входящих звонков. Создатели 1С обещают вскоре выпуск платформы, в которой будет механизм оповещения клиентских машин со стороны сервера 1С. Это будет существенный прорыв вперед, а пока что приходится действовать по-старинке. В обработке запускается обработчик ожидания, который каждые 5 секунд мониторит, не появилось ли у текущего пользователя напоминаний о "Телефонных звонках", и при обнаружения выводит на экран документ "Телефонный звонок", содержащий информацию о звонящем в данный момент клиенте.
Для менеджера этот процесс выглядит примерно так:
Протестировано на релизе 1С УТ 11.4.2.144
Расширение для 1С УТ 11, позволяющее принимать звонки в 1С Внешняя обработка для звонков из 1С УТ 11 через SipuniСпециальные предложения
Просмотры 23726
Загрузки 29
Рейтинг 11
Создание 03.05.18 08:16
Обновление 01.11.18 17:35
№ Публикации 825491
Тип файла Расширение (cfe)
Операционная система Не имеет значения
Вид учета Не имеет значения
Доступ к файлу Абонемент ($m)
Код открыт Да
Основная цель - дать базовые знания по управлению проектами и показать, как их применять на реальных проектах. Мы будем фиксироваться на тех инструментах, которые реально оказываются полезными в практике руководителей проектов внедрения. Базовый курс по управлению ИТ-проектами. 18 января - 22 марта 2022 года. 10 поток.См. также
SIP телефон(софтфон) для 1С:Предприятия 8 и IP АТС (виртуальная и офисная) Промо
«АТС.Ринголайн» и «Ringophone» - это современный взгляд, комплексное решение для организации телефонии в офисе, которое работает прямо из коробки. Решения направлены на организации, где главный упор сделан на коммуникацию и взаимоотношения с клиентами. RingoPhone 1С - это бесплатный sip телефон, выполненный в виде внешней обработки для 1С. Данная панель телефонии разработана для любых конфигураций 1С:Предприятия 8. RingoPhone работает с АТС на базе Asterisk и провайдерами, которые поддерживают SIP протокол. IP телефония набирает огромную популярность и всё больше возможностей открывается при объединении телефонии и CRM системы. Возможность встроить телефон в свою CRM систему, позволяет осуществлять управление не только на уровне АТС, но и на уровне самого телефона. АТС.RingoLine изначально создавалась с учётом интеграции с современными CRM системами. CRM системам доступно менять любые настройки АТС. Такие как: создание пользователей, добавление и удаление операторов колл-центра, возможность задавать переадресацию сотрудникам, получать информацию о звонках с АТС, а возможность доработки позволит заложить новые алгоритмы распределения звонков по сотрудникам в зависимости от данных в CRM системе.
1 стартмани
04.06.2013 59531 476 ringoline_ru 88
Обработка "ZVONOBOT API" это рабочий шаблон для генерации телефонных звонков клиентам по списку вопросов с сервера «zvonobot».
1 стартмани
27.07.2021 1344 1 ash2015 0
Модуль интеграции с системой Unibell Flash Call - доставка кодов подтверждения клиенту посредством телефонного звонка
Пример использования сервиса доставки кодов Unibell Flash Call, который представляет собой альтернативу отправки кодов посредством СМС - кодом служат последние 4 цифры телефонного номера, с которого пришел звонок.
5 стартмани
21.06.2021 2041 0 Miket78 0
Чтение звонков из облачной АТС Билайн
Обработка, показывающая возможность чтения звонков из облачной АТС Билайн.
1 стартмани
20.10.2020 2703 8 mihco 0
1 стартмани
17.09.2014 95537 547 vano-ekt 59
Загрузка истории звонков Mango
Обработка загрузки истории звонков для обычных форм (любые конфигурации).
1 стартмани
29.07.2020 3260 4 ketr 0
Быстрый вызов из карточки сделки через Asterisk
Как из формы сделки в УТ 11 позвонить контактному лицу контрагента? Надо открыть вкладку «Участники» или ссылку «Окружение сделки», выбрать контрагента, открыть список контактных лиц, найти нужное, открыть его форму, перейти во вкладку «Адреса и телефоны» и там нажать кнопку звонка. Долго. Надо в 2 клика.
1 стартмани
19.09.2019 6836 3 soulner 0
Чтение файлов с SFTP АТС Askozia 500444
Небольшая обработка для чтения файлов wav и txt с sFTP.
1 стартмани
13.08.2019 6851 2 ah7777777 3
Пошаговая установка сервера телефонии FreePBX Distro и настройка для работы с 1C и не только. Промо
И так приступим…. У меня старый компьютер с конфигурацией : CPU-Intel Pentium 4, 3000 MHz, DDR SDRAM-2048 Mb, Video GF 9400 512 Mb, HDD 80 Gb, CD-ROM, сетевая встроенная карта 100 м/бит. Можно еще проще конфигурацию…… Хватит для фирмы 1-50 SIP абонентов, GSM trunk, Skype и т.д. Так же у меня две аналоговых линии местной АТС FXO (Grandstream HT-503 и Unicorn 3112) и 4-е оператора GSM (MTS ,Megafon, BeeLine, Tele 2) . В качестве GSM-шлюза использую модемы Huawei E171 и USB HUB D-Link DUB-H7. К серверу можно прикрутить видео наблюдение, домофон или другое устройство имеющее IP адрес, но это в следующей статье, если хватит сил и терпения.
1 стартмани
23.12.2013 44973 126 APS1968 14
Загрузка записей телефонных звонков из Asterisk
Как и обещал, вторая часть моей реализации взаимодействия с АТС Asterisk из Управления торговлей 11, а именно загрузка записей телефонных разговоров в качестве прикреплённого файла к документу Телефонный звонок.
1 стартмани
28.07.2019 9264 9 soulner 8
Звонок из карточки контакта через Asterisk без внешних компонент
Не спешат, к сожалению, разработчики 1С интегрировать Управление торговлей с IP-телефонией. Есть решения от сторонних производителей, но они сильно платные и используют механизм внешних компонент. А было бы круто, если бы можно было сразу позвонить из карточки контактного лица и тут же заполнить форму звонка, и всё это без привязки к Windows… Эх, мечты!
1 стартмани
01.07.2019 32634 28 soulner 39
Манго API. Звонок из 1С и получение списка звонивших
Пример работы с АТС Манго из обработки. Доступно для любой конфигурации на управляемых формах. Возможно: Получение истории звонков за период, Звонок из 1С от любого пользователя (нужен внутренний номер телефона сотрудника) .
1 стартмани
25.03.2019 8962 43 p.ugrumov 9
Asterisk без внешних компонент? Промо
1 стартмани
03.05.2013 54536 214 oleg.rizvanov 23
Пример интеграции 1С и АТС типа Asterisk штатными средствами 1С
Пример реализации обработки событий звонков АТС на базе Asterisk, без dll и других сторонних средств.
1 стартмани
21.03.2019 15825 52 Mouros 13
DLL для подключения к Asterisk (32/64 клиенты)
Подключение к Астериску и получение событий "Newchannel","BridgeEnter","Hangup" через ОбработкаВнешнегоСобытия.
1 стартмани
19.03.2019 11771 19 xxxAndricxxx 14
Интеграция Альфа-авто с телефонией (Простые звонки)
Появилась необходимость интеграции Рарус Альфа-авто 5 с телефонией. По ряду причин от использования встроенного в конфигурацию "Рарус СофтФон" клиент отказался. В итоге был выбран удобный для клиента оператор SIP телефонии. Интеграцию с 1С выбранный оператор предлагает через решение Простые звонки (как и многие другие операторы). Готового решения для Альфа-авто не оказалось. В итоге оптимизировали обработку для УТ 10.3.
1 стартмани
26.02.2019 14570 16 de0nis 0
1С + CoMagic
Делимся опытом: интегрировали 1С и ВАТС CoMagic. Стандартные механизмы и Calltracking.
1 стартмани
14.02.2019 9171 17 medangel 3
Быстрая интеграция Билайн (облачная АТС) с 1С
В этой публикации рассмотрено, как быстро сделать вызов (интегрировать с 1С) Облачную АТС Билайн через ее API.
1 стартмани
18.12.2018 9362 17 tva120 6
Распознавание телефонных звонков с помощью речевых технологий Yandex SpeechKit (новая версия Yandex SpeechKit Cloud и Yandex Object Storage)
Обработка позволяет преобразовывать телефонный звонки формата wav в текст с помощью речевых технологий Яндекса. Дополнительно в обработке реализована нарезка телефонного звонка на кусочки по 1 Мб с помощью SOX. Загрузка дополнительных данных по звонку из программы SpRecord. Использовал на нетиповой конфигурации Управление торговлей 10.3.
1 стартмани
23.01.2018 24837 32 zzhiraf_ 21
Доступ к Cisco AXL из 1С
Пишем запросы к IP-телефонии Cisco Unified Communications Manager (CUCM).
1 стартмани
20.12.2017 12836 12 igormiro 0
Подключение к API телефонии ЭНФОРТА
Подключение к API телефонии ЭНФОРТА с привязкой к событию по номеру телефона.
3 стартмани
12.12.2017 10797 0 mi4asib 0
Интеграция 1С и системы IP телефонии Binotel
Интеграция 1С и системы IP телефонии Binotel (Украина)
1 стартмани
11.08.2017 17657 45 bulpi 16
Внешняя компонента RBSCaller.dll для интеграции с 3CX Phone System
Внешняя компонента для 1С: 8.x, позволяющая производить звонки, получать оповещения о входящих через механизм внешних событий 1С.
2 стартмани
12.10.2016 19480 19 RBS 8
25.07.2016 59336 serg_infostart 19
Если вы ничего не понимаете в WEB технологиях и такие слова, как json, get, post и прочее для вас ничего не значат и вы просто заядлый 1С-ник до мозга костей, но вам кровь из носу надо подружить 1С со сторонними приложениями или сайтом, то эта статья для вас
21.04.2016 161225 YAGolova 64
Управление Asterisk конференцией из 1С
Пример интеграции 1С и Asterisk для управления конференциями.
1 стартмани
17.03.2016 22068 17 lakhnov.alexander 6
Голосовой ввод в 1С (Asterisk + Yandex speechkit + php)
Пример того, что можно получить, подружив телефонию на базе Asterisk и 1С.
1 стартмани
05.01.2016 25730 40 lakhnov.alexander 4
Взаимодействие 1С и стационарных телефонов семейства yealink
API позволяет подключить к ПланФикс любую вашу собственную Облачную АТС.
Интеграция ПланФикса и Облачной АТС решает несколько бизнес-задач:
- получение имени звонящего по номеру телефона, для того, чтобы его можно было отобразить на экране телефона или sip-клиента;
- автоматическая маршрутизация входящего звонка от клиента на менеджера, который закреплен за этим клиентом;
- отображение информации о входящем звонке непосредственно внутри ПланФикса (всплывающее окно при звонке)
- сохранение в ПланФиксе истории всех звонков и записей разговоров;
- совершение исходящих звонков сразу из интерфейса ПланФикса.
Интеграция должна быть двухсторонней. Поэтому часть запросов ПланФикс посылает в сторону Облачной АТС на указанные точки входа, а часть запросов, наоборот, Облачная АТС посылает в сторону ПланФикса на единую точку входа.
Принцип авторизации и взаимодействия
- Дополнительно для авторизации каждого запроса к ПланФиксу используется специальный ключ (token). Получить его можно в настройках интеграции.
- Пожалуйста, реализуйте прием запросов на стороне АТС также с использованием ключа (token). Сгенерируйте ключ и вставьте его в соответствующее поле в разделе настройки интеграции.
- Ключи создаются один раз при настройке интеграции. При необходимости, вы можете сменить ключ на своей стороне и обновить его интерфейсе ПланФикса.
Запросы от Облачной АТС к ПланФиксу:
- Запросы необходимо отправлять на указанный в настройках интеграции адрес для приема уведомлений.
- В теле запроса в специальном поле «token» необходимо всегда передавать специальный ключ.
- Запросы передаются в application/x-www-form-urlencoded формате
Запросы от ПланФикса к Облачной АТС:
- Все ответы на запросы Облачной АТС ПланФикс присылает в формате JSON в теле ответа.
- Все ответы на запросы ПланФикса Облачная АТС должна присылать в формате JSON в теле ответа.
Подключение в интерфейсе ПланФикса
Для подключения и настройки интеграции перейдите в раздел Интеграции - Виртуальные АТС
В открывшемся разделе выберите Api ПланФикса для телефоний (в конце списка).
Откроется окно настроек интеграции.
Из него необходимо будет взять адрес для отправки запросов в ПланФикс (он свой для каждого аккаунта) и токен (planfix_token в запросах к ПланФиксу), и указать в нём данные АТС - адрес, куда ПланФикс будет слать запросы, и ключ авторизации АТС (параметр token в запросах к АТС)
Список команд API
От ПланФикса к Облачной АТС:
От Облачной АТС к ПланФиксу:
- contact (POST)
- event (POST)
- record (POST)
Команды API и примеры доступных сценариев
Команды от ПланФикса к Облачной АТС
makeCall
Команда необходимая для того, чтобы инициировать звонок от менеджера клиенту. В результате успешного выполнения команды, Облачная АТС сделает сначала звонок на телефон менеджера, а потом соединит его с клиентом. Команда используется для звонка по клику на номер клиента в ПланФиксе.
Параметры запроса:
| Имя | Описание | Тип/формат данных | Примечание |
|---|---|---|---|
| cmd | тип операции, в данном случае makeCall | string | |
| from | короткий номер сотрудника осуществляющего исходящий вызов | string | |
| to | номер, на который делается исходящий вызов | string | |
| token | ключ (token) Облачной АТС, установленный в настройках интеграции | string |
Пример запроса:
Варианты ответа:
| HTTP код | Тело | Описание |
|---|---|---|
| 200 | ОК | |
| 400 | Переданы некорректные параметры | |
| 401 | Передан неверный ключ (token) |
setup
Параметры запроса:
| Имя | Описание | Тип/формат данных | Примечание |
|---|---|---|---|
| cmd | тип операции, в данном случае setup | string | |
| token | ключ (token) Облачной АТС, установленный в настройках интеграции | string | |
| planfix_token | ключ (token) ПланФикса, указанный в настройках интеграции | string | |
| planfix_url | адрес для отправки запросов в ПланФикс | string |
Пример запроса:
Команды от Облачной АТС к ПланФиксу
contact
Команда для получения информации о названии клиента и ответственном за него сотруднике по номеру его телефона.
Команда может использоваться для отображения на экране IP-телефона или в коммуникаторе на ПК сотрудника названия клиента. Также она может использоваться для перенаправления звонков от клиентов ответственному сотруднику, указанному в ПланФиксе
Параметры запроса:
| Имя | Описание | Тип/формат данных | Примечание |
|---|---|---|---|
| cmd | тип операции, в данном случае contact | string | |
| phone | номер контакта | string | |
| callid | уникальный id звонка | string | необязательный |
| planfix_token | ключ (token) ПланФикса, указанный в настройках интеграции | string |
Пример запроса:
Варианты ответа:
| HTTP код | Тело | Описание |
|---|---|---|
| 200 | responsible - короткий номер ответственного пользователя, может отсутствовать, если такого нет или у него не задан короткий номера | |
| 400 | Переданы некорректные параметры | |
| 401 | Передан неверный ключ (token) |
event
Облачная АТС отправляет в ПланФикс уведомления о событиях звонков: появлении, принятии или завершении звонка, а также информацию о звонке при его завершении. Команда используется для отображения всплывающей карточки звонка в интерфейсе.
Данные о продолжительности и результате звонка при завершении используются для фиксации данных звонка в аналитике (будет реализовано в скором времени), а также для понимания того существует ли запись звонка и стоит ли ПланФиксу рассчитывать её получить.
Параметры запроса:
- INCOMING - пришел входящий звонок (в это время у менеджера должен начать звонить телефон).
- OUTGOING - начался исходящий звонок.
- ACCEPTED - звонок успешно принят (менеджер снял трубку).
- COMPLETED - звонок завершен (менеджер или клиент положили трубку после разговора).
- Success - успешный входящий звонок
- Missed – пропущенный входящий звонок
- Cancelled - отмененный входящий звонок (трубку снял другой сотрудник и т.п.)
статус исходящего звонка:
- Success - успешный исходящий звонок
- Busy - АТС получила ответ Занято
- NoAnswer - Не дождались ответа
- NotAvailable - АТС получила ответ Абонент недоступен
- NotAllowed - Звонки на это направление запрещены
Пример запроса:
Варианты ответа:
| HTTP код | Тело | Описание |
|---|---|---|
| 200 | ОК | |
| 400 | Переданы некорректные параметры | |
| 401 | Передан неверный ключ (token) |
record
Уведомление содержит информацию о записи разговора. ПланФикс ожидает такого уведомления, если в команде event с event=COMPLETED и is_recorded=1 отсутствует параметр record_link. Использовать уведомление имеет смысл, если сохранение записей в Облачной АТС устроено таким образом, что ссылка может быть сформирована только через некоторое время.
Ссылка должна быть постоянной, для того чтобы в зависимости от настроек интеграции:
Ваше приложение становится интегрированным с лидирующей системой облачной телефонии.
Пользователи вашего приложения получают доступ к богатому функционалу виртуальной АТС MANGO OFFICE, полезному сотрудникам и руководству отделов продаж, маркетинга, технической поддержки, клиентского обслуживания, аналитики
Вы — поставщик сервисов интеграции
Вы можете оказывать услуги интеграции
Вы можете интегрировать множество приложений с лидирующей на рынке телефонной системой.
Смотрите условия сотрудничества
Почему MANGO OFFICE
Широкие возможности API
MANGO OFFICE – уверенный лидер рынка облачных коммуникаций
Среди наших клиентов большой спрос на интеграционные решения
Богатый функционал облачной телефонии MANGO OFFICE
Широкие возможности API
Множество функций, включая:
- Звонок из приложения одним кликом
- Автоматически всплывающую карточку звонка
- Передачу в приложение данных коллтрекинга и статистики звонков
- Хранение в приложении записей разговора, отсортированных по проектам
- Автоматическую переадресацию звонка клиента персональному менеджеру
- SMS рассылки
- Уведомления о персональных и групповых пропущенных вызовах
MANGO OFFICE – уверенный лидер рынка
облачных коммуникаций
Мы предоставляем услуги бизнес-телефонии более 40 000 компаний (на конец 2017 г.).
Каждый месяц мы подключаем более 1 000 новых предприятий-клиентов.
Среди наших клиентов большой спрос
на интеграционные решения
Мы лидеры не только по числу клиентов, но и по возможностям телефонной системы.
MANGO OFFICE имеет в составе множество алгоритмов распределения вызовов, богатую аналитику, управление звонками в реальном времени, функционал кол-центра.
Поэтому нашими клиентами в первую очередь становятся предприятия, которые уделяют большое внимание формированию рабочих процессов и поддержке процессов ИТ системами. Среди них высокий спрос на интеграционные решения.
Читайте также: