Поля Follow-up звонков
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
Follow-up звонка содержит метаданные звонка, участников, записи и AI-блоки: транскрипцию, обзор, саммари, инсайты и оценку эффективности.
Поля можно передавать в параметре select методов call.followup.list и call.followup.get.
Какие поля можно передать в select
В select можно передать поля корневого объекта и доступные вложенные пути AI-блоков:
transcription,transcription.language,transcription.segmentsoverview,overview.topic,overview.detailedTakeaways,overview.meetingType,overview.agenda,overview.agreements,overview.actionItems,overview.meetingssummaryinsights,insights.speakerEvaluationAvailable,insights.speakerAnalysis,insights.meetingStrengths,insights.meetingWeaknesses,insights.speechStyleInfluence,insights.engagementLevel,insights.areasOfResponsibility,insights.finalRecommendationsevaluation,evaluation.efficiencyValue,evaluation.calendar,evaluation.criteria
Нельзя передавать в select поля внутри элементов массивов. Например, вместо participants.name передайте participants, вместо overview.actionItems.actionItem передайте overview.actionItems. Метод вернет весь массив с доступными полями.
Корневой объект
|
Название |
Описание |
|
callId |
Идентификатор звонка |
|
callType |
Тип звонка:
|
|
initiatorId |
Идентификатор пользователя, который начал звонок |
|
startDate |
Дата начала звонка в формате ISO 8601 |
|
endDate |
Дата окончания звонка в формате ISO 8601. Если звонок еще идет, значение равно |
|
durationSeconds |
Длительность звонка в секундах |
|
uuid |
UUID сессии звонка |
|
language |
Код языка транскрипции, например |
|
version |
Максимальная версия схемы среди сохраненных AI-блоков |
|
participants |
Участники звонка (подробное описание) |
|
outcomes |
Список готовых AI-блоков:
|
|
createdAt |
Дата последней AI-записи по звонку в формате ISO 8601 |
|
tracks |
Записи звонка (подробное описание) |
|
transcription |
Транскрипция звонка (подробное описание) |
|
overview |
Обзор встречи (подробное описание) |
|
summary |
Сегментированное саммари звонка (подробное описание) |
|
insights |
Инсайты и анализ спикеров (подробное описание) |
|
evaluation |
Оценка эффективности встречи (подробное описание) |
Объект participants[]
|
Название |
Описание |
|
userId |
Идентификатор пользователя |
|
talkedSeconds |
Время участия пользователя в звонке в секундах |
|
name |
Имя пользователя |
|
avatar |
URL аватара пользователя |
|
workPosition |
Должность пользователя |
Объект tracks[]
|
Название |
Описание |
|
trackId |
Идентификатор записи звонка |
|
type |
Тип записи |
|
fileId |
Идентификатор файла |
|
diskFileId |
Идентификатор файла на Диске |
|
duration |
Длительность записи в секундах |
|
fileSize |
Размер файла в байтах |
|
fileName |
Имя файла |
|
mimeType |
MIME-тип файла |
|
callId |
Идентификатор звонка |
|
relUrl |
Относительный URL файла |
|
url |
Абсолютный URL файла |
|
dateCreate |
Дата регистрации записи в формате ISO 8601 |
Объект transcription
|
Название |
Описание |
|
language |
Код языка транскрипции |
|
segments |
Реплики в хронологическом порядке (подробное описание) |
Объект transcription.segments[]
|
Название |
Описание |
|
userId |
Идентификатор пользователя, который произнес реплику |
|
userName |
Имя пользователя |
|
start |
Время начала реплики относительно начала звонка в формате |
|
end |
Время окончания реплики относительно начала звонка в формате |
|
text |
Текст реплики. Формат упоминаний зависит от параметра |
Объект overview
|
Название |
Описание |
|
topic |
Краткая тема встречи |
|
detailedTakeaways |
Развернутые итоги встречи |
|
meetingType |
Тип встречи:
|
|
agenda |
Повестка встречи:
|
|
agreements |
Договоренности. Каждый элемент может содержать:
|
|
actionItems |
Действия по итогам встречи. Каждый элемент может содержать:
|
|
meetings |
Запланированные последующие встречи. Каждый элемент может содержать:
|
Объект summary
|
Название |
Описание |
|
segments |
Сегменты саммари (подробное описание) |
Объект summary.segments[]
|
Название |
Описание |
|
start |
Время начала сегмента относительно начала звонка в формате |
|
end |
Время окончания сегмента относительно начала звонка в формате |
|
title |
Заголовок сегмента |
|
summary |
Саммари сегмента |
Объект insights
|
Название |
Описание |
|
speakerEvaluationAvailable |
Доступна ли оценка спикеров. Для регионов вне CIS значение равно |
|
speakerAnalysis |
Анализ по спикерам (подробное описание). Элементы отсортированы по доле речи и оценке эффективности |
|
meetingStrengths |
Сильные стороны встречи. Каждый элемент содержит:
|
|
meetingWeaknesses |
Слабые стороны встречи. Каждый элемент содержит:
|
|
speechStyleInfluence |
Оценка влияния стиля коммуникации на результат встречи |
|
engagementLevel |
Оценка вовлеченности участников |
|
areasOfResponsibility |
Области ответственности, определенные по итогам встречи |
|
finalRecommendations |
Рекомендации для следующих встреч |
Объект insights.speakerAnalysis[]
|
Название |
Описание |
|
userId |
Идентификатор пользователя |
|
detailedInsight |
Подробный анализ участия спикера |
|
efficiencyValue |
Оценка эффективности спикера от |
|
evaluationCriteria |
Карта критериев оценки. Ключ — код критерия, значение — объект с полями:
|
|
talkPercentage |
Доля речи спикера в процентах. Поле добавляется по данным транскрипции |
|
duration |
Длительность речи спикера в секундах. Поле добавляется по данным транскрипции |
|
durationFormat |
Отформатированная длительность речи спикера. Поле добавляется по данным транскрипции |
Объект evaluation
|
Название |
Описание |
|
efficiencyValue |
Общая оценка эффективности встречи от |
|
calendar |
Оценка календарного планирования. Содержит поле:
|
|
criteria |
Карта критериев оценки. Ключ — код критерия, значение — объект с полями:
|