Call Follow-up Fields

If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.

A call follow-up contains call metadata, attendees, recording, and AI blocks: transcription, overview, summary, insights, and efficiency rating.

Fields can be passed in the select parameter of the call.followup.list and call.followup.get methods.

Which Fields Can Be Passed in Select

In select, you can pass root object fields and available nested paths for AI blocks:

  • 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

You cannot pass fields inside items arrays in select. For example, instead of participants.name, pass participants, and instead of overview.actionItems.actionItem, pass overview.actionItems. The method will return the entire array with the available fields.

Root Object

Name
type

Description

callId
integer

Identifier of the call

callType
integer

Call type:

  • 1 — instant call
  • 2 — persistent conference
  • 3 — large room

initiatorId
integer

Identifier of the user who started the call

startDate
string

Call start date in ISO 8601 format

endDate
string

Call end date in ISO 8601 format. If the call is still ongoing, the value is null

durationSeconds
integer

Duration of the call in seconds

uuid
string

Call session UUID

language
string

Transcription language code, e.g., ru or en

version
integer

Maximum schema version among saved AI blocks

participants
array

Call participants (detailed description)

outcomes
array

List of ready AI blocks:

  • transcription — call transcription
  • overview — meeting overview
  • summary — call summary
  • insights — insights and speaker analysis
  • evaluation — meeting effectiveness assessment

createdAt
string

Date of the last AI record for the call in ISO 8601 format

tracks
array

Call recordings (detailed description)

transcription
object

Call transcription (detailed description)

overview
object

Meeting overview (detailed description)

summary
object

Segmented call summary (detailed description)

insights
object

Insights and speaker analysis (detailed description)

evaluation
object

Meeting effectiveness assessment (detailed description)

Participants[] Object

Name
type

Description

userId
integer

User identifier

talkedSeconds
integer

User participation time in the call in seconds

name
string

User's first name

avatar
string

URL of the user's avatar

workPosition
string

Position of the user

Tracks[] Object

Name
type

Description

trackId
integer

Call recording identifier

type
string

Recording type

fileId
integer

Identifier of the file

diskFileId
integer

Identifier of the file on Drive

duration
integer

Recording duration in seconds

fileSize
integer

File size in bytes

fileName
string

File name

mimeType
string

File MIME type

callId
integer

Identifier of the call

relUrl
string

Relative file URL

url
string

Absolute file URL

dateCreate
string

Recording registration date in ISO 8601 format

Transcription Object

Name
type

Description

language
string

Transcription language code

segments
array

Utterances in chronological order (detailed description)

transcription.segments[] Object

Name
type

Description

userId
integer

Identifier of the user who spoke the utterance

userName
string

User's first name

start
string

Utterance start time relative to the beginning of the call in HH:MM:SS format

end
string

Utterance end time relative to the beginning of the call in HH:MM:SS format

text
string

Utterance text. Mention format depends on the mentionFormat parameter

Overview Object

Name
type

Description

topic
string

Brief meeting topic

detailedTakeaways
string

Detailed meeting outcomes

meetingType
object

Meeting type:

  • explanation — explanation of the meeting type
  • typeTag — meeting type code
  • title — meeting type name

agenda
object

Meeting agenda:

  • explanation — agenda description
  • quote — quote from the call

agreements
array

Agreements. Each item may contain:

  • agreement — agreement text
  • quote — quote from the call

actionItems
array

Action items based on the meeting results. Each item may contain:

  • actionItem — action with participant mentions
  • actionItemMentionLess — action without participant mentions
  • quote — quote from the call

meetings
array

Scheduled follow-up meetings. Each item may contain:

  • meeting — meeting description with mentions of participants
  • meetingMentionLess — meeting description without mentions of participants
  • quote — a quote from the call

Summary Object

Name
type

Description

segments
array

Summary segments (detailed description)

summary.segments[] Object

Name
type

Description

start
string

Segment start time relative to the start of the call in HH:MM:SS format

end
string

Segment end time relative to the start of the call in HH:MM:SS format

title
string

Segment title

summary
string

Segment summary

Insights Object

Name
type

Description

speakerEvaluationAvailable
boolean

Whether speaker ratings are available. For regions outside the CIS, the value is false

speakerAnalysis
array

Speaker analysis (detailed description). Items are sorted by share of speech and efficiency rating

meetingStrengths
array

Meeting strengths. Each item contains:

  • strengthTitle — strength name
  • strengthExplanation — strength explanation

meetingWeaknesses
array

Meeting weaknesses. Each item contains:

  • weaknessTitle — weakness name
  • weaknessExplanation — weakness explanation

speechStyleInfluence
string

Assessment of the impact of communication style on the meeting outcome

engagementLevel
string

Assessment of participant engagement

areasOfResponsibility
string

Areas of responsibility defined based on the meeting results

finalRecommendations
string

Recommendations for future meetings

insights.speakerAnalysis[] Object

Name
type

Description

userId
integer

User identifier

detailedInsight
string

Detailed analysis of speaker participation

efficiencyValue
integer

Speaker efficiency rating from 0 to 100

evaluationCriteria
object

Assessment criteria map. Key — criterion code, value — object with fields:

  • value — criterion check result, boolean value
  • criteria — criterion description
  • title — criterion name

talkPercentage
integer

Speaker's share of speech in percent. Field is added based on transcription data

duration
integer

Speaker's speech duration in seconds. Field is added based on transcription data

durationFormat
string

Formatted speaker speech duration. Field is added based on transcription data

Evaluation Object

Name
type

Description

efficiencyValue
integer

Overall meeting efficiency rating from 0 to 100

calendar
object

Calendar planning assessment. Contains field:

  • overhead — meeting exceeded scheduled time, boolean value

criteria
object

Assessment criteria map. Key — criterion code, value — object with fields:

  • value — criterion check result, boolean value
  • criteria — criterion description
  • thoughts — rating explanation
  • title — criterion name