Поля Follow-up звонков

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Follow-up звонка содержит метаданные звонка, участников, записи и AI-блоки: транскрипцию, обзор, саммари, инсайты и оценку эффективности.

Поля можно передавать в параметре select методов call.followup.list, call.followup.get, syncconnector.followup.list и syncconnector.followup.get. Все четыре метода возвращают одни и те же поля.

Часть полей у звонков Битрикс24 Синк заполнена иначе, какой бы набор методов ни вернул Follow-up: call.followup.* или syncconnector.followup.*. Разница описана в разделе Отличия полей в Битрикс24 Синк.

Какие поля можно передать в select

В select можно передать поля корневого объекта и доступные вложенные пути AI-блоков:

  • transcription, transcription.language, transcription.segments
  • overview, overview.topic, overview.detailedTakeaways, overview.meetingType, overview.agenda, overview.agreements, overview.actionItems, overview.meetings
  • summary
  • insights, insights.speakerEvaluationAvailable, insights.speakerAnalysis, insights.meetingStrengths, insights.meetingWeaknesses, insights.speechStyleInfluence, insights.engagementLevel, insights.areasOfResponsibility, insights.finalRecommendations
  • evaluation, evaluation.efficiencyValue, evaluation.calendar, evaluation.criteria

Нельзя передавать в select поля внутри элементов массивов. Например, вместо participants.name передайте participants, вместо overview.actionItems.actionItem передайте overview.actionItems. Метод вернет весь массив с доступными полями.

Корневой объект

Название
тип

Описание

callId
integer

Идентификатор Follow-up:

  • у звонка Битрикс24 — идентификатор звонка
  • у звонка Битрикс24 Синк — число 10000000000 плюс идентификатор страницы подробного разбора. Например, странице 128 соответствует callId 10000000128

source
string

Источник Follow-up:

  • call — звонок Битрикс24
  • sync — звонок Битрикс24 Синк

Поле приходит, только если передать его в select

callType
integer

Тип звонка:

  • 1 — мгновенный звонок
  • 2 — постоянная конференция
  • 3 — большая комната

chatId
integer

Идентификатор чата, к которому относится звонок. Если чата нет, значение равно null

initiatorId
integer

Идентификатор пользователя, который начал звонок

startDate
string

Дата начала звонка в формате ISO 8601

endDate
string

Дата окончания звонка в формате ISO 8601. Если звонок еще идет, значение равно null

durationSeconds
integer

Длительность звонка в секундах

uuid
string

UUID сессии звонка

language
string

Код языка транскрипции, например ru или en

version
integer

Максимальная версия схемы среди сохраненных AI-блоков

participants
array

Участники звонка (подробное описание)

outcomes
array

Список готовых AI-блоков:

  • transcription — транскрипция звонка
  • overview — обзор встречи
  • summary — саммари звонка
  • insights — инсайты и анализ спикеров
  • evaluation — оценка эффективности встречи

createdAt
string

Дата, когда по звонку сохранен последний AI-блок, в формате ISO 8601

tracks
array

Записи звонка (подробное описание)

transcription
object

Транскрипция звонка (подробное описание)

overview
object

Обзор встречи (подробное описание)

summary
object

Саммари звонка по отрезкам времени (подробное описание)

insights
object

Инсайты и анализ спикеров (подробное описание)

evaluation
object

Оценка эффективности встречи (подробное описание)

Отличия полей в Битрикс24 Синк

У Follow-up звонков Битрикс24 Синк ключи и типы полей те же, что у звонков Битрикс24, но у части полей значения другие. Это действует и в call.followup.*, и в syncconnector.followup.*:

Название
тип

Значение в Битрикс24 Синк

callId
integer

Строится из идентификатора страницы подробного разбора. Один звонок может дать несколько страниц, по одной на каждую часть звонка.

source
string

Всегда sync. Поле приходит, только если передать его в select

callType
integer

Всегда 1

initiatorId
integer

Всегда null: Синк не передает в Битрикс24, кто начал звонок

startDate
string

Начало части звонка. Если у страницы нет границ части звонка — время, когда страница подробного разбора стала доступна

endDate
string

Конец части звонка. Если у страницы нет границ части звонка — null

durationSeconds
integer

Длительность части звонка в секундах. Если у страницы нет границ части звонка — null

uuid
string

Ключ звонка Синка, общий для всех его частей: по нему можно собрать страницы одного звонка. Значение не в формате UUID

participants
array

Пользователи Битрикс24, которые говорили в этой части звонка. Гостей в списке нет

participants[].talkedSeconds
integer

Сколько секунд пользователь говорил — сумма длительностей его фрагментов расшифровки. Без расшифровки — null

createdAt
string

Время, когда страница подробного разбора стала доступна

tracks
array

Аудиозапись Follow-up на Диске. Поле type всегда равно record, callId — то же значение, что в корневом поле callId. Массив пустой, если записи нет или у пользователя нет доступа к файлу

Объект participants[]

Название
тип

Описание

userId
integer

Идентификатор пользователя

talkedSeconds
integer

Время участия пользователя в звонке в секундах. У звонка Битрикс24 Синк значение другое — в разделе Отличия полей в Битрикс24 Синк

name
string

Имя пользователя

avatar
string

URL аватара пользователя

workPosition
string

Должность пользователя

Объект tracks[]

Название
тип

Описание

trackId
integer

Идентификатор записи звонка

type
string

Тип записи

fileId
integer

Идентификатор файла

diskFileId
integer

Идентификатор файла на Диске

duration
integer

Длительность записи в секундах

fileSize
integer

Размер файла в байтах

fileName
string

Имя файла

mimeType
string

MIME-тип файла

callId
integer

Идентификатор Follow-up, то же значение, что в корневом поле callId

relUrl
string

Относительный URL файла

url
string

Абсолютный URL файла

dateCreate
string

Дата регистрации записи в формате ISO 8601

Объект transcription

Название
тип

Описание

language
string

Код языка транскрипции

segments
array

Реплики в хронологическом порядке (подробное описание)

Объект transcription.segments[]

Название
тип

Описание

userId
integer

Идентификатор пользователя, который произнес реплику

userName
string

Имя пользователя

start
string

Время начала реплики относительно начала звонка в формате HH:MM:SS

end
string

Время окончания реплики относительно начала звонка в формате HH:MM:SS

text
string

Текст реплики. Формат упоминаний зависит от параметра mentionFormat

Объект overview

Название
тип

Описание

topic
string

Краткая тема встречи

detailedTakeaways
string

Развернутые итоги встречи

meetingType
object

Тип встречи:

  • explanation — объяснение типа встречи
  • typeTag — код типа встречи
  • title — название типа встречи

agenda
object

Повестка встречи:

  • explanation — описание повестки
  • quote — цитата из звонка

agreements
array

Договоренности. Каждый элемент может содержать:

  • agreement — текст договоренности
  • quote — цитату из звонка

actionItems
array

Действия по итогам встречи. Каждый элемент может содержать:

  • actionItem — действие с упоминаниями участников
  • actionItemMentionLess — действие без упоминаний участников
  • quote — цитату из звонка

meetings
array

Запланированные последующие встречи. Каждый элемент может содержать:

  • meeting — описание встречи с упоминаниями участников
  • meetingMentionLess — описание встречи без упоминаний участников
  • quote — цитату из звонка

Объект summary

Название
тип

Описание

segments
array

Сегменты саммари (подробное описание)

Объект summary.segments[]

Название
тип

Описание

start
string

Время начала сегмента относительно начала звонка в формате HH:MM:SS

end
string

Время окончания сегмента относительно начала звонка в формате HH:MM:SS

title
string

Заголовок сегмента

summary
string

Саммари сегмента

Объект insights

Название
тип

Описание

speakerEvaluationAvailable
boolean

Доступна ли оценка спикеров. Для регионов вне CIS значение равно false

speakerAnalysis
array

Анализ по спикерам (подробное описание). Элементы отсортированы по доле речи и оценке эффективности

meetingStrengths
array

Сильные стороны встречи. Каждый элемент содержит:

  • strengthTitle — название сильной стороны
  • strengthExplanation — объяснение сильной стороны

meetingWeaknesses
array

Слабые стороны встречи. Каждый элемент содержит:

  • weaknessTitle — название слабой стороны
  • weaknessExplanation — объяснение слабой стороны

speechStyleInfluence
string

Оценка влияния стиля коммуникации на результат встречи

engagementLevel
string

Оценка вовлеченности участников

areasOfResponsibility
string

Области ответственности, определенные по итогам встречи

finalRecommendations
string

Рекомендации для следующих встреч

Объект insights.speakerAnalysis[]

Название
тип

Описание

userId
integer

Идентификатор пользователя

detailedInsight
string

Подробный анализ участия спикера

efficiencyValue
integer

Оценка эффективности спикера от 0 до 100

evaluationCriteria
object

Карта критериев оценки. Ключ — код критерия, значение — объект с полями:

  • value — результат проверки критерия, булево значение
  • criteria — описание критерия
  • title — название критерия

talkPercentage
integer

Доля речи спикера в процентах. Поле добавляется по данным транскрипции

duration
integer

Длительность речи спикера в секундах. Поле добавляется по данным транскрипции

durationFormat
string

Отформатированная длительность речи спикера. Поле добавляется по данным транскрипции

Объект evaluation

Название
тип

Описание

efficiencyValue
integer

Общая оценка эффективности встречи от 0 до 100

calendar
object

Оценка календарного планирования. Содержит поле:

  • overhead — встреча вышла за запланированное время, булево значение

criteria
object

Карта критериев оценки. Ключ — код критерия, значение — объект с полями:

  • value — результат проверки критерия, булево значение
  • criteria — описание критерия
  • thoughts — пояснение оценки
  • title — название критерия