Формат данных

Результат звонка (`call_result`)

Приходит после каждого завершённого разговора.

Show Пример данных

{
  "id": "0d8111f0-0af6-4300-86e8-492bc89a5b65",
  "type": "call_result",
  "organizationId": "120d1ba4-7bb1-4af5-bf5a-218f69261f35",
  "timestamp": "2025-04-16T15:47:37.705Z",
  "callList": {
    "id": "a41cfb86-8b12-425a-96aa-9dd476f240f6",
    "organization": {
      "id": "120d1ba4-7bb1-4af5-bf5a-218f69261f35",
      "name": "DMP",
      "createdBy": "b34b8c7e-2c7b-4b63-bd0f-4ed568b122ae",
      "createdAt": "2025-03-09T11:05:04.773Z",
      "updatedAt": "2025-03-09T11:05:04.852Z"
    },
    "name": "DMP",
    "status": "active",
    "createdAt": "2025-03-09T10:57:26.812Z",
    "updatedAt": "2025-04-16T11:05:51.329Z",
    "createdBy": "b34b8c7e-2c7b-4b63-bd0f-4ed568b122ae"
  },
  "call": {
    "id": "35f14673-671b-4eef-92ad-5a073fc7cad7",
    "startedAt": "2025-05-12T13:57:22.300Z",
    "connectedAt": "2025-05-12T13:57:33.179Z",
    "endedAt": "2025-05-12T14:03:16.648Z",
    "duration": 343469,
    "status": "completed",
    "type": "outgoing",
    "hangupReason": "hangup",
    "recordUrl": "https://aicallscloud.ru/api/process-record-url?recordUrl=...",
    "callDetails": {
      "channelId": "f1e677b5-aaac-44aa-be96-0701a873a5fd",
      "chatHistory": [
        { "role": "user", "content": "..." },
        { "role": "assistant", "content": "Алло... " }
      ]
    },
    "agreements": {
      "isCommit": true,
      "agreements": "Договорились скинуть ссылку на пробные уроки в телеграм",
      "client_name": "",
      "client_facts": "Клиент в 10 классе, интересуется химией",
      "agreements_time": "2025-05-12 17:03:00",
      "agreements_time_local": "2025-05-12 17:03:00",
      "status": "transfer",
      "lead_destination": "sales",
      "smsText": "Привет! Пришлю Вам ссылку на пробные уроки по химии, как договорились.",
      "lead_quality": 8,
      "leadTransfer": {
        "email": "client@example.com",
        "budget": "до 50 000 ₽"
      }
    },
    "callSession": {
      "id": "daeb15e0-b186-4afc-b8b9-1c081bf49a10",
      "createdAt": "2025-05-12T13:57:22.300Z",
      "updatedAt": "2025-05-12T14:03:20.374Z",
      "attempts": 1,
      "status": "completed",
      "priority": 0,
      "attemptsLeft": 2
    }
  },
  "contact": {
    "id": "c68f7928-a383-41da-be5d-e60c8c44a5d9",
    "phone": "79996662211",
    "blacklist": false,
    "dadataPhoneInfo": {
      "type": "Мобильный",
      "phone": "+7 999 666-22-11",
      "region": "Рязанская область",
      "provider": "ПАО «МТС»",
      "timezone": "UTC+3"
    },
    "tags": ["dmp.one"],
    "additionalFields": {
      "ip": "2a00:1fa0:c220:176b:e5a7:fb0c:f53c:c4e7",
      "page": "https://dmp.one/",
      "phone": "79996662211",
      "website": "dmp.one"
    }
  }
}

Итог сессии (`call_session_result`)

Приходит один раз — когда Саша завершила работу с контактом: договорилась, получила отказ или исчерпала все попытки дозвониться. Структура тела совпадает с call_result — те же поля call, contact, callList. Используйте это событие для интеграций с CRM: один запрос — один итог по контакту, без дублей за каждую попытку.

Как определяется исход

Исход	Когда
Лид	Саша договорилась о следующем шаге (`agreements.isCommit = true`)
Отказ	Был разговор, но до договорённости не дошли — возражение, «не интересно», не ЦА (`agreements.status = close`)
Недозвон	Дозвониться не удалось ни разу за все попытки

Если для конкретного исхода маршрут в CRM не настроен — событие пропускается без ошибки.

Как настроить, что передавать в CRM для каждого исхода — Битрикс24 и AmoCRM.

Только лиды (`lead_only`)

Структура та же. Два отличия:

Приходит только когда agreements.isCommit = true
Поле id — уникальный UUID каждой доставки. У call_result поле id совпадает с call.id

Show Пример данных

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "type": "lead_only",
  "organizationId": "120d1ba4-7bb1-4af5-bf5a-218f69261f35",
  "timestamp": "2025-05-12T14:03:20.000Z",
  "callList": {
    "id": "a41cfb86-8b12-425a-96aa-9dd476f240f6",
    "name": "DMP",
    "status": "active"
  },
  "call": {
    "id": "35f14673-671b-4eef-92ad-5a073fc7cad7",
    "startedAt": "2025-05-12T13:57:22.300Z",
    "connectedAt": "2025-05-12T13:57:33.179Z",
    "endedAt": "2025-05-12T14:03:16.648Z",
    "duration": 343469,
    "status": "completed",
    "type": "outgoing",
    "hangupReason": "hangup",
    "recordUrl": "https://aicallscloud.ru/api/process-record-url?recordUrl=...",
    "callDetails": {
      "chatHistory": [
        { "role": "user", "content": "..." },
        { "role": "assistant", "content": "..." }
      ]
    },
    "agreements": {
      "isCommit": true,
      "agreements": "Договорились о демонстрации продукта",
      "client_name": "Иван",
      "client_facts": "Ищет решение для автоматизации",
      "status": "transfer",
      "lead_destination": "sales",
      "leadTransfer": {
        "company": "ООО Пример",
        "номертелефона": "+79991234567"
      }
    }
  },
  "contact": {
    "id": "c68f7928-a383-41da-be5d-e60c8c44a5d9",
    "phone": "79996662211",
    "tags": ["сайт"],
    "additionalFields": {
      "источник": "реклама"
    }
  }
}

Справочник полей

Основное

Поле	Тип	Что это
`id`	string	ID события
`type`	string	`call_result`, `lead_only` или `call_session_result`
`organizationId`	string	ID вашего аккаунта
`timestamp`	string	Время события, ISO 8601

Колл-лист

Поле	Тип	Что это
`callList.id`	string	ID колл-листа
`callList.name`	string	Название колл-листа
`callList.status`	string	Статус колл-листа

Звонок

Поле	Тип	Что это
`call.id`	string	ID звонка
`call.startedAt`	string	Начало звонка
`call.connectedAt`	string	Момент соединения
`call.endedAt`	string	Конец звонка
`call.duration`	number	Длительность в миллисекундах
`call.status`	string	`completed`, `failed` — справочник
`call.type`	string	`outgoing` или `incoming`
`call.hangupReason`	string	Причина завершения — справочник
`call.recordUrl`	string	Ссылка на запись разговора
`call.callDetails.channelId`	string	ID канала
`call.callDetails.chatHistory`	array	Полный транскрипт диалога — массив сообщений с `role` и `content`

Сессия звонка

Поле	Тип	Что это
`call.callSession.id`	string	ID сессии
`call.callSession.status`	string	Статус сессии — справочник
`call.callSession.attempts`	number	Сколько попыток сделано
`call.callSession.attemptsLeft`	number	Сколько попыток осталось
`call.callSession.priority`	number	Приоритет сессии
`call.callSession.scheduledDate`	string	Когда запланирован следующий звонок (если есть)
`call.callSession.result`	object	Итог сессии — справочник

Договорённости

Поле	Тип	Что это
`call.agreements.isCommit`	boolean	Целевая договорённость — справочник
`call.agreements.agreements`	string	Что договорились
`call.agreements.client_name`	string	Имя клиента
`call.agreements.client_facts`	string	Что Саша узнала о клиенте
`call.agreements.agreements_time`	string	Время договорённости, `YYYY-MM-DD HH:MM:SS`
`call.agreements.agreements_time_local`	string	Локальное время договорённости
`call.agreements.status`	string	`transfer` или `close` — справочник
`call.agreements.lead_destination`	string	`sales` или `callback` — справочник
`call.agreements.smsText`	string	Готовый текст SMS для клиента
`call.agreements.lead_quality`	number \| null	Оценка лида от 0 до 10 (если анализ её вернул)
`call.agreements.blacklist`	boolean	Рекомендация занести контакт в чёрный список (если есть)
`call.agreements.leadTransfer`	object	Кастомные поля агента «Лид трансфер»; см. ниже

Объект agreements.leadTransfer

Вложенный объект call.agreements.leadTransfer содержит только те пользовательские поля, которые заданы в скиллбейзе в настройках агента «Лид трансфер» (блок описаний полей: имя поля → подсказка для модели).

Имена ключей в JSON совпадают с именами полей, которые вы задали в скиллбейзе (латиница, кириллица или смешанный вид — как завели). Это не фиксированные customField1 / customField2 из примеров в интерфейсе: в вебхуке и в карточке звонка отображаются ваши ключи.
Значения заполняет модель по транскрипту разговора и по вашим текстовым описаниям полей.
Если модель не вернула значение для какого-то ключа, этого ключа в leadTransfer может не быть. Также значение может передано пустой строкой ("")

Остальные стандартные поля итога звонка (client_name, client_facts, agreements, lead_destination и т.д.) лежат на верхнем уровне call.agreements рядом с leadTransfer, а не внутри него. При настройке интеграций с CRM те же ключи из скиллбейза часто используются для маппинга в поля Bitrix24, AmoCRM и др.

Контакт

Поле	Тип	Что это
`contact.id`	string	ID контакта
`contact.phone`	string	Номер телефона
`contact.blacklist`	boolean	В чёрном списке или нет
`contact.dadataPhoneInfo`	object	Регион, оператор, часовой пояс из сервиса DaData
`contact.tags`	array	Теги контакта
`contact.additionalFields`	object	Доп. данные которые вы передавали при загрузке контакта

Справочник значений

Ниже — допустимые значения ключевых полей. Остальные поля описаны в таблицах выше.

`call.status` — статус попытки звонка

Значение	Описание
`completed`	Клиент ответил, разговор состоялся
`failed`	Недозвон, автоответчик или техническая ошибка
`connected`	Звонок в процессе (в вебхуках обычно не встречается)
`initiated`	Звонок создан (в вебхуках обычно не встречается)

`call.hangupReason` — причина завершения

Значение	Описание
`hangup`	Разговор завершён штатно — клиент или система положили трубку
`voicemail_busy`	Не ответил, занято или короткий сброс без диалога
`voicemail_smart_spam`	Автоответчик (умный детект)
`voicemail_answerphone`	Автоответчик
`voicemail_smart_ivr`	Голосовое меню (IVR)
`no_answer`	Нет ответа
`1006`	Технический обрыв связи

Могут приходить и другие технические коды — их можно обрабатывать как недозвон (failed).

`call.type` — направление звонка

Значение	Описание
`outgoing`	Исходящий
`incoming`	Входящий

`call.agreements.status` — итог анализа разговора

Значение	Описание
`transfer`	Есть смысл продолжать работу с контактом
`close`	Клиент отказал, дальнейшие звонки нецелесообразны

`call.agreements.lead_destination` — следующий шаг

Значение	Описание
`sales`	Передача в отдел продаж / целевая договорённость
`callback`	Перезвон по тому же сценарию в согласованное время

При lead_destination: callback и заполненном agreements_time платформа сама запланирует повторный звонок. Подробнее — Логика перезвона.

`call.agreements.isCommit` — целевая договорённость

Значение	Описание
`true`	Целевой лид — срабатывает событие `lead_only` и маршрут «лиды» в CRM
`false`	Договорённости нет или это перезвон / отказ

`call.callSession.status` — статус сессии дозвона

Значение	Описание
`active`	Идёт дозвон
`scheduled`	Запланирован перезвон (см. `scheduledDate`)
`completed`	Работа с контактом завершена

`call.callSession.result` — итог сессии

Поле заполняется, когда callSession.status = completed.

`result.status`	Описание
`success`	Цель достигнута: договорились, получен отказ после разговора или запланирован перезвон
`failed`	Дозвониться не удалось за все попытки

`result.reason`	Когда бывает
`max_attempts_reached`	Исчерпаны попытки по карте дозвона
`max_callbacks_by_request_reached`	Превышен лимит перезвонов по просьбе клиента
`auto_completed_due_to_inactivity`	Сессия закрыта автоматически из‑за неактивности
`1006`	Технический обрыв на финальной попытке

Как читать исход в интеграции

Задача	Событие	На что смотреть
Каждая попытка звонка	`call_result`	весь объект `call`
Только целевые лиды	`lead_only`	`call.agreements.isCommit = true`
Финальный итог по контакту	`call_session_result`	`call.callSession.result` + `call.agreements`
Перезвон по дате	`call_result`	`lead_destination: callback` + `agreements_time`

API Интеграции

Уведомления о событиях

Передача контактов

Результат звонка (`call_result`)

Итог сессии (`call_session_result`)

Как определяется исход

Только лиды (`lead_only`)

Справочник полей

Основное

Колл-лист

Звонок

Сессия звонка

Договорённости

Объект agreements.leadTransfer

Контакт

Справочник значений

`call.status` — статус попытки звонка

`call.hangupReason` — причина завершения

`call.type` — направление звонка

`call.agreements.status` — итог анализа разговора

`call.agreements.lead_destination` — следующий шаг

`call.agreements.isCommit` — целевая договорённость

`call.callSession.status` — статус сессии дозвона

`call.callSession.result` — итог сессии

Как читать исход в интеграции

​Результат звонка (call_result)

​Итог сессии (call_session_result)

​Как определяется исход

​Только лиды (lead_only)

​Справочник полей

​Основное

​Колл-лист

​Звонок

​Сессия звонка

​Договорённости

​Объект agreements.leadTransfer

​Контакт

​Справочник значений

​call.status — статус попытки звонка

​call.hangupReason — причина завершения

​call.type — направление звонка

​call.agreements.status — итог анализа разговора

​call.agreements.lead_destination — следующий шаг

​call.agreements.isCommit — целевая договорённость

​call.callSession.status — статус сессии дозвона

​call.callSession.result — итог сессии

​Как читать исход в интеграции

Результат звонка (`call_result`)

Итог сессии (`call_session_result`)

Как определяется исход

Только лиды (`lead_only`)

Справочник полей

Основное

Колл-лист

Звонок

Сессия звонка

Договорённости

Объект agreements.leadTransfer

Контакт

Справочник значений

`call.status` — статус попытки звонка

`call.hangupReason` — причина завершения

`call.type` — направление звонка

`call.agreements.status` — итог анализа разговора

`call.agreements.lead_destination` — следующий шаг

`call.agreements.isCommit` — целевая договорённость

`call.callSession.status` — статус сессии дозвона

`call.callSession.result` — итог сессии

Как читать исход в интеграции