API OnlinePBX нужен, когда штатных интеграций не хватает: у вас самописная CRM, учёт ведётся в 1С, звонки нужно связать с хелпдеском или собрать в собственный отчёт. Через REST API и вебхуки АТС отдаёт события звонков, историю и записи разговоров, а также принимает команды — например, позвонить клиенту по клику из вашей системы. Разбираем, какие данные доступны, какие задачи на них решают и как оценить проект интеграции, чтобы не переплатить.
- С amoCRM, Битрикс24 и ещё 30+ CRM OnlinePBX работает через штатные интеграции — разработка не нужна.
- API нужен для 1С, самописных систем и нетиповых сценариев.
- Типовой набор: всплывающая карточка, история звонков, звонок по клику, записи разговоров.
- Интеграция по API — от 80 000 ₸, точная сумма зависит от документации вашей системы.
Когда нужна интеграция АТС по API
Сначала проверьте, нет ли готового решения. OnlinePBX из коробки интегрируется с amoCRM, Битрикс24 и ещё более чем тридцатью CRM, и эти интеграции входят в тариф вендора. Если ваша система в этом списке, интеграция АТС по API, скорее всего, не нужна — достаточно настройки.
API становится нужен в трёх ситуациях:
- Учётная система без готового коннектора. 1С, отраслевые программы, ERP.
- Собственная разработка. Самописная CRM, личный кабинет, внутренний портал.
- Нетиповой сценарий в типовой CRM. Например, нужно не просто создать сделку, а выбрать воронку по данным из другой системы или передать звонок в BI.
Подробнее о том, для каких компаний OnlinePBX подходит лучше всего, — на странице OnlinePBX: АТС для нестандартных схем.
Какие данные и события доступны
Возможности API описаны в документации вендора, и набор методов со временем расширяется. Для планирования интеграции полезно мыслить не методами, а тремя типами взаимодействия.
| Тип | Что даёт | Пример использования |
|---|---|---|
| События звонков (вебхуки) | АТС сама сообщает вашей системе: звонок начался, менеджер ответил, разговор завершён, звонок пропущен | Всплывающая карточка клиента, задача на перезвон по пропущенному |
| Запросы к АТС | Ваша система запрашивает историю звонков, длительность, ссылки на записи | История звонков в карточке 1С, ночная выгрузка в отчёт |
| Команды АТС | Ваша система просит АТС совершить действие — например, соединить менеджера с клиентом | Звонок по клику из документа или карточки |
Webhook OnlinePBX: как работают события
Вебхук — это адрес в вашей системе, на который АТС отправляет уведомление о каждом событии звонка. Ваша система получает номер звонящего, внутренний номер сотрудника, время и тип события и решает, что делать: открыть карточку, записать звонок в историю, поставить задачу. Главное требование — адрес должен быть доступен из интернета и отвечать быстро, а обработчик должен корректно переживать повторные и пропущенные уведомления.
Интеграция телефонии с 1С
Самый частый запрос, с которым к нам приходят по API OnlinePBX. Обмен с 1С обычно включает три вещи.
- Карточка клиента при входящем звонке. 1С находит контрагента по номеру и показывает менеджеру: кто звонит, последние заказы, долг, ответственный.
- История звонков в базе. Каждый звонок сохраняется у контрагента с датой, длительностью и ссылкой на запись.
- Звонок одним кликом. Из карточки контрагента или документа — заказа, счёта — менеджер звонит без набора номера.
Для этого на стороне 1С нужна доработка конфигурации: обработчик событий, поиск по номеру, хранение истории. Объём зависит от того, типовая конфигурация или сильно доработанная, и от того, где 1С работает — на своём сервере или в облаке. Состав обмена согласуем до старта работ.
1С на своём сервере или в облаке
От размещения 1С зависит архитектура. Если база работает на сервере в офисе и недоступна из интернета, события звонков нельзя отправить в неё напрямую — нужен промежуточный сервис или регулярный опрос АТС со стороны 1С. Если 1С опубликована через веб-сервер или работает в облаке, обмен проще. Ещё один вопрос — кто дорабатывает конфигурацию: ваш программист 1С, франчайзи или мы. Это стоит решить до оценки, чтобы доработки не конфликтовали с обновлениями базы.
Хранить номера контрагентов в 1С в произвольном формате — с восьмёркой, плюсом, пробелами и двумя номерами в одном поле. Поиск по номеру при звонке перестаёт находить клиента, и интеграция «не работает», хотя работает. Нормализацию номеров стоит заложить в проект.
Что ещё строят на API OnlinePBX
- Самописная CRM или личный кабинет. Всплывающая карточка, создание обращения по новому номеру, звонок по клику, записи в карточке. По сути — то же, что даёт штатная интеграция с amoCRM, только в вашей системе.
- Хелпдеск и сервис. Звонок в поддержку автоматически создаёт или дополняет заявку, а запись разговора прикладывается к ней.
- Отчёты и BI. Регулярная выгрузка истории звонков в хранилище данных: звонки по операторам, точкам, часам рядом с продажами и выручкой.
- Связка с другими системами. Мессенджеры, системы бронирования, маркетинговая аналитика — когда звонок должен стать событием в цепочке.
Если таких систем несколько и данные должны ходить между ними, это уже не интеграция одной АТС, а задача для разработки API и нестандартных интеграций: с очередями, мониторингом и единой схемой обмена.
ПРАВИЛОИнтеграция без мониторинга работает до первого сбоя. Логи событий и оповещение о разрыве связи закладываются в проект сразу.
Надёжность и безопасность интеграции
Интеграция телефонии работает постоянно и обрабатывает персональные данные клиентов — номера, имена, записи разговоров. Поэтому в проекте мы сразу закладываем несколько вещей, о которых часто забывают.
- Хранение ключей. Ключ доступа к API АТС хранится на сервере, а не в коде страницы или в общей таблице. У ключа — минимально необходимые права.
- Защищённый адрес для вебхуков. Обработчик событий работает по HTTPS и проверяет, что запрос пришёл от АТС, а не от постороннего.
- Повторы и очередь. Если ваша система была недоступна несколько минут, события не должны теряться: их складывают в очередь и обрабатывают после восстановления, а историю звонков сверяют по запросу к АТС.
- Логи и оповещения. Каждое событие пишется в журнал. Если за рабочий час не пришло ни одного события, ответственный получает сигнал — так сбой видно раньше, чем его заметят менеджеры.
- Доступ к записям. Ссылки на записи разговоров открываются только тем, у кого есть права в вашей системе.
Эти пункты почти не увеличивают смету, если заложены с начала, и обходятся дорого, если их приходится добавлять после первого инцидента.
Как проходит проект интеграции
- СценарииЧто должно происходить при входящем, исходящем и пропущенном звонке. Описываем как пользовательские истории: «звонит клиент — менеджер видит…».
- Изучение вашей системыЕсть ли документированный API, где она размещена, доступна ли из интернета, кто её дорабатывает.
- ОценкаОбъём работ и срок с разбивкой по сценариям. Если подходящего API в вашей системе нет, говорим об ограничениях до начала работ.
- Разработка и тестРеализация, тестовые звонки по всем сценариям, проверка на реальных данных.
- Запуск и мониторингВключение для всех сотрудников, логирование событий, оповещение при сбоях.
Сколько стоит интеграция по API
Интеграция OnlinePBX по API — от 80 000 ₸ разово. Точная сумма и срок зависят от того, есть ли у вашей системы документированный API и какие сценарии нужны: всплывающая карточка, создание сделки, звонок по клику, выгрузка записей разговоров. Обмен с 1С — тоже от 80 000 ₸, состав согласуем до старта. Подключения к amoCRM и Битрикс24 разработки не требуют: штатные интеграции входят в проектирование и запуск от 250 000 ₸.
Лицензия OnlinePBX — 13 290 ₸ в месяц с первым рабочим местом, каждое следующее — 4 800 ₸; это прайс вендора для Казахстана, актуальные цены сверяйте перед расчётом. Из чего складывается оценка API-проектов в целом, мы разбирали в статье о стоимости разработки интеграции через API.
Что подготовить до обращения
Опишите три-пять сценариев, которые нужны в первую очередь, и выясните у своего разработчика или администратора 1С, есть ли у системы API и доступна ли она из интернета. Пришлите это вместе с числом сотрудников, которые будут звонить. С этими данными точную смету мы присылаем за один рабочий день. Если вы ещё выбираете провайдера и не уверены, что нужен именно OnlinePBX, сравните варианты на странице IP-телефонии с интеграцией в CRM. Если выбор сделан — интеграцию OnlinePBX с вашей системой мы оценим после изучения документации.
Нужен ли API, чтобы подключить OnlinePBX к amoCRM или Битрикс24?
Нет. С ними работают штатные интеграции, которые входят в тариф вендора. API нужен для нестандартных систем и нетиповых сценариев.
Можно ли связать OnlinePBX с 1С?
Да, через API: карточка клиента при входящем звонке, история звонков в базе и звонок из документа одним кликом. Стоимость — от 80 000 ₸, состав обмена согласуем до старта.
Что такое вебхук в OnlinePBX?
Уведомление, которое АТС отправляет в вашу систему при событии звонка: начало, ответ, завершение, пропуск. По нему система открывает карточку или ставит задачу.
Что если у нашей системы нет API?
Тогда сначала решаем, можно ли его доработать. Если подходящего способа обмена нет, честно говорим об ограничениях до начала работ.