Интеграция с телефонией и АТС

Как подключить

Между АТС и CRM один скрипт

Подойдёт любая АТС, которая сообщает о звонках вебхуками: виртуальная или своя.

Выпустите ключ
«Настройки компании», страница «API-ключи». Заведите для телефонии отдельный ключ.
Разместите скрипт
Он принимает уведомление АТС и переводит его в запрос к CRM. За основу можно взять пример из документации.
Укажите адрес в АТС
В кабинете АТС задайте адрес скрипта для уведомлений о звонках и сделайте тестовый звонок.

Запросы

Один звонок, несколько событий

Начало, конец и готовая запись приходят отдельными запросами с одним и тем же call_id. CRM дописывает поля звонка по мере поступления.

Номер клиента в первом событииПо нему CRM находит активную заявку или создаёт новую.
Направление и линияВходящий или исходящий, на какой номер звонили или с какого.
Запись ссылкойCRM скачает её в течение нескольких минут и прикрепит к звонку.

Поля и ответы в документации

POST /api/v1/calls

# 1. Начало звонка
{ "call_id": "1727517900.1234",
  "direction": "in",
  "client_phone": "+79991234567",
  "line": "+73422000000",
  "started_at": "2026-09-28T14:05:00+05:00" }

# 2. Конец звонка
{ "call_id": "1727517900.1234",
  "status": "answered",
  "duration": 185 }

# 3. Готовая запись
{ "call_id": "1727517900.1234",
  "record_url": "https://records.example-pbx.com/abc123.mp3" }

Правила

Что CRM делает со звонком

Входящий с нового номера

Создаёт заявку с телефоном клиента. Ответственным становится менеджер по умолчанию.

Звонок знакомого клиента

Попадает в активную заявку с этим номером. Сравниваются последние 10 цифр.

Исходящий без заявки

Пропускается, пока в настройках компании не включено создание заявки по исходящему звонку.

Запись по ссылке

Ссылка должна открываться из интернета без авторизации и жить несколько часов. Размер записи до 200 МБ.

Запись файлом

Отдельный запрос POST /api/v1/calls/recording с файлом до 100 МБ.

Форматы записей

mp3, wav, ogg, webm, m4a и aac. CRM проверяет содержимое файла, а не только расширение.

Вопросы

Вопросы о подключении АТС

Что нужно, чтобы подключить АТС?

Ключ API компании и небольшой скрипт на вашем сервере. АТС присылает на него уведомления о звонках, а он передаёт их в CRM запросом POST /api/v1/calls. Ключ выпускает администратор в «Настройках компании», на странице «API-ключи».

Есть ли готовый скрипт для моей АТС?

В документации API есть учебный пример на PHP для Novofon и Zadarma с таблицей соответствия событий. Для другой АТС его нужно адаптировать: названия полей и событий берутся из документации вашей АТС.

АТС присылает время звонка без часового пояса. Это проблема?

Время начала звонка должно содержать смещение часового пояса, иначе запрос будет отклонён. Скрипт должен дописать пояс, в котором работает АТС: обычно он задан в её кабинете.

Что, если запись разговора не скачалась?

Звонок и заявка сохраняются в любом случае. Причина отказа приходит в ответе полем recording_error: ссылку можно исправить и прислать снова с тем же идентификатором звонка или загрузить запись файлом.

Приходят ли уведомления о звонках?

Отдельных уведомлений о звонках нет: звонок виден в ленте заявки. Если входящий звонок создал новую заявку, сотрудники получат уведомление «Новая заявка» по своим настройкам.

Дальше

Соберите все заявки в одном месте

Регистрация по коду из письма занимает минуту. Банковская карта не нужна.

Начать бесплатно

Телефония и АТС

Между АТС и CRM один скрипт

Выпустите ключ

Разместите скрипт

Укажите адрес в АТС