Conference Participant Summary

Complete

com.twilio.voice.insights.conference-participant-summary.complete

Conference Participant Summary Complete events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the Webhook or Kinesis quickstarts and refer to the product documentation.

Examples

1{
2  "specversion" : "1.0",
3  "type" : "com.twilio.voice.insights.conference-participant-summary.complete",
4  "source" : "AB00000000000000000000000001",
5  "id" : "NO00000000000000000000000001",
6  "dataschema" : "https://events-schemas.twilio.com/VoiceInsights.ConferenceParticipantSummary/2",
7  "datacontenttype" : "2025-10-08T07:17:02.363Z",
8  "data" : {
9    "participant_sid" : "CP0000000000000000000000000000001",
10    "label" : "advisor",
11    "conference_sid" : "CF0000000000000000000000000000001",
12    "call_sid" : "CA0000000000000000000000000000001",
13    "account_sid" : "AC0000000000000000000000000000001",
14    "call_direction" : "inbound",
15    "from" : "+1234567890",
16    "to" : "+1234567890",
17    "call_state" : "completed",
18    "country_code" : "US",
19    "is_moderator" : true,
20    "join_time" : "2023-01-01T12:00:00Z",
21    "leave_time" : "2023-01-01T12:30:00Z",
22    "duration_seconds" : 1800,
23    "whisper" : "You are being recorded",
24    "agent_audio" : true,
25    "outbound_queue_length" : 1,
26    "outbound_time_in_queue" : 30,
27    "jitter_buffer_size" : "small",
28    "is_coach" : true,
29    "coached_participants" : [
30      "CP0000000000000000000000000000001"
31    ],
32    "participant_region" : "us1",
33    "conference_region" : "us1",
34    "call_type" : "sip",
35    "quality_issues" : 0,
36    "properties" : {
37      "start_conference_on_enter" : true,
38      "end_conference_on_exit" : true,
39      "play_early_media" : true,
40      "recording_enabled" : true,
41      "trim_recording" : true,
42      "requested_region" : "us1",
43      "enter_muted" : true,
44      "beep_on_enter" : true,
45      "beep_on_exit" : true
46    },
47    "events" : {
48      "hold" : [
49        1621837451
50      ],
51      "unhold" : [
52        1621837491
53      ],
54      "mute" : [
55        1621837471
56      ],
57      "unmute" : [
58        1621837481
59      ],
60      "modify_beep" : [
61        1621837491
62      ],
63      "modify_exit" : [
64        1621837501
65      ],
66      "coaching" : [
67        1621837511
68      ],
69      "coaching_stopped" : [
70        1621837521
71      ],
72      "modify_coached_participant" : [
73        1621837531
74      ]
75    },
76    "metrics" : {
77      "inbound" : {
78        "total_packets_lost" : 0,
79        "total_packets_received" : 1000,
80        "packet_loss_percentage" : 0.0,
81        "jitter" : {
82          "avg" : 5.5,
83          "max" : 10.0
84        },
85        "latency" : {
86          "avg" : 5.5,
87          "max" : 10.0
88        },
89        "mos" : 1.0,
90        "tags" : [
91          "silent"
92        ],
93        "tags_info" : {
94          "description" : "High packet loss detected",
95          "packet_loss" : {
96            "severity" : "high"
97          },
98          "jitter" : {
99            "severity" : "high"
100          },
101          "latency" : {
102            "severity" : "high"
103          },
104          "low_mos" : {
105            "severity" : "high"
106          }
107        },
108        "occurrences" : {
109          "packet_loss" : [
110            {
111              "percent" : 0.0,
112              "timestamp" : 1621837451
113            }
114          ],
115          "jitter" : [
116            {
117              "avg" : 5.5,
118              "max" : 10.0,
119              "timestamp" : 1621837451
120            }
121          ],
122          "latency" : [
123            {
124              "avg" : 5.5,
125              "max" : 10.0,
126              "timestamp" : 1621837451
127            }
128          ]
129        }
130      },
131      "outbound" : {
132        "total_packets_lost" : 0,
133        "total_packets_received" : 1000,
134        "packet_loss_percentage" : 0.0,
135        "jitter" : {
136          "avg" : 5.5,
137          "max" : 10.0
138        },
139        "latency" : {
140          "avg" : 5.5,
141          "max" : 10.0
142        },
143        "mos" : 1.0,
144        "tags" : [
145          "silent"
146        ],
147        "tags_info" : {
148          "description" : "High packet loss detected",
149          "packet_loss" : {
150            "severity" : "high"
151          },
152          "jitter" : {
153            "severity" : "high"
154          },
155          "latency" : {
156            "severity" : "high"
157          },
158          "low_mos" : {
159            "severity" : "high"
160          }
161        },
162        "occurrences" : {
163          "packet_loss" : [
164            {
165              "percent" : 0.0,
166              "timestamp" : 1621837451
167            }
168          ],
169          "jitter" : [
170            {
171              "avg" : 5.5,
172              "max" : 10.0,
173              "timestamp" : 1621837451
174            }
175          ],
176          "latency" : [
177            {
178              "avg" : 5.5,
179              "max" : 10.0,
180              "timestamp" : 1621837451
181            }
182          ]
183        }
184      }
185    },
186    "call_status" : "completed",
187    "processing_state" : "complete"
188  }
189}

Versions

v2 (latest)

(information)

Info

v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

string participant_sid (required). The unique SID identifier of the participant.
string label. Custom label for the participant resource, up to 64 characters.
string conference_sid (required). The unique SID identifier of the Conference.
string call_sid (required). The unique SID identifier of the Call.
string account_sid (required). The unique SID identifier of the account.
string call_direction (required). Direction of media flow from the perspective of the edge. Inbound or outbound.
string from. Call source.
string to. Call destination.
string call_state (required). Status of the call; completed, failed, etc.
string country_code. Country Code of Participant.
boolean is_moderator. Is participant a moderator.
string join_time (required). ISO format time participant joined.
string leave_time (required). ISO format time participant left.
integer duration_seconds. Participant duration in seconds.
string whisper. The value of whisper.
boolean agent_audio. The value of agent_audio.
integer outbound_queue_length. Call position in the queue.
integer outbound_time_in_queue. Time spent in queue before joining the conference.
string jitter_buffer_size (required). Jitter buffer size for the connecting participant.
boolean is_coach. Is participant a coach.
string[] coached_participants (required). Call sids coached by the participant.
string participant_region (required). Region of the participant conference mixed.
string conference_region (required). Region of the conference mixed.
string call_type (required). Type of call: sip, pstn, client etc.
integer quality_issues. Count of issues detected.
object properties. Properties set at start of conference.
- boolean start_conference_on_enter. Boolean value set to start the conference when the participant joins the conference.
- boolean end_conference_on_exit. Boolean value set to end the conference when the participant leave the conference.
- boolean play_early_media. Boolean value set to allow an agent to hear the state of the outbound call, including ringing or disconnect messages.
- boolean recording_enabled. Boolean value set to allow recording of the conference.
- boolean trim_recording. Boolean value set to trim leading and trailing silence from your recorded conference audio files.
- string requested_region (required). Request region to mix the conference.
- boolean enter_muted. Boolean value set to join participant as muted in the conference.
- boolean beep_on_enter. Boolean value set to allow beep on enter of conference.
- boolean beep_on_exit. Boolean value set to allow beep on exist of conference.
object events. Timestamp values of actions taken by participant.
- integer[] hold (required). Unix timestamps when participant is on hold.
- integer[] unhold (required). Unix timestamps when participant is on uhold.
- integer[] mute (required). Unix timestamps when participant is on mute.
- integer[] unmute (required). Unix timestamps when participant is unmuted.
- integer[] modify_beep (required). Unix timestamps when modify beep action occurs.
- integer[] modify_exit (required). Unix timestamps when modify exit action occurs.
- integer[] coaching (required). Unix timestamps when paticipant is coaching.
- integer[] coaching_stopped (required). Unix timestamp when paticipant stop coaching.
- integer[] modify_coached_participant (required). Unix timestamp when paticipant changed the participant to coach.
object metrics. Metrics definitions.
- object inbound. Array of metrics.
  - integer total_packets_lost. Count of packets lost.
  - integer total_packets_received. Count of packets received.
  - number packet_loss_percentage. Percent of packet lost.
  - object jitter. Metric stats object.
    - number avg. Average value of the metric.
    - number max. Max value of the metric.
  - object latency. Metric stats object.
    - number avg. Average value of the metric.
    - number max. Max value of the metric.
  - number mos. Mos score of call.
  - string[] tags (required). Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.
  - object tags_info. Object have details about the tag.
    - string description. Description about the tag.
    - object packet_loss. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object jitter. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object latency. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object low_mos. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
  - object occurrences. Timestamp of the event and value of the properties.
    - object[] packet_loss (required). Percent of packet loss with timestamp.
      - number percent. Number in percentage.
      - integer timestamp. Unix timestamp when issue is experienced.
    - object[] jitter (required). Histogram with timestamp.
      - number avg. Average value in histogram.
      - number max. Max value in histogram.
      - integer timestamp. Unix timestamp when the issue is experienced.
    - object[] latency (required). Histogram with timestamp.
      - number avg. Average value in histogram.
      - number max. Max value in histogram.
      - integer timestamp. Unix timestamp when the issue is experienced.
- object outbound. Array of metrics.
  - integer total_packets_lost. Count of packets lost.
  - integer total_packets_received. Count of packets received.
  - number packet_loss_percentage. Percent of packet lost.
  - object jitter. Metric stats object.
    - number avg. Average value of the metric.
    - number max. Max value of the metric.
  - object latency. Metric stats object.
    - number avg. Average value of the metric.
    - number max. Max value of the metric.
  - number mos. Mos score of call.
  - string[] tags (required). Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.
  - object tags_info. Object have details about the tag.
    - string description. Description about the tag.
    - object packet_loss. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object jitter. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object latency. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object low_mos. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
  - object occurrences. Timestamp of the event and value of the properties.
    - object[] packet_loss (required). Percent of packet loss with timestamp.
      - number percent. Number in percentage.
      - integer timestamp. Unix timestamp when issue is experienced.
    - object[] jitter (required). Histogram with timestamp.
      - number avg. Average value in histogram.
      - number max. Max value in histogram.
      - integer timestamp. Unix timestamp when the issue is experienced.
    - object[] latency (required). Histogram with timestamp.
      - number avg. Average value in histogram.
      - number max. Max value in histogram.
      - integer timestamp. Unix timestamp when the issue is experienced.
string call_status. Status of the call.
string processing_state. Processing state for the Conference Summary resource.

The full specification for version 2 is also available as a JSON schema.

string participant_sid (required). The unique SID identifier of the participant.
string label. Custom label for the participant resource, up to 64 characters.
string conference_sid (required). The unique SID identifier of the Conference.
string call_sid (required). The unique SID identifier of the Call.
string account_sid (required). The unique SID identifier of the account.
string call_direction (required). Direction of media flow from the perspective of the edge. Inbound or outbound.
string from. Call source.
string to. Call destination.
string call_state (required). Status of the call; completed, failed, etc.
string country_code. Country Code of Participant.
boolean is_moderator. Is participant a moderator.
string join_time (required). ISO format time participant joined.
string leave_time (required). ISO format time participant left.
integer duration_seconds. Participant duration in seconds.
string whisper. The value of whisper.
boolean agent_audio. The value of agent_audio.
integer outbound_queue_length. Call position in the queue.
integer outbound_time_in_queue. Time spent in queue before joining the conference.
string jitter_buffer_size (required). Jitter buffer size for the connecting participant.
boolean is_coach. Is participant a coach.
string[] coached_participants (required). Call sids coached by the participant.
string participant_region (required). Region of the participant conference mixed.
string conference_region (required). Region of the conference mixed.
string call_type (required). Type of call: sip, pstn, client etc.
integer quality_issues. Count of issues detected.
object properties. Properties set at start of conference.
- boolean start_conference_on_enter. Boolean value set to start the conference when the participant joins the conference.
- boolean end_conference_on_exit. Boolean value set to end the conference when the participant leave the conference.
- boolean play_early_media. Boolean value set to allow an agent to hear the state of the outbound call, including ringing or disconnect messages.
- boolean recording_enabled. Boolean value set to allow recording of the conference.
- boolean trim_recording. Boolean value set to trim leading and trailing silence from your recorded conference audio files.
- string requested_region (required). Request region to mix the conference.
- boolean enter_muted. Boolean value set to join participant as muted in the conference.
- boolean beep_on_enter. Boolean value set to allow beep on enter of conference.
- boolean beep_on_exit. Boolean value set to allow beep on exist of conference.
object events. Timestamp values of actions taken by participant.
- integer[] hold (required). Unix timestamps when participant is on hold.
- integer[] unhold (required). Unix timestamps when participant is on uhold.
- integer[] mute (required). Unix timestamps when participant is on mute.
- integer[] unmute (required). Unix timestamps when participant is unmuted.
- integer[] modify_beep (required). Unix timestamps when modify beep action occurs.
- integer[] modify_exit (required). Unix timestamps when modify exit action occurs.
- integer[] coaching (required). Unix timestamps when paticipant is coaching.
- integer[] coaching_stopped (required). Unix timestamp when paticipant stop coaching.
- integer[] modify_coached_participant (required). Unix timestamp when paticipant changed the participant to coach.
object metrics. Metrics definitions.
- object inbound. Array of metrics.
  - integer total_packets_lost. Count of packets lost.
  - integer total_packets_received. Count of packets received.
  - number packet_loss_percentage. Percent of packet lost.
  - object jitter. Metric stats object.
    - number avg. Average value of the metric.
    - number max. Max value of the metric.
  - object latency. Metric stats object.
    - number avg. Average value of the metric.
    - number max. Max value of the metric.
  - number mos. Mos score of call.
  - string[] tags (required). Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.
  - object tags_info. Object have details about the tag.
    - string description. Description about the tag.
    - object packet_loss. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object jitter. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object latency. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object low_mos. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
  - object occurrences. Timestamp of the event and value of the properties.
    - object[] packet_loss (required). Percent of packet loss with timestamp.
      - number percent. Number in percentage.
      - integer timestamp. Unix timestamp when issue is experienced.
    - object[] jitter (required). Histogram with timestamp.
      - number avg. Average value in histogram.
      - number max. Max value in histogram.
      - integer timestamp. Unix timestamp when the issue is experienced.
    - object[] latency (required). Histogram with timestamp.
      - number avg. Average value in histogram.
      - number max. Max value in histogram.
      - integer timestamp. Unix timestamp when the issue is experienced.
- object outbound. Array of metrics.
  - integer total_packets_lost. Count of packets lost.
  - integer total_packets_received. Count of packets received.
  - number packet_loss_percentage. Percent of packet lost.
  - object jitter. Metric stats object.
    - number avg. Average value of the metric.
    - number max. Max value of the metric.
  - object latency. Metric stats object.
    - number avg. Average value of the metric.
    - number max. Max value of the metric.
  - number mos. Mos score of call.
  - string[] tags (required). Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.
  - object tags_info. Object have details about the tag.
    - string description. Description about the tag.
    - object packet_loss. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object jitter. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object latency. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
    - object low_mos. Object to hold participant tag details.
      - string severity (required). Define the severity of the tag: high, medium.
  - object occurrences. Timestamp of the event and value of the properties.
    - object[] packet_loss (required). Percent of packet loss with timestamp.
      - number percent. Number in percentage.
      - integer timestamp. Unix timestamp when issue is experienced.
    - object[] jitter (required). Histogram with timestamp.
      - number avg. Average value in histogram.
      - number max. Max value in histogram.
      - integer timestamp. Unix timestamp when the issue is experienced.
    - object[] latency (required). Histogram with timestamp.
      - number avg. Average value in histogram.
      - number max. Max value in histogram.
      - integer timestamp. Unix timestamp when the issue is experienced.
string call_status. Staus of the call.
string processing_state. Processing state for the Conference Summary resource.

The full specification for version 1 is also available as a JSON schema.