# TwiML™ Voice: \ \ allows [Twilio Frontline](/docs/frontline) customers using Voice functionality to customize call behavior. Frontline's default behavior handles call routing to and from a Frontline worker, as well as creating new [Conversations](/docs/conversations) and assigning workers to those new Conversations. If you already like Frontline's default behavior for your use case, you don't need to use \. \\ allows you to: * execute other Voice TwiML instructions before connecting a customer and a Frontline worker * configure in-call behavior * configure call behavior after a participant leaves the call or when an error occurs \ is a TwiML noun that must be nested within the \ verb. > \[!NOTE] > > If you want to use \, you will first need to configure your Frontline instance in your Twilio Console.\ > You should read through the [Advanced Voice Configuration page](/docs/frontline/advanced-voice-configuration) before using \\. ## Configure call behavior with \\ \\ allows you to modify call behavior before, during, and after a call between a Frontline worker and customer. Read the subsections below to learn how to use \\ to meet your use case's needs. ### Modify call behavior **before** connecting to Frontline If you want Twilio to execute TwiML instructions before connecting a Frontline worker and customer, you should first direct calls to that set of TwiML instructions. When appropriate, you should then give Twilio \\ TwiML instructions. Some ways you can do this include: * using \\ in the same TwiML document as the initial instructions * providing \\ in response to Twilio's request to an `action` URL (like in [\](/docs/voice/twiml/gather)) * updating the TwiML of the call with the [Call Resource](/docs/voice/api/call-resource) ### Modify call behavior **during** a Frontline Voice call \ provides [attributes](#conversation-attributes) that allow you to modify some call and Frontline Conversation behavior. The table below shows the behaviors you can modify and the associated \ attributes. Click on an attribute to jump to its section on this page. | Behavior | Attributes that modify behavior | | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Recording | [record](#record) [trim](#trim) [recordingStatusCallback](#recordingstatuscallback) [recordingStatusCallbackEvent](#recordingstatuscallbackevent) [recordingStatusCallbackMethod](#recordingstatuscallbackmethod) | | Autocreating Frontline Conversations | [inboundAutocreation](#inboundautocreation) [routingAssignmentTimeout](#routingassignmenttimeout) | | Inbound call timeout | [inboundTimeout](#inboundtimeout) | | Monitoring call and \\ session status | [statusCallback](#statuscallback) [statusCallbackEvent](#statuscallbackevent) [statusCallbackMethod](#statuscallbackmethod) | ### Modify call behavior **after** a \\ session ends If you want to customize the behavior of a Frontline Voice call after one party hangs up or when an error occurs, you should use [\'s action attribute](#action). After a \\ session ends, Twilio will send a request to the `action` URL and expect a new set of TwiML instructions. This will require you to set up a separate TwiML endpoint that can dynamically generate TwiML based on [the information Twilio sends to the action URL](#twilios-request-to-the-action-url). You should decide how you want to handle each type of `Result` value (and/or any other values within the request from Twilio) and then create and return the appropriate TwiML. Use \\ ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation(service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') end puts response ``` ```xml ``` ## \ attributes \ is a TwiML noun that is nested within the \ verb. \'s `action` and `method` attributes allow you to execute a new set of TwiML instructions for a call after the \\ session ends. | Attribute name | Allowed values | Default values | | -------------- | ------------------------ | -------------------- | | `action` | Relative or absolute URL | current document URL | | `method` | `GET`, `POST` | `POST` | ### action The `action` attribute takes an absolute or relative URL as a value. After a \\ session ends, Twilio will send an HTTP request to this `action` URL and will expect a new set of TwiML instructions in the response. If you do not provide an `action` attribute, Twilio will request TwiML from the current TwiML document. This HTTP request's body will contain the information about the result of the \\ session, along with [Twilio's standard request parameters](/docs/voice/twiml#request-parameters). See [Twilio's request to the action URL section below](#twilios-request-to-the-action-url) for more information on the shape of this request body. A \\ session ends (and thereby triggers Twilio's HTTP request to the `action` URL) in the following ways: * one or both of the parties on the call hangs up * the new call is incomplete, meaning there is no answer or some error occurs when connecting the two parties * the attempt to autocreate a new Conversation fails * a new Conversation is created, but no worker is assigned before the timeout that was set in the [routingAssignmentTimeout](#routingassignmenttimeout) attribute * an invalid Conversation SID is used when attempting to look up an existing Conversation * an inbound call comes in without an existing Conversation and your Frontline instance has disabled inbound Conversation autocreation * an internal error occurs The reason a \\ ends is included in the `Result` property in the body of Twilio's request to your `action` URL. Use \'s action attribute with \ ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect({ action: 'https://example.com/yourActionUrl' }); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect(action='https://example.com/yourActionUrl') connect.conversation(service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(action: new Uri("https://example.com/yourActionUrl")); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").build(); Connect connect = new Connect.Builder().action("https://example.com/yourActionUrl").conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(['action' => 'https://example.com/yourActionUrl']); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect(action: 'https://example.com/yourActionUrl') do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') end puts response ``` ```xml ``` #### Twilio's request to the action URL The request body of Twilio's request to the `action` URL contains some properties that provide information about the \\ session, along with [Twilio's standard request parameters](/docs/voice/twiml#request-parameters). These \\-related properties are listed below. **Property**: **`Result`** Description: The result of the \ session. Possible values are: * `"session-success"` The customer and Frontline worker were successfully connected with a Voice call and at least one party hung up. * `"dialed-call-incomplete"` The attempt to dial the other party was unsuccessful, either due to an error or no answer. * `"failed-create-conversation"` Given that the `inboundAutocreation` attribute for \ is `true`, Twilio will attempt to create a new Conversation for inbound calls from customers who are not yet part of a Conversation. If the creation of this new Conversation is unsuccessful, the `"failed-create-conversation"` value is returned. * `"no-other-participants"` Given that the `inboundAutocreation` attribute for \ is `true`, Twilio will create a new Conversation with the customer as one of the Participants and then attempt to add a Frontline worker as the other Participant. If no worker is assigned before the timeout, `"no-other-participants"` is returned. The timeout is 5 seconds by default, but can be modified using the `routingAssignmentTimeout` \ attribute. * `"invalid-conversation"` This error occurs for outbound calls in which the Conversation SID sent by the Frontline App is invalid. * `"no-existing-conversation"` Given that the `inboundAutocreation` attribute for \ is `false`, this error arises when a caller that is not a Participant in an existing Conversation attempts to make an inbound call to your Frontline instance. The call is rejected and `"no-existing-conversation"` is returned. * `"internal-error"` This error occurs when some internal condition caused the \ session to be unsuccessful. **Property**: **`WorkerInitiated`** Description: A Boolean that indicates whether the call was initiated by a Frontline worker. The value is `true` for outbound calls initiated by a Frontline worker. The value is `false` when the call was not initiated by a Frontline worker. **Property**: **`DialCallStatus`** Description: This indicates the outcome of the attempt to connect (or "Dial") the caller with the intended recipient. Possible values are: * `"completed"` The intended recipient answered the call and the two Participants were connected successfully. * `"busy"` Twilio received a busy signal when trying to connect to the intended recipient. * `"no-answer"` The intended recipient did not answer the call before the timeout period ended. * `"failed"` Twilio was unable to route the call to the intended recipient. This is often caused by attempting to call a properly-formatted but non-existent phone number. * `"canceled"` The call was canceled via the REST API before it was answered. **Property**: **`DialCallSid`** Description: The Call SID of the new call leg that is created when connecting the two Participants **Property**: **`DialCallDuration`** Description: The duration, in seconds, of the new call leg that is created when connecting the two Participants **Property**: **`RecordingSid`** Description: The Recording SID of the Call Recording (if applicable) **Property**: **`RecordingDuration`** Description: The duration, in seconds, of the Call Recording (if applicable) **Property**: **`RecordingUrl`** Description: The URL of the Call Recording. This parameter is included only if the `record` \ attribute is used. This parameter is not included for Recordings initiated in other ways. The Recording file may not yet be accessible at the moment the `action` callback is received. Use the `recordingStatusCallback` \ attribute to be notified when the recording is available. > \[!WARNING] > > Without an `action` URL and without subsequent TwiML instructions after \\, the call will end. #### Responding to Twilio's request to the action URL Your application should dynamically provide new TwiML instructions based on the result of the \\ session. This may involve checking the values of the `Result`, `WorkerInitiated`, and `DialCallStatus` properties in Twilio's request to your `action` URL. The example scenario below illustrates how you can handle Twilio's request to the `action` URL in order to execute another set of TwiML instructions. **Example: Prompting a customer to leave a voicemail** 1. A customer calls your Frontline number, which is configured with the following TwiML instructions: ```xml ``` 2. Twilio finds the matching Conversation and dials the appropriate Frontline worker. 3. The Frontline worker does not answer within 20 seconds, so the \\ session ends and Twilio sends a request to your `action` URL `https://example.com/myActionUrl`. 4. Your endpoint at `https://example.com/myActionUrl` checks that the request contains a `Result` value of `no-answer`, and then responds to Twilio with the following TwiML instructions that prompt the caller to leave a voicemail: ```xml Sorry, your personal advisor is not available right now. Please leave a message after the tone. Thank you! ``` **Note:** Since the recording in this example is started by [\ TwiML](/docs/voice/twiml/record) (rather than \'s `record` attribute), the details about this recording are sent to the \ verb's `recordingStatusCallback` URL. ### method This optional \ attribute indicates the HTTP request method to be used when Twilio sends a request to the `action` URL. If you don't specify a method attribute in \, `POST` is used by default. The allowed values are `POST` and `GET`. Use \'s action and method attributes with \ ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect({ action: 'https://example.com/yourActionUrl', method: 'GET' }); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect(action='https://example.com/yourActionUrl', method='GET') connect.conversation(service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(action: new Uri("https://example.com/yourActionUrl"), method: Twilio.Http.HttpMethod.Get); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; import com.twilio.http.HttpMethod; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").build(); Connect connect = new Connect.Builder().action("https://example.com/yourActionUrl").method(HttpMethod.GET).conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(['action' => 'https://example.com/yourActionUrl', 'method' => 'GET']); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect(action: 'https://example.com/yourActionUrl', method: 'GET') do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') end puts response ``` ```xml ``` ## \ attributes The table below lists all of the \ attributes and the allowed values for each. Click on an attribute to learn more. All attributes are optional **except** `serviceInstanceSid`. | Attribute | Allowed Values | | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [serviceInstanceSid](#serviceinstancesid) | Your Frontline Conversation Service SID.

This attribute is *required*. | | [inboundAutocreation](#inboundautocreation)

default: `true` | `true`, `false` | | [routingAssignmentTimeout](#routingassignmenttimeout)

default: `5` | an integer | | [inboundTimeout](#inboundtimeout)

default: `60` | an integer | | [record](#record)

default: `do-not-record` |
  • `record-from-answer`
  • `record-from-ringing`
  • `record-from-answer-dual`
  • `record-from-ringing-dual`
  • `true`
  • `false`
| | [trim](#trim)

default: `do-not-trim` |
  • `trim-silence`
  • `do-not-trim`
| | [recordingStatusCallback](#recordingstatuscallback) | an absolute URL | | [recordingStatusCallbackMethod](#recordingstatuscallbackmethod)

default: `POST` | `GET`, `POST` | | [recordingStatusCallbackEvent](#recordingstatuscallbackevent)

default: `completed absent` |
  • `in-progress`
  • `completed`
  • `absent`
  • any combination of the above separated by a space
| | [statusCallback](#statuscallback) | a relative or absolute URL | | [statusCallbackMethod](#statuscallbackmethod)

default: `POST` | `GET`, `POST` | | [statusCallbackEvent](#statuscallbackevent)

default: `completed` |
  • `call-initiated`
  • `call-ringing`
  • `call-answered`
  • `call-completed`
  • any combination of the above separated by a space
| | [url](#url) | a relative or absolute URL | ### serviceInstanceSid *required* The `serviceInstanceSid` \ attribute indicates your Frontline Conversation Service's SID. This tells Twilio in which Conversation Service a Frontline Conversation should be created or found. Find your Frontline Conversation Service SID in your Console: 1. Go to **Explore Products** and pin **Conversations** to the sidebar. 2. In the left navigation, click on **Conversations > Manage > Services** and find **Frontline Service**. The SID is listed next to it. Use \\ with serviceInstanceSid attribute ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation(service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') end puts response ``` ```xml ``` [back to attributes list](#conversation-attributes) ### inboundAutocreation When Twilio executes \ TwiML for inbound calls (from a customer towards your Frontline instance), Twilio will check to see if a Conversation already exists between the caller and the number that the caller dialed. For an inbound call, if no Conversation is found and the `inboundAutocreation` attribute is set to `true`, Twilio will create a new Conversation with the caller as a Participant. For an inbound call, if no Conversation is found and the `inboundAutocreation` attribute is set to `false`, the call will be rejected and Twilio's request to the `action` URL will contain a `Result` property with the value `"no-existing-conversation"`. This attribute is the equivalent of the **Autocreate a Conversation** setting for incoming messages on the **Integration** page of your Messaging Service in the Console. The default value of the `inboundAutocreation` attribute is `true`. Use \ with inboundAutocreation attribute ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inboundAutocreation: true }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inbound_autocreation=True) response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", inboundAutocreation: true); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").inboundAutocreation(true).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'inboundAutocreation' => 'true']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inbound_autocreation: true) end puts response ``` ```xml ``` [back to attributes list](#conversation-attributes) ### routingAssignmentTimeout When Twilio executes \ TwiML for inbound calls (from a customer towards your Frontline instance), Twilio will check to see if an existing Conversation exists between the caller and the number that the caller dialed. For an inbound call in which no Conversation is found and the `inboundAutocreation` attribute is set to `true`, Twilio will create a new Conversation with the caller as a Participant and then will wait for your Frontline instance to assign a Frontline worker via [Pool routing](/docs/frontline/handle-incoming-conversations#3-pool-routing) or [Custom routing](/docs/frontline/handle-incoming-conversations#2-custom-routing). By default, Twilio will wait 5 seconds for a Frontline worker Participant to be added to the Conversation. If no Frontline worker Participant is added before the timeout, the \ session will end and Twilio's request to the `action` URL will contain a `Result` property with the value `"no-other-participants"`. > \[!WARNING] > > In the event that the `Result` value is `"no-other-participants"`, you should check that your Frontline routing is set up properly. > > This result means that the Conversation that was created is unusable, since no Frontline worker is associated with that customer. You can programmatically [delete the Conversation via the API](/docs/conversations/api/conversation-resource) or you can use the Console. > > You will also want to consider what TwiML you want Twilio to execute in this case (maybe \ an error message or a \ prompting the customer to leave a message followed by a \). Use \ with inboundAutocreation and routingAssignmentTimeout attributes ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inboundAutocreation: true, routingAssignmentTimeout: '10' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inbound_autocreation=True, routing_assignment_timeout='10') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", inboundAutocreation: true, routingAssignmentTimeout: 10); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").inboundAutocreation(true).routingAssignmentTimeout(10).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'inboundAutocreation' => 'true', 'routingAssignmentTimeout' => '10']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inbound_autocreation: true, routing_assignment_timeout: '10') end puts response ``` ```xml ``` [back to attributes list](#conversation-attributes) ### inboundTimeout The `inboundTimeout` attribute is the number of seconds a \ session will wait for a Frontline worker to answer a call from a customer. The default `inboundTimeout` value is `60`. Use \ with inboundTimeout attribute ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inboundTimeout: '10' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inbound_timeout='10') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", inboundTimeout: 10); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").inboundTimeout(10).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'inboundTimeout' => '10']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', inbound_timeout: '10') end puts response ``` ```xml ``` #### Request to \'s action URL after timeout After the `inboundTimeout` period has passed, the URL specified in \'s `action` attribute will receive a request containing a `Result` parameter with a value of `dialed-call-incomplete`. The request will also contain a `DialCallStatus` parameter with a value of `no-answer`. #### Request to the statusCallback URL after timeout If you provided a URL in \'s `statusCallback` attribute and you've included `call-completed` in \'s `statusCallbackEvent` parameter, that URL will receive a request with a `Status` parameter with a value of `call-completed`. This doesn't necessarily mean the call ended, but rather means that particular leg of the call (that connected the Frontline worker and the customer) is complete. More details about why/how the call leg ended can be found in the [request to the action URL](#twilios-request-to-the-action-url) in the `DialCallStatus` property. [back to attributes list](#conversation-attributes) ### record The `record` attribute allows you to record both parties in a call within the \ session. Recordings are available to be saved in mono-channel or dual-channel format. The default value is `do-not-record`. The allowed values are as follows: * `do-not-record` * `record-from-answer` * `record-from-answer-dual` * `record-from-ringing` * `record-from-ringing-dual` * `true` * `false` For backward compatibility, `true` is an alias for `record-from-answer` and `false` is an alias for `do-not-record`. Learn more about Recordings on the [Recording Resource page](/docs/voice/api/recording). Use \\ with record attribute ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record='record-from-answer') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", record: Conversation.RecordEnum.RecordFromAnswer); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").record(Conversation.Record .RECORD_FROM_ANSWER).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'record' => 'record-from-answer']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer') end puts response ``` ```xml ``` #### Mono-channel recordings For mono-channel recordings, audio from both parties in a call are mixed down into a single channel in a single recording file. To enable mono-channel recordings, you can choose one of the following values for \'s `record` attribute: * `record-from-answer`: the recording will start as soon as the call is answered * `record-from-ringing`: the recording will start when the call starts ringing, before the recipient answers the call #### Dual-channel recordings For dual-channel recordings, audio from both parties in a call are contained in separate channels within a single recording file. For dual-channel recordings, you can choose one of the following values for \'s `record` attribute: * `record-from-answer-dual`: the recording will start as soon as the call is answered * `record-from-ringing-dual`: the recording will start when the call starts ringing, before the recipient answers the call [back to attributes list](#conversation-attributes) ### trim The `trim` attribute allows you to trim leading and trailing silence from your recording's audio files. This attribute is only valid when recording is enabled. The default value is `do-not-trim`. The allowed values are as follows: * `do-not-trim`: Audio recordings will contain leading and trailing silence. * `trim-silence`: Audio recordings will not contain leading and trailing silence. Trimming a file may cause the duration of the recording to be slightly less than the duration of the call. Use \\ with record and trim attributes ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer', trim: 'trim-silence' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record='record-from-answer', trim='trim-silence') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", record: "record-from-answer", trim: Conversation.TrimEnum.TrimSilence); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").record(Conversation.Record .RECORD_FROM_ANSWER).trim(Conversation.Trim.TRIM_SILENCE).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'record' => 'record-from-answer', 'trim' => 'trim-silence']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer', trim: 'trim-silence') end puts response ``` ```xml ``` [back to attributes list](#conversation-attributes) ### recordingStatusCallback The `recordingStatusCallback` attribute takes an absolute URL value. This is where Twilio will send a `GET` or `POST` request when a Recording is available to access. Use \\ with record and recordingStatusCallback attributes ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer', recordingStatusCallback: 'https://example.com/yourRecordingStatusCallback' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record='record-from-answer', recording_status_callback='https://example.com/yourRecordingStatusCallback' ) response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(record: Conversation.RecordEnum.RecordFromAnswer, recordingStatusCallback: new Uri("https://example.com/yourRecordingStatusCallback"), serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").record(Conversation.Record.RECORD_FROM_ANSWER).recordingStatusCallback("https://example.com/yourRecordingStatusCallback").build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'record' => 'record-from-answer', 'recordingStatusCallback' => 'https://example.com/yourRecordingStatusCallback']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer', recording_status_callback: 'https://example.com/yourRecordingStatusCallback') end puts response ``` ```xml ``` #### Request to recordingStatusCallback Twilio will send the following properties in the body of the request to the `recordingStatusCallback` URL: | Property | Description | | ------------------- | ------------------------------------------------------------------------------------------ | | `AccountSid` | The unique identifier for the Twilio account associated with this Recording | | `CallSid` | The unique identifier for the Call associated with this Recording | | `RecordingSid` | The unique identifier for the Recording | | `RecordingUrl` | The URL of the Recording. | | `RecordingStatus` | The status of the Recording. Possible values are `completed` and `failed`. | | `RecordingDuration` | The length of the Recording in seconds. | | `RecordingChannels` | The number of channels in the final Recording audio file. Possible values are `1` and `2`. | | `RecordingSource` | The initiation method used to create the Recording. | Learn more about Recordings on the [Recording Resource page](/docs/voice/api/recording). [back to attributes list](#conversation-attributes) ### recordingStatusCallbackMethod The `recordingStatusCallbackMethod` indicates which HTTP method Twilio will use when sending a request to the `recordingStatusCallback` URL. Allowed values are `GET` and `POST`. The default method is `POST`. Use \\ with record, recordingStatusCallback, and recordingStatusCallbackMethod attributes ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer', recordingStatusCallback: 'https://example.com/yourRecordingStatusCallback', recordingStatusCallbackMethod: 'GET' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record='record-from-answer', recording_status_callback='https://example.com/yourRecordingStatusCallback', recording_status_callback_method='GET') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", record: Conversation.RecordEnum.RecordFromAnswer, recordingStatusCallback: new Uri("https://example.com/yourRecordingStatusCallback"), recordingStatusCallbackMethod: Twilio.Http.HttpMethod.Get); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.http.HttpMethod; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").record(Conversation.Record.RECORD_FROM_ANSWER).recordingStatusCallback("https://example.com/yourRecordingStatusCallback").recordingStatusCallbackMethod(HttpMethod.GET).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'record' => 'record-from-answer', 'recordingStatusCallback' => 'https://example.com/yourRecordingStatusCallback', 'recordingStatusCallbackMethod' => 'GET']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer', recording_status_callback: 'https://example.com/yourRecordingStatusCallback', recording_status_callback_method: 'GET') end puts response ``` ```xml ``` [back to attributes list](#conversation-attributes) ### recordingStatusCallbackEvent The `recordingStatusCallbackEvent` attribute allows you to specify which Recording statuses should trigger a request to the `recordingStatusCallback` URL. The default value is `completed`. The allowed values are as follows: * `in-progress`: the Recording has started, but is not yet available to access * `completed`: the Recording is complete and available for you to access * `absent`: the Recording is absent and inaccessible To specify more than one value, separate each with a space. Use \\ with record, recordingStatusCallback, and recordingStatusCallbackEvent attributes ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer', recordingStatusCallback: 'https://example.com/yourRecordingStatusCallback', recordingStatusCallbackEvent: 'in-progress completed' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record='record-from-answer', recording_status_callback='https://example.com/yourRecordingStatusCallback', recording_status_callback_event='in-progress completed') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; using System.Collections.Generic; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", record:Conversation.RecordEnum.RecordFromAnswer, recordingStatusCallback: new Uri("https://example.com/yourRecordingStatusCallback"), recordingStatusCallbackEvent: new List{Conversation.RecordingEventEnum.InProgress, Conversation.RecordingEventEnum.Completed}); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; import java.util.Arrays; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").record(Conversation.Record.RECORD_FROM_ANSWER).recordingStatusCallback("https://example.com/yourRecordingStatusCallback").recordingStatusCallbackEvents( Arrays.asList(Conversation.RecordingEvent.IN_PROGRESS, Conversation.RecordingEvent.COMPLETED)).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'record' => 'record-from-answer', 'recordingStatusCallback' => 'https://example.com/yourRecordingStatusCallback', 'recordingStatusCallbackEvent' => 'in-progress completed']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', record: 'record-from-answer', recording_status_callback: 'https://example.com/yourRecordingStatusCallback', recording_status_callback_event: 'in-progress completed') end puts response ``` ```xml ``` [back to attributes list](#conversation-attributes) ### statusCallback The `statusCallback` attribute takes a value of a relative or absolute URL. This URL is where Twilio will send HTTP requests upon the occurrence of an event specified in the `statusCallbackEvent` attribute. These HTTP requests provide you with information about the current state of the call between the Frontline worker and customer that was created by the \\ session. Use \\ with statusCallback attribute ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', statusCallback: 'https://example.com/yourStatusCallback' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', status_callback='https://example.com/yourStatusCallback') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", statusCallback: new Uri("https://example.com/yourStatusCallback")); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").statusCallback("https://example.com/yourStatusCallback").build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'statusCallback' => 'https://example.com/yourStatusCallback']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', status_callback: 'https://example.com/yourStatusCallback') end puts response ``` ```xml ``` #### Request to the statusCallback URL The body of the request from Twilio to your `statusCallback` URL contains the following properties: | Property | Description | | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `AccountSid` | The unique identifier for the Twilio account associated with this \\ session. | | `ConversationSid` | The unique identifier for the Conversation associated with this \\ session. | | `DialCallSid` | The unique identifier for the Call leg that connects the Frontline worker and customer. | | `WorkerInitiated` | Indicates whether the \\ was initiated by a Frontline worker or not. | | `Status` | The status of the \\ session. | | `SequenceNumber` | The SequenceNumber is an integer that indicates the order in which `statusCallbackEvents` happen within the \\ session. Each session's first `statusCallbackEvent` will receive a SequenceNumber of 1. The next `statusCallbackEvent` will receive a SequenceNumber of 2, etc. Although requests to the `statusCallback` URL are sent in order, they are separate HTTP requests, so there is no guarantee they will arrive in the same order. The SequenceNumber allows you to see the order of the statusCallback events as they occurred within the \\ session. | | `Timestamp` | The timestamp for the moment the request to the `statusCallback` URL was created. The Timestamp is UTC in [RFC 2822](https://php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format (e.g. `Sat, 7 May 2022 00:58:19 +0000`). | | `CallbackSource` | Indicates the source of the request to the `statusCallback` URL. The value will always be `voice-conversation-service`. | [back to attributes list](#conversation-attributes) ### statusCallbackMethod The `statusCallbackMethod` indicates which HTTP method Twilio will use when sending a request to the `statusCallback` URL. Allowed values are `GET` and `POST`. The default method is `POST`. Use \\ with statusCallback and statusCallbackMethod attributes ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', statusCallback: 'https://example.com/yourStatusCallback', statusCallbackMethod: 'GET' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', status_callback='https://example.com/yourStatusCallback', status_callback_method='GET') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", statusCallback: new Uri("https://example.com/yourStatusCallback"), statusCallbackMethod: Twilio.Http.HttpMethod.Get); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; import com.twilio.http.HttpMethod; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").statusCallback("https://example.com/yourStatusCallback").statusCallbackMethod(HttpMethod.GET).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'statusCallback' => 'https://example.com/yourStatusCallback', 'statusCallbackMethod' => 'GET']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', status_callback: 'https://example.com/yourStatusCallback', status_callback_method: 'GET') end puts response ``` ```xml ``` [back to attributes list](#conversation-attributes) ### statusCallbackEvent The `statusCallbackEvent` attribute indicates which call statuses should trigger a request to the `statusCallback` URL. These events are associated with the call leg that connects the Frontline worker Participant and the customer Participant. The default value is `call-completed`. The possible values are as follows: * `call-initiated`: the call to the other Participant has started * `call-ringing`: the call to the other Participant has started ringing * `call-answered`: the call to the other Participant has been answered * `call-completed`: the call to the other Participant has been completed. **Note:** **This event does not indicate whether the call was successful (answered, busy, no answer, etc.).** For accurate information on the result of the call, check the request to [\'s action URL](#action). To specify more than one value, separate each with a space. Use \\ with statusCallback and statusCallbackEvent attributes ```js const VoiceResponse = require('twilio').twiml.VoiceResponse; const response = new VoiceResponse(); const connect = response.connect(); connect.conversation({ serviceInstanceSid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', statusCallback: 'https://example.com/yourStatusCallback', statusCallbackEvent: 'call-initiated call-ringing call-answered call-completed' }); console.log(response.toString()); ``` ```py from twilio.twiml.voice_response import Connect, Conversation, VoiceResponse response = VoiceResponse() connect = Connect() connect.conversation( service_instance_sid='ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', status_callback='https://example.com/yourStatusCallback', status_callback_event= 'call-initiated call-ringing call-answered call-completed') response.append(connect) print(response) ``` ```cs using System; using Twilio.TwiML; using Twilio.TwiML.Voice; using System.Collections.Generic; class Example { static void Main() { var response = new VoiceResponse(); var connect = new Connect(); connect.Conversation(serviceInstanceSid: "ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", statusCallback: new Uri("https://example.com/yourStatusCallback"), statusCallbackEvent: new List{Conversation.EventEnum.CallInitiated, Conversation.EventEnum.CallAnswered, Conversation.EventEnum.CallRinging, Conversation.EventEnum.CallCompleted}); response.Append(connect); Console.WriteLine(response.ToString()); } } ``` ```java import com.twilio.twiml.voice.Connect; import com.twilio.twiml.voice.Conversation; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; import java.util.Arrays; public class Example { public static void main(String[] args) { Conversation conversation = new Conversation.Builder().serviceInstanceSid("ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").statusCallback("https://example.com/yourStatusCallback").statusCallbackEvents(Arrays.asList(Conversation.Event.CALL_INITIATED, Conversation.Event.CALL_RINGING, Conversation.Event.CALL_ANSWERED, Conversation.Event.CALL_COMPLETED)).build(); Connect connect = new Connect.Builder().conversation(conversation).build(); VoiceResponse response = new VoiceResponse.Builder().connect(connect).build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } } ``` ```php connect(); $connect->conversation(['serviceInstanceSid' => 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'statusCallback' => 'https://example.com/yourStatusCallback', 'statusCallbackEvent' => 'call-initiated call-ringing call-answered call-completed']); echo $response; ``` ```rb require 'twilio-ruby' response = Twilio::TwiML::VoiceResponse.new response.connect do |connect| connect.conversation(service_instance_sid: 'ISxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', status_callback: 'https://example.com/yourStatusCallback', status_callback_event: 'call-initiated call-ringing call-answered call-completed') end puts response ``` ```xml ``` [back to attributes list](#conversation-attributes) ### url The `url` attribute allows you to specify a URL that will return a TwiML response to be run on the called party's end, after they answer, but before the parties are connected. You can use this TwiML to privately `` or `` information to the called party. You could also provide a chance to decline the phone call using `` and ``.