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

Передавайте звонки и записи разговоров из виртуальной или своей АТС в CRM через API: заявки по входящим, история звонков, записи и их автоматическая расшифровка в карточке.

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

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

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

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

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

Откуда пришёл клиент. Передавайте в звонке номер, на который звонил клиент (поле line), и поставьте на сайт код сквозной аналитики: в заявке появится реклама или поиск, откуда пришёл звонящий. Сквозная аналитика

Запросы

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

Начало, конец и готовая запись приходят отдельными запросами с одним и тем же 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 делает со звонком

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

Создаёт заявку с телефоном клиента. Ответственным становится менеджер по умолчанию, а если он не назначен, владелец компании. Если ключ выпущен на сотрудника, который видит только свои заявки, ответственным становится сам этот сотрудник. Ключ сотрудника без права «Создавать заявки» такой звонок не сохраняет: ответ 403.

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

Попадает в активную заявку с этим номером. Входящий звонок ищет заявку, созданную за последние 30 дней: если активная заявка старше, создаётся новая. Сравниваются последние 10 цифр; номер короче 10 цифр не сверяется.

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

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

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

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

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

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

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

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

Расшифровка

Расшифровка разговоров

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

Каждая новая записьСтавится на расшифровку, как только CRM её получила. Текст появляется в карточке сам, обновлять страницу не нужно.
Текст под плееромВ карточке заявки, в блоке «Расшифровка» под записью. Длинный разговор свёрнут и открывается кнопкой «Показать полностью».
Старые записи по кнопкеДля записей, полученных до включения расшифровки, под плеером есть кнопка «Расшифровать». Если не получилось, видна причина и кнопка «Повторить».
Настройка компанииРасшифровка включена по умолчанию. Администратор выключает её галочкой «Расшифровывать звонки»: «Настройки компании», вкладка «Компания».
Текст в APIРасшифровка приходит в ленте событий заявки у каждой записи звонка: её можно забрать в свою систему ключом с областью leads:read.

Подробнее о расшифровке

GET /api/v1/leads/128/events?types=call

{ "type": "call",
  "data": {
    "call_id": "1727517900.1234",
    "status_label": "Принят",
    "duration": 185,
    "recordings": [{
      "name": "call-1727517900.1234.mp3",
      "transcript": {
        "state": "done",
        "text": "Добрый день, компания «Окна Урала»..."
      }
    }]
  }
}

Вопросы

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

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

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

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

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

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

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

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

Неудача с записью не отменяет уже принятый звонок: звонок и заявка остаются в CRM. Если CRM отклонила ссылку сразу, причина приходит в ответе полем recording_error: ссылку можно исправить и прислать снова с тем же идентификатором звонка или загрузить запись файлом. Если ссылка принята (в ответе "recording": "queued"), CRM скачивает запись позже, и неудача скачивания (ссылка истекла, вместо записи пришла страница ошибки, запись не поместилась в хранилище) ни в каком ответе не видна: запись просто не появляется у звонка. Проверить это можно в ленте событий заявки, GET /api/v1/leads/{номер}/events (ключом с областью leads:read: у ключа только со звонками и созданием заявок этой области нет). Если запись не поместилась, администраторы с подключённым Telegram получают уведомление «Хранилище компании заполнено». Когда запись важна, сохраняйте файл и загружайте его методом POST /api/v1/calls/recording: там отказ приходит в ответе сразу.

Нужно ли менять скрипт, чтобы звонки расшифровывались?

Нет. CRM расшифровывает каждую новую запись, которую получила ссылкой или файлом: речь распознаёт нейросеть. Запись длиннее 60 минут не расшифровывается. Подробнее: Расшифровка звонков.

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

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

Дальше

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

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

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