Получить статистику звонков лида, контакта или компании

Читает звонки с прямой привязкой к карточке, их длительность и зафиксированный результат телефонии.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Робот полезен для руководителя телефонии и аналитика работы с лидами. Звонки нужно сверить по выбранному клиенту и периоду, не подменяя статистику общим количеством дел. Робот читает записи телефонии с прямой привязкой к лиду, контакту или компании.

Что делает и когда применять

Читает звонки с прямой привязкой к карточке, их длительность и зафиксированный результат телефонии.

Принимает OWNER_TYPE_ID 1/3/4, OWNER_ID, FROM/TO с часовым поясом, CALL_TYPES: массив типов 1 исходящий, 2 входящий, 3 перенаправленный, 4 callback, 5 информационный и LIMIT 1–1000 (по умолчанию 500). Период до 366 дней, обе границы включены. Читает все страницы до лимита; превышение или неполный ответ: ошибка, а не частичная выборка. Возвращает JSON звонков без телефонных номеров и ссылок записи: ID, дата, тип, секунды, код результата, сотрудник, необязательный ID файла записи. Код 200 с положительной длительностью отмечается connected_recorded; это данные телефонии, не независимая проверка разговора. Сделки, дополнительные CRM-привязки и звонки без прямой связи не угадываются.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Выберите тип карточки 1, 3 или 4 и её ID. Задайте обе границы периода с часовым поясом, максимум 366 дней. Для большого потока сузьте период, чтобы уложиться в лимит до 1000 звонков.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Получить статистику звонков лида, контакта или компании». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Выберите тип карточки 1, 3 или 4 и её ID. Задайте обе границы периода с часовым поясом, максимум 366 дней. Для большого потока сузьте период, чтобы уложиться в лимит до 1000 звонков.
3. Заполните Тип карточки: лид 1, контакт 3, компания 4, ID карточки, Начало периода с часовым поясом, Конец периода с часовым поясом, Типы звонков JSON, Максимум звонков 1–1000. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
Тип карточки: лид 1, контакт 3, компания 4 (OWNER_TYPE_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
ID карточки (OWNER_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
Начало периода с часовым поясом (FROM)	Формат: строка.	Обязательно. Значение по умолчанию в настройках не задано
Конец периода с часовым поясом (TO)	Формат: строка.	Обязательно. Значение по умолчанию в настройках не задано
Типы звонков JSON (CALL_TYPES)	Формат: текст.	Обязательно. По умолчанию: [1,2,3,4,5]
Максимум звонков 1–1000 (LIMIT)	Формат: целое число.	Обязательно. По умолчанию: 500

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• Тип карточки: лид 1, контакт 3, компания 4 (OWNER_TYPE_ID): 1.
• ID карточки (OWNER_ID): 501.
• Начало периода с часовым поясом (FROM): 2026-10-01T00:00:00+03:00.
• Конец периода с часовым поясом (TO): 2026-10-01T23:59:59+03:00.
• Типы звонков JSON (CALL_TYPES): [1,2].
• Максимум звонков 1–1000 (LIMIT): 500.

Типы звонков JSON (CALL_TYPES)

Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-массив в квадратных скобках. Пустой массив [] означает отсутствие элементов; объект {} его не заменяет. Числа обозначают типы звонков: 1 исходящий, 2 входящий, 3 перенаправленный, 4 callback, 5 информационный. В примере [1,2] нужны только входящие и исходящие. Передавайте непустой набор поддержанных типов, не их русские названия.

[
  1,
  2
]

В выборку попадут прямые входящие и исходящие звонки лида 501 за указанные сутки, с включёнными границами периода. Результат не содержит номера телефона и ссылки записи. Код успешного соединения отражает статистику телефонии, а не подтверждение содержания разговора.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
Статистика звонков JSON (callsJson)	текст
Количество звонков (count)	целое число
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

Передайте «Статистика звонков JSON» в расчёт показателей или таблицу, а количество используйте для проверки пустой выборки. Превышение лимита требует меньшего периода, а не использования случайной части результата.

Ошибки и ограничения

Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.