# Conference Summary Resource A **Conference Summary** provides an overview of: * metadata, and * quality metrics for a single conference. Using the **Conference Summary Resource**, you can * [get a single summary for a specific conference](#get-a-conference-summary) * [get a list of summaries for multiple conferences](#get-multiple-conference-summaries). > \[!WARNING] > > [Voice Insights Advanced Features](/docs/voice/voice-insights/advanced-features) must be active to use this API Resource. > \[!NOTE] > > A completed Conference Summary may take up to 30 minutes to generate following the end of the conference. ## Conference Summary properties The following table details the properties of a single Conference Summary instance. ```json {"type":"object","refName":"insights.v1.conference","modelName":"insights_v1_conference","properties":{"conference_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^CF[0-9a-fA-F]{32}$","nullable":true,"description":"The unique SID identifier of the Conference."},"account_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$","nullable":true,"description":"The unique SID identifier of the Account."},"friendly_name":{"type":"string","nullable":true,"description":"Custom label for the conference resource, up to 64 characters.","x-twilio":{"pii":{"handling":"standard","deleteSla":30}}},"create_time":{"type":"string","format":"date-time","nullable":true,"description":"Conference creation date and time in ISO 8601 format."},"start_time":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp in ISO 8601 format when the conference started. Conferences do not start until at least two participants join, at least one of whom has startConferenceOnEnter=true."},"end_time":{"type":"string","format":"date-time","nullable":true,"description":"Conference end date and time in ISO 8601 format."},"duration_seconds":{"type":"integer","nullable":true,"description":"Conference duration in seconds."},"connect_duration_seconds":{"type":"integer","nullable":true,"description":"Duration of the between conference start event and conference end event in seconds."},"status":{"type":"string","nullable":true,"description":"Status of this Conference; `in_progress`, `not_started`, `completed` or `summary_timeout`. if Twilio don't receive `last_participant_left` event, summary will be timeout after 24 hours","enum":["in_progress","not_started","completed","summary_timeout"],"refName":"conference_enum_conference_status","modelName":"conference_enum_conference_status"},"max_participants":{"type":"integer","nullable":true,"description":"Maximum number of concurrent participants as specified by the configuration."},"max_concurrent_participants":{"type":"integer","nullable":true,"description":"Actual maximum number of concurrent participants in the conference."},"unique_participants":{"type":"integer","nullable":true,"description":"Unique conference participants based on caller ID."},"end_reason":{"type":"string","nullable":true,"description":"Conference end reason; e.g. last participant left, modified by API, etc.","enum":["last_participant_left","conference_ended_via_api","participant_with_end_conference_on_exit_left","last_participant_kicked","participant_with_end_conference_on_exit_kicked"],"refName":"conference_enum_conference_end_reason","modelName":"conference_enum_conference_end_reason"},"ended_by":{"type":"string","minLength":34,"maxLength":34,"pattern":"^CA[0-9a-fA-F]{32}$","nullable":true,"description":"Call SID of the participant whose actions ended the conference."},"mixer_region":{"type":"string","nullable":true,"description":"Twilio region where the conference media was mixed.","enum":["us1","us2","au1","br1","ie1","jp1","sg1","de1","in1"],"refName":"conference_enum_region","modelName":"conference_enum_region"},"mixer_region_requested":{"type":"string","nullable":true,"description":"Twilio region where conference mixed was specified to be mixed in configuration.","enum":["us1","us2","au1","br1","ie1","jp1","sg1","de1","in1"],"refName":"conference_enum_region","modelName":"conference_enum_region"},"recording_enabled":{"type":"boolean","nullable":true,"description":"Boolean. Indicates whether recording was enabled at the conference mixer."},"detected_issues":{"nullable":true,"description":"Potential issues detected by Twilio during the conference."},"tags":{"type":"array","nullable":true,"description":"Tags for detected conference conditions and participant behaviors which may be of interest.","items":{"type":"string","enum":["invalid_requested_region","duplicate_identity","start_failure","region_configuration_issues","quality_warnings","participant_behavior_issues","high_packet_loss","high_jitter","high_latency","low_mos","detected_silence","no_concurrent_participants"],"refName":"conference_enum_tag","modelName":"conference_enum_tag"}},"tag_info":{"nullable":true,"description":"Object. Contains details about conference tags including severity."},"processing_state":{"type":"string","nullable":true,"description":"Processing state for the Conference Summary resource. Will be `in_progress` while data is being aggregated, `timeout` if Twilio couldn't process the summary in 24hrs, and `complete` once aggregations and analysis has ended.","enum":["complete","in_progress","timeout"],"refName":"conference_enum_processing_state","modelName":"conference_enum_processing_state"},"url":{"type":"string","format":"uri","nullable":true,"description":"The URL of this resource."},"links":{"type":"object","format":"uri-map","nullable":true,"description":"Contains a dictionary of URL links to nested resources of this Conference."}}} ``` ## Get a Conference Summary `GET https://insights.twilio.com/v1/Conferences/{ConferenceSid}` ### Path parameters ```json [{"name":"ConferenceSid","in":"path","description":"The unique SID identifier of the Conference.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^CF[0-9a-fA-F]{32}$"},"required":true}] ``` Get a Conference Summary ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function fetchConference() { const conference = await client.insights.v1 .conferences("CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") .fetch(); console.log(conference.conferenceSid); } fetchConference(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) conference = client.insights.v1.conferences( "CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" ).fetch() print(conference.conference_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Insights.V1; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var conference = await ConferenceResource.FetchAsync( pathConferenceSid: "CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"); Console.WriteLine(conference.ConferenceSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.insights.v1.Conference; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); Conference conference = Conference.fetcher("CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX").fetch(); System.out.println(conference.getConferenceSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() resp, err := client.InsightsV1.FetchConference("CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.ConferenceSid != nil { fmt.Println(*resp.ConferenceSid) } else { fmt.Println(resp.ConferenceSid) } } } ``` ```php insights->v1 ->conferences("CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") ->fetch(); print $conference->conferenceSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) conference = @client .insights .v1 .conferences('CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') .fetch puts conference.conference_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:insights:v1:conferences:fetch \ --conference-sid CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ``` ```bash curl -X GET "https://insights.twilio.com/v1/Conferences/CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "conference_sid": "CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "friendly_name": "conference1", "start_time": "2021-10-08T02:58:51Z", "create_time": "2021-10-08T02:58:47Z", "end_time": "2021-10-08T03:00:02Z", "duration_seconds": 76, "connect_duration_seconds": 72, "status": "completed", "max_participants": 250, "max_concurrent_participants": 4, "unique_participants": 4, "end_reason": "last_participant_left", "ended_by": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "mixer_region": "us1", "mixer_region_requested": "us1", "recording_enabled": false, "processing_state": "complete", "detected_issues": { "call_quality": 1, "region_configuration": 0, "participant_behavior": 3 }, "tags": [ "duplicate_identity", "detected_silence", "participant_behavior_issues" ], "tag_info": null, "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "links": { "conference_participants": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants" } } ``` ## Get multiple Conference Summaries `GET https://insights.twilio.com/v1/Conferences` The Conference Summary list resource allows results to be filtered by: * date, * friendly name, * region, and * other dimensions. By default, the Conference Summary list resource returns a list of conferences hosted in the last 24 hours. To get multiple Conference Summaries of Conferences hosted prior to the last 24 hours, specify the `CreatedAfter` and/or `CreatedBefore` query parameters. ### Query parameters ```json [{"name":"ConferenceSid","in":"query","description":"The SID of the conference.","schema":{"type":"string"}},{"name":"FriendlyName","in":"query","description":"Custom label for the conference resource, up to 64 characters.","schema":{"type":"string"},"x-twilio":{"pii":{"handling":"standard","deleteSla":30}},"examples":{"readWithFriendlynameStartfailure":{"value":"outboundConfCallTransferThrice_1"}}},{"name":"Status","in":"query","description":"Conference status.","schema":{"type":"string"},"examples":{"readWithRegion":{"value":"completed"},"readWithFriendlynameStartfailure":{"value":"not_started"}}},{"name":"CreatedAfter","in":"query","description":"Conferences created after the provided timestamp specified in ISO 8601 format","schema":{"type":"string"},"examples":{"readFull":{"value":"2021-10-09T17:20:53Z"}}},{"name":"CreatedBefore","in":"query","description":"Conferences created before the provided timestamp specified in ISO 8601 format.","schema":{"type":"string"},"examples":{"readFull":{"value":"2021-10-12T18:37:53Z"}}},{"name":"MixerRegion","in":"query","description":"Twilio region where the conference media was mixed.","schema":{"type":"string"},"examples":{"readWithRegion":{"value":"au1"}}},{"name":"Tags","in":"query","description":"Tags applied by Twilio for common potential configuration, quality, or performance issues.","schema":{"type":"string"},"examples":{"readWithDuplicateIdentity":{"value":"duplicate_identity"}}},{"name":"Subaccount","in":"query","description":"Account SID for the subaccount whose resources you wish to retrieve.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$"}},{"name":"DetectedIssues","in":"query","description":"Potential configuration, behavior, or performance issues detected during the conference.","schema":{"type":"string"},"examples":{"readWithDetectedIssueEndreason":{"value":"call_quality"}}},{"name":"EndReason","in":"query","description":"Conference end reason; e.g. last participant left, modified by API, etc.","schema":{"type":"string"},"examples":{"readWithDetectedIssueEndreason":{"value":"participant_with_end_conference_on_exit_left"}}},{"name":"PageSize","in":"query","description":"How many resources to return in each list page. The default is 50, and the maximum is 1000.","schema":{"type":"integer","format":"int64","minimum":1,"maximum":1000}},{"name":"Page","in":"query","description":"The page index. This value is simply for client state.","schema":{"type":"integer","minimum":0}},{"name":"PageToken","in":"query","description":"The page token. This is provided by the API.","schema":{"type":"string"}}] ``` Get multiple Conference Summaries ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function listConference() { const conferences = await client.insights.v1.conferences.list({ limit: 20 }); conferences.forEach((c) => console.log(c.conferenceSid)); } listConference(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) conferences = client.insights.v1.conferences.list(limit=20) for record in conferences: print(record.conference_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Insights.V1; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var conferences = await ConferenceResource.ReadAsync(limit: 20); foreach (var record in conferences) { Console.WriteLine(record.ConferenceSid); } } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.insights.v1.Conference; import com.twilio.base.ResourceSet; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); ResourceSet conferences = Conference.reader().limit(20).read(); for (Conference record : conferences) { System.out.println(record.getConferenceSid()); } } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" insights "github.com/twilio/twilio-go/rest/insights/v1" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &insights.ListConferenceParams{} params.SetLimit(20) resp, err := client.InsightsV1.ListConference(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { for record := range resp { if resp[record].ConferenceSid != nil { fmt.Println(*resp[record].ConferenceSid) } else { fmt.Println(resp[record].ConferenceSid) } } } } ``` ```php insights->v1->conferences->read([], 20); foreach ($conferences as $record) { print $record->conferenceSid; } ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) conferences = @client .insights .v1 .conferences .list(limit: 20) conferences.each do |record| puts record.conference_sid end ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:insights:v1:conferences:list ``` ```bash curl -X GET "https://insights.twilio.com/v1/Conferences?PageSize=20" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "meta": { "page": 0, "page_size": 25, "first_page_url": "https://insights.twilio.com/v1/Conferences?CreatedAfter=2021-10-09T17%3A20%3A53Z&CreatedBefore=2021-10-12T18%3A37%3A53Z&PageSize=25&Page=0", "previous_page_url": null, "url": "https://insights.twilio.com/v1/Conferences?CreatedAfter=2021-10-09T17%3A20%3A53Z&CreatedBefore=2021-10-12T18%3A37%3A53Z&PageSize=25&Page=0", "next_page_url": null, "key": "conferences" }, "conferences": [ { "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "friendly_name": "conference 1", "start_time": "2021-10-12T18:11:10Z", "create_time": "2021-10-12T18:11:09Z", "end_time": "2021-10-12T18:11:15Z", "duration_seconds": 7, "connect_duration_seconds": 5, "status": "completed", "max_participants": 250, "max_concurrent_participants": 2, "unique_participants": 2, "end_reason": "last_participant_left", "ended_by": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "mixer_region": "us1", "mixer_region_requested": null, "recording_enabled": false, "processing_state": "complete", "detected_issues": { "call_quality": 1, "region_configuration": 0, "participant_behavior": 0 }, "tags": null, "tag_info": null, "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "links": { "conference_participants": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants" } }, { "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "friendly_name": "conference 2", "start_time": null, "create_time": "2021-10-12T18:09:21Z", "end_time": "2021-10-12T18:09:21Z", "duration_seconds": 1, "connect_duration_seconds": 0, "status": "completed", "max_participants": 250, "max_concurrent_participants": 2, "unique_participants": 3, "end_reason": "last_participant_left", "ended_by": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "mixer_region": "us1", "mixer_region_requested": null, "recording_enabled": false, "processing_state": "complete", "detected_issues": { "call_quality": 1, "region_configuration": 0, "participant_behavior": 0 }, "tags": [ "detected_silence", "participant_behavior_issues" ], "tag_info": null, "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "links": { "conference_participants": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab/Participants" } } ] } ``` Get multiple Conference Summaries for a subaccount ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function listConference() { const conferences = await client.insights.v1.conferences.list({ subaccount: "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", limit: 20, }); conferences.forEach((c) => console.log(c.conferenceSid)); } listConference(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) conferences = client.insights.v1.conferences.list( subaccount="ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", limit=20 ) for record in conferences: print(record.conference_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Insights.V1; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var conferences = await ConferenceResource.ReadAsync( subaccount: "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", limit: 20); foreach (var record in conferences) { Console.WriteLine(record.ConferenceSid); } } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.insights.v1.Conference; import com.twilio.base.ResourceSet; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); ResourceSet conferences = Conference.reader().setSubaccount("ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX").limit(20).read(); for (Conference record : conferences) { System.out.println(record.getConferenceSid()); } } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" insights "github.com/twilio/twilio-go/rest/insights/v1" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &insights.ListConferenceParams{} params.SetSubaccount("ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") params.SetLimit(20) resp, err := client.InsightsV1.ListConference(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { for record := range resp { if resp[record].ConferenceSid != nil { fmt.Println(*resp[record].ConferenceSid) } else { fmt.Println(resp[record].ConferenceSid) } } } } ``` ```php insights->v1->conferences->read( ["subaccount" => "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"], 20 ); foreach ($conferences as $record) { print $record->conferenceSid; } ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) conferences = @client .insights .v1 .conferences .list( subaccount: 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', limit: 20 ) conferences.each do |record| puts record.conference_sid end ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:insights:v1:conferences:list \ --subaccount ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ``` ```bash curl -X GET "https://insights.twilio.com/v1/Conferences?Subaccount=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&PageSize=20" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "meta": { "page": 0, "page_size": 25, "first_page_url": "https://insights.twilio.com/v1/Conferences?CreatedAfter=2021-10-09T17%3A20%3A53Z&CreatedBefore=2021-10-12T18%3A37%3A53Z&PageSize=25&Page=0", "previous_page_url": null, "url": "https://insights.twilio.com/v1/Conferences?CreatedAfter=2021-10-09T17%3A20%3A53Z&CreatedBefore=2021-10-12T18%3A37%3A53Z&PageSize=25&Page=0", "next_page_url": null, "key": "conferences" }, "conferences": [ { "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "friendly_name": "conference 1", "start_time": "2021-10-12T18:11:10Z", "create_time": "2021-10-12T18:11:09Z", "end_time": "2021-10-12T18:11:15Z", "duration_seconds": 7, "connect_duration_seconds": 5, "status": "completed", "max_participants": 250, "max_concurrent_participants": 2, "unique_participants": 2, "end_reason": "last_participant_left", "ended_by": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "mixer_region": "us1", "mixer_region_requested": null, "recording_enabled": false, "processing_state": "complete", "detected_issues": { "call_quality": 1, "region_configuration": 0, "participant_behavior": 0 }, "tags": null, "tag_info": null, "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "links": { "conference_participants": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants" } }, { "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "friendly_name": "conference 2", "start_time": null, "create_time": "2021-10-12T18:09:21Z", "end_time": "2021-10-12T18:09:21Z", "duration_seconds": 1, "connect_duration_seconds": 0, "status": "completed", "max_participants": 250, "max_concurrent_participants": 2, "unique_participants": 3, "end_reason": "last_participant_left", "ended_by": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "mixer_region": "us1", "mixer_region_requested": null, "recording_enabled": false, "processing_state": "complete", "detected_issues": { "call_quality": 1, "region_configuration": 0, "participant_behavior": 0 }, "tags": [ "detected_silence", "participant_behavior_issues" ], "tag_info": null, "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "links": { "conference_participants": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab/Participants" } } ] } ``` Get multiple Conference Summaries in ie1 with call quality detected issues ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function listConference() { const conferences = await client.insights.v1.conferences.list({ detectedIssues: "call_quality", mixerRegion: "ie1", limit: 20, }); conferences.forEach((c) => console.log(c.conferenceSid)); } listConference(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) conferences = client.insights.v1.conferences.list( mixer_region="ie1", detected_issues="call_quality", limit=20 ) for record in conferences: print(record.conference_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Insights.V1; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var conferences = await ConferenceResource.ReadAsync( mixerRegion: "ie1", detectedIssues: "call_quality", limit: 20); foreach (var record in conferences) { Console.WriteLine(record.ConferenceSid); } } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.insights.v1.Conference; import com.twilio.base.ResourceSet; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); ResourceSet conferences = Conference.reader().setMixerRegion("ie1").setDetectedIssues("call_quality").limit(20).read(); for (Conference record : conferences) { System.out.println(record.getConferenceSid()); } } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" insights "github.com/twilio/twilio-go/rest/insights/v1" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &insights.ListConferenceParams{} params.SetMixerRegion("ie1") params.SetDetectedIssues("call_quality") params.SetLimit(20) resp, err := client.InsightsV1.ListConference(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { for record := range resp { if resp[record].ConferenceSid != nil { fmt.Println(*resp[record].ConferenceSid) } else { fmt.Println(resp[record].ConferenceSid) } } } } ``` ```php insights->v1->conferences->read( [ "mixerRegion" => "ie1", "detectedIssues" => "call_quality", ], 20 ); foreach ($conferences as $record) { print $record->conferenceSid; } ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) conferences = @client .insights .v1 .conferences .list( mixer_region: 'ie1', detected_issues: 'call_quality', limit: 20 ) conferences.each do |record| puts record.conference_sid end ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:insights:v1:conferences:list \ --mixer-region ie1 \ --detected-issues call_quality ``` ```bash curl -X GET "https://insights.twilio.com/v1/Conferences?MixerRegion=ie1&DetectedIssues=call_quality&PageSize=20" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "meta": { "page": 0, "page_size": 25, "first_page_url": "https://insights.twilio.com/v1/Conferences?CreatedAfter=2021-10-09T17%3A20%3A53Z&CreatedBefore=2021-10-12T18%3A37%3A53Z&PageSize=25&Page=0", "previous_page_url": null, "url": "https://insights.twilio.com/v1/Conferences?CreatedAfter=2021-10-09T17%3A20%3A53Z&CreatedBefore=2021-10-12T18%3A37%3A53Z&PageSize=25&Page=0", "next_page_url": null, "key": "conferences" }, "conferences": [ { "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "friendly_name": "conference 1", "start_time": "2021-10-12T18:11:10Z", "create_time": "2021-10-12T18:11:09Z", "end_time": "2021-10-12T18:11:15Z", "duration_seconds": 7, "connect_duration_seconds": 5, "status": "completed", "max_participants": 250, "max_concurrent_participants": 2, "unique_participants": 2, "end_reason": "last_participant_left", "ended_by": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "mixer_region": "us1", "mixer_region_requested": null, "recording_enabled": false, "processing_state": "complete", "detected_issues": { "call_quality": 1, "region_configuration": 0, "participant_behavior": 0 }, "tags": null, "tag_info": null, "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "links": { "conference_participants": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants" } }, { "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "friendly_name": "conference 2", "start_time": null, "create_time": "2021-10-12T18:09:21Z", "end_time": "2021-10-12T18:09:21Z", "duration_seconds": 1, "connect_duration_seconds": 0, "status": "completed", "max_participants": 250, "max_concurrent_participants": 2, "unique_participants": 3, "end_reason": "last_participant_left", "ended_by": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "mixer_region": "us1", "mixer_region_requested": null, "recording_enabled": false, "processing_state": "complete", "detected_issues": { "call_quality": 1, "region_configuration": 0, "participant_behavior": 0 }, "tags": [ "detected_silence", "participant_behavior_issues" ], "tag_info": null, "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab", "links": { "conference_participants": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab/Participants" } } ] } ```