# 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](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/voice/voice-insights/event-streams/conference-insights-event).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.insights.conference-participant-summary.complete",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/VoiceInsights.ConferenceParticipantSummary/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "participant_sid" : "CP0000000000000000000000000000001",
    "label" : "advisor",
    "conference_sid" : "CF0000000000000000000000000000001",
    "call_sid" : "CA0000000000000000000000000000001",
    "account_sid" : "AC0000000000000000000000000000001",
    "call_direction" : "inbound",
    "from" : "+1234567890",
    "to" : "+1234567890",
    "call_state" : "completed",
    "country_code" : "US",
    "is_moderator" : true,
    "join_time" : "2023-01-01T12:00:00Z",
    "leave_time" : "2023-01-01T12:30:00Z",
    "duration_seconds" : 1800,
    "whisper" : "You are being recorded",
    "agent_audio" : true,
    "outbound_queue_length" : 1,
    "outbound_time_in_queue" : 30,
    "jitter_buffer_size" : "small",
    "is_coach" : true,
    "coached_participants" : [
      "CP0000000000000000000000000000001"
    ],
    "participant_region" : "us1",
    "conference_region" : "us1",
    "call_type" : "sip",
    "quality_issues" : 0,
    "properties" : {
      "start_conference_on_enter" : true,
      "end_conference_on_exit" : true,
      "play_early_media" : true,
      "recording_enabled" : true,
      "trim_recording" : true,
      "requested_region" : "us1",
      "enter_muted" : true,
      "beep_on_enter" : true,
      "beep_on_exit" : true
    },
    "events" : {
      "hold" : [
        1621837451
      ],
      "unhold" : [
        1621837491
      ],
      "mute" : [
        1621837471
      ],
      "unmute" : [
        1621837481
      ],
      "modify_beep" : [
        1621837491
      ],
      "modify_exit" : [
        1621837501
      ],
      "coaching" : [
        1621837511
      ],
      "coaching_stopped" : [
        1621837521
      ],
      "modify_coached_participant" : [
        1621837531
      ]
    },
    "metrics" : {
      "inbound" : {
        "total_packets_lost" : 0,
        "total_packets_received" : 1000,
        "packet_loss_percentage" : 0.0,
        "jitter" : {
          "avg" : 5.5,
          "max" : 10.0
        },
        "latency" : {
          "avg" : 5.5,
          "max" : 10.0
        },
        "mos" : 1.0,
        "tags" : [
          "silent"
        ],
        "tags_info" : {
          "description" : "High packet loss detected",
          "packet_loss" : {
            "severity" : "high"
          },
          "jitter" : {
            "severity" : "high"
          },
          "latency" : {
            "severity" : "high"
          },
          "low_mos" : {
            "severity" : "high"
          }
        },
        "occurrences" : {
          "packet_loss" : [
            {
              "percent" : 0.0,
              "timestamp" : 1621837451
            }
          ],
          "jitter" : [
            {
              "avg" : 5.5,
              "max" : 10.0,
              "timestamp" : 1621837451
            }
          ],
          "latency" : [
            {
              "avg" : 5.5,
              "max" : 10.0,
              "timestamp" : 1621837451
            }
          ]
        }
      },
      "outbound" : {
        "total_packets_lost" : 0,
        "total_packets_received" : 1000,
        "packet_loss_percentage" : 0.0,
        "jitter" : {
          "avg" : 5.5,
          "max" : 10.0
        },
        "latency" : {
          "avg" : 5.5,
          "max" : 10.0
        },
        "mos" : 1.0,
        "tags" : [
          "silent"
        ],
        "tags_info" : {
          "description" : "High packet loss detected",
          "packet_loss" : {
            "severity" : "high"
          },
          "jitter" : {
            "severity" : "high"
          },
          "latency" : {
            "severity" : "high"
          },
          "low_mos" : {
            "severity" : "high"
          }
        },
        "occurrences" : {
          "packet_loss" : [
            {
              "percent" : 0.0,
              "timestamp" : 1621837451
            }
          ],
          "jitter" : [
            {
              "avg" : 5.5,
              "max" : 10.0,
              "timestamp" : 1621837451
            }
          ],
          "latency" : [
            {
              "avg" : 5.5,
              "max" : 10.0,
              "timestamp" : 1621837451
            }
          ]
        }
      }
    },
    "call_status" : "completed",
    "processing_state" : "complete"
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> 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](https://events-schemas.twilio.com/VoiceInsights.ConferenceParticipantSummary/2).

#### v1

* `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](https://events-schemas.twilio.com/VoiceInsights.ConferenceParticipantSummary/1).
