{"$id":"https://events-schemas.twilio.com/VoiceInsights.ConferenceParticipantSummary/2","$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"HistogramAndTimestamp":{"additionalProperties":false,"description":"Object to store histogram and timestamp","properties":{"avg":{"description":"Average value in histogram.","type":"number"},"max":{"description":"Max value in histogram.","type":"number"},"timestamp":{"description":"Unix timestamp when the issue is experienced.","type":"integer"}},"type":"object"},"MetricStats":{"additionalProperties":false,"description":"metric stats object","properties":{"avg":{"description":"Average value of the metric.","type":"number"},"max":{"description":"Max value of the metric.","type":"number"}},"type":"object"},"ParticipantEvents":{"additionalProperties":false,"description":"timestamp values of actions taken by participant","properties":{"coaching":{"description":"Unix timestamps when paticipant is coaching.","items":{"description":"Unix timestamps when paticipant is coaching.","type":"integer"},"type":"array"},"coaching_stopped":{"description":"Unix timestamp when paticipant stop coaching.","items":{"description":"Unix timestamp when paticipant stop coaching.","type":"integer"},"type":"array"},"hold":{"description":"Unix timestamps when participant is on hold","items":{"description":"Unix timestamp when participant is on hold.","type":"integer"},"type":"array"},"modify_beep":{"description":"Unix timestamps when modify beep action occurs.","items":{"description":"Unix timestamp when modify beep action occurs.","type":"integer"},"type":"array"},"modify_coached_participant":{"description":"Unix timestamp when paticipant changed the participant to coach.","items":{"description":"Unix timestamp when paticipant changed the participant to coach.","type":"integer"},"type":"array"},"modify_exit":{"description":"Unix timestamps when modify exit action occurs.","items":{"description":"Unix timestamp when modify exit action occurs.","type":"integer"},"type":"array"},"mute":{"description":"Unix timestamps when participant is on mute","items":{"description":"Unix timestamp when participant is on mute.","type":"integer"},"type":"array"},"unhold":{"description":"Unix timestamps when participant is on uhold","items":{"description":"Unix timestamp when participant is off hold.","type":"integer"},"type":"array"},"unmute":{"description":"Unix timestamps when participant is unmuted.","items":{"description":"Unix timestamp when participant is unmuted.","type":"integer"},"type":"array"}},"required":["hold","unhold","mute","unmute","modify_beep","modify_exit","coaching","coaching_stopped","modify_coached_participant"],"type":"object"},"ParticipantMetric":{"additionalProperties":false,"description":"array of metrics","properties":{"jitter":{"$ref":"#/definitions/MetricStats"},"latency":{"$ref":"#/definitions/MetricStats"},"mos":{"description":"mos score of call","type":"number"},"occurrences":{"$ref":"#/definitions/ParticipantMetricTimestamps"},"packet_loss_percentage":{"description":"percent of packet lost","type":"number"},"tags":{"description":"Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.","items":{"description":"Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.","type":"string"},"type":"array"},"tags_info":{"$ref":"#/definitions/ParticipantTagInfo"},"total_packets_lost":{"description":"Count of packets lost.","maximum":2147483647,"minimum":-2147483648,"type":"integer"},"total_packets_received":{"description":"Count of packets received","maximum":2147483647,"minimum":-2147483648,"type":"integer"}},"required":["tags"],"type":"object"},"ParticipantMetricTimestamps":{"additionalProperties":false,"description":"timestamp of the event and value of the properties","properties":{"jitter":{"description":"Histogram with timestamp","items":{"$ref":"#/definitions/HistogramAndTimestamp"},"type":"array"},"latency":{"description":"Histogram with timestamp","items":{"$ref":"#/definitions/HistogramAndTimestamp"},"type":"array"},"packet_loss":{"description":"Percent of packet loss with timestamp","items":{"$ref":"#/definitions/PercentAndTimestamp"},"type":"array"}},"required":["packet_loss","jitter","latency"],"type":"object"},"ParticipantMetrics":{"additionalProperties":false,"description":"metrics definitions","properties":{"inbound":{"$ref":"#/definitions/ParticipantMetric"},"outbound":{"$ref":"#/definitions/ParticipantMetric"}},"type":"object"},"ParticipantProperties":{"additionalProperties":false,"description":"Properties set at start of conference","properties":{"beep_on_enter":{"description":"Boolean value set to allow beep on enter of conference","type":"boolean"},"beep_on_exit":{"description":"Boolean value set to allow beep on exist of conference","type":"boolean"},"end_conference_on_exit":{"description":"boolean value set to end the conference when the participant leave the conference","type":"boolean"},"enter_muted":{"description":"Boolean value set to join participant as muted in the conference.","type":"boolean"},"play_early_media":{"description":"boolean value set to allow an agent to hear the state of the outbound call, including ringing or disconnect messages.","type":"boolean"},"recording_enabled":{"description":"boolean value set to allow recording of the conference","type":"boolean"},"requested_region":{"default":"unknown","description":"Request region to mix the conference.","type":"string"},"start_conference_on_enter":{"description":"Boolean value set to start the conference when the participant joins the conference","type":"boolean"},"trim_recording":{"description":"boolean value set to trim leading and trailing silence from your recorded conference audio files.","type":"boolean"}},"required":["requested_region"],"type":"object"},"ParticipantTagInfo":{"additionalProperties":false,"description":"Object have details about the tag","properties":{"description":{"description":"Description about the tag.","type":"string"},"jitter":{"$ref":"#/definitions/ParticipantTagInfoProperties"},"latency":{"$ref":"#/definitions/ParticipantTagInfoProperties"},"low_mos":{"$ref":"#/definitions/ParticipantTagInfoProperties"},"packet_loss":{"$ref":"#/definitions/ParticipantTagInfoProperties"}},"type":"object"},"ParticipantTagInfoProperties":{"additionalProperties":false,"description":"Object to hold participant tag details.","properties":{"severity":{"default":"unknown","description":"Define the severity of the tag: high, medium","type":"string"}},"required":["severity"],"type":"object"},"PercentAndTimestamp":{"additionalProperties":false,"description":"Object to store percent and timestamp.","properties":{"percent":{"description":"Number in percentage.","type":"number"},"timestamp":{"description":"Unix timestamp when issue is experienced.","type":"integer"}},"type":"object"}},"description":"participant summary object","examples":[{"account_sid":"AC0000000000000000000000000000001","agent_audio":true,"call_direction":"inbound","call_sid":"CA0000000000000000000000000000001","call_state":"completed","call_status":"completed","call_type":"sip","coached_participants":["CP0000000000000000000000000000001"],"conference_region":"us1","conference_sid":"CF0000000000000000000000000000001","country_code":"US","duration_seconds":1800,"events":{"coaching":[1621837511],"coaching_stopped":[1621837521],"hold":[1621837451],"modify_beep":[1621837491],"modify_coached_participant":[1621837531],"modify_exit":[1621837501],"mute":[1621837471],"unhold":[1621837491],"unmute":[1621837481]},"from":"+1234567890","is_coach":true,"is_moderator":true,"jitter_buffer_size":"small","join_time":"2023-01-01T12:00:00Z","label":"advisor","leave_time":"2023-01-01T12:30:00Z","metrics":{"inbound":{"jitter":{"avg":5.5,"max":10.0},"latency":{"avg":5.5,"max":10.0},"mos":1.0,"occurrences":{"jitter":[{"avg":5.5,"max":10.0,"timestamp":1621837451}],"latency":[{"avg":5.5,"max":10.0,"timestamp":1621837451}],"packet_loss":[{"percent":0.0,"timestamp":1621837451}]},"packet_loss_percentage":0.0,"tags":["silent"],"tags_info":{"description":"High packet loss detected","jitter":{"severity":"high"},"latency":{"severity":"high"},"low_mos":{"severity":"high"},"packet_loss":{"severity":"high"}},"total_packets_lost":0,"total_packets_received":1000},"outbound":{"jitter":{"avg":5.5,"max":10.0},"latency":{"avg":5.5,"max":10.0},"mos":1.0,"occurrences":{"jitter":[{"avg":5.5,"max":10.0,"timestamp":1621837451}],"latency":[{"avg":5.5,"max":10.0,"timestamp":1621837451}],"packet_loss":[{"percent":0.0,"timestamp":1621837451}]},"packet_loss_percentage":0.0,"tags":["silent"],"tags_info":{"description":"High packet loss detected","jitter":{"severity":"high"},"latency":{"severity":"high"},"low_mos":{"severity":"high"},"packet_loss":{"severity":"high"}},"total_packets_lost":0,"total_packets_received":1000}},"outbound_queue_length":1,"outbound_time_in_queue":30,"participant_region":"us1","participant_sid":"CP0000000000000000000000000000001","processing_state":"complete","properties":{"beep_on_enter":true,"beep_on_exit":true,"end_conference_on_exit":true,"enter_muted":true,"play_early_media":true,"recording_enabled":true,"requested_region":"us1","start_conference_on_enter":true,"trim_recording":true},"quality_issues":0,"to":"+1234567890","whisper":"You are being recorded"}],"properties":{"account_sid":{"default":"","description":"The unique SID identifier of the account.","type":"string"},"agent_audio":{"description":"The value of agent_audio","type":"boolean"},"call_direction":{"default":"unknown","description":"Direction of media flow from the perspective of the edge. Inbound or outbound","type":"string"},"call_sid":{"default":"","description":"The unique SID identifier of the Call.","type":"string"},"call_state":{"default":"unknown","description":"Status of the call; completed, failed, etc.","type":"string"},"call_status":{"default":"unknown","description":"Status of the call","type":"string"},"call_type":{"default":"unknown","description":"Type of call: sip, pstn, client etc","type":"string"},"coached_participants":{"description":"Call sids coached by the participant","items":{"description":"Call sid coached by the participant","type":"string"},"type":"array"},"conference_region":{"default":"unknown","description":"Region of the conference mixed.","type":"string"},"conference_sid":{"default":"","description":"The unique SID identifier of the Conference.","type":"string"},"country_code":{"description":"Country Code of Participant","type":"string"},"duration_seconds":{"description":"Participant duration in seconds.","maximum":2147483647,"minimum":-2147483648,"type":"integer"},"events":{"$ref":"#/definitions/ParticipantEvents"},"from":{"description":"Call source.","type":"string"},"is_coach":{"description":"Is participant a coach","type":"boolean"},"is_moderator":{"description":"Is participant a moderator.","type":"boolean"},"jitter_buffer_size":{"default":"unknown","description":"Jitter buffer size for the connecting participant.","type":"string"},"join_time":{"default":"","description":"ISO format time participant joined.","type":"string"},"label":{"description":"Custom label for the participant resource, up to 64 characters.","type":"string"},"leave_time":{"default":"","description":"ISO format time participant left.","type":"string"},"metrics":{"$ref":"#/definitions/ParticipantMetrics"},"outbound_queue_length":{"description":"Call position in the queue","maximum":2147483647,"minimum":-2147483648,"type":"integer"},"outbound_time_in_queue":{"description":"Time spent in queue before joining the conference","maximum":2147483647,"minimum":-2147483648,"type":"integer"},"participant_region":{"default":"unknown","description":"Region of the participant conference mixed","type":"string"},"participant_sid":{"default":"","description":"The unique SID identifier of the participant.","type":"string"},"processing_state":{"default":"unknown","description":"Processing state for the Conference Summary resource.","type":"string"},"properties":{"$ref":"#/definitions/ParticipantProperties"},"quality_issues":{"description":"Count of issues detected","maximum":2147483647,"minimum":-2147483648,"type":"integer"},"to":{"description":"Call destination.","type":"string"},"whisper":{"description":"The value of whisper","type":"string"}},"required":["participant_sid","conference_sid","call_sid","account_sid","call_direction","call_state","join_time","leave_time","jitter_buffer_size","coached_participants","participant_region","conference_region","call_type"],"title":"PublicConferenceParticipantSummary","type":"object"}