Defaults
Defaults determine your Assistant's behavior in three different situations:
assistant_initiation
: the assistant is responsible for beginning a conversation, only used for an inbound phone callfallback
: the natural language router cannot map human input to an existing taskcollect
: the assistant needs to know which task to use if there is a failure when collecting data
All defaults should point to one of the following:
- an existing task in the format
"task://hello-world"
- a publically accessible URL that contains the desired set of actions in the format
"https://myapp.com/on_failure"
All Autopilot REST API resources use the following base URL:
https://autopilot.twilio.com/v1/
Example Defaults data
{
"defaults": {
"assistant_initiation": "task://hello_world",
"fallback": "task://hello_world",
"collect": {
"validate_on_failure": "task://hello_world"
}
}
}
Defaults Actions
Resource Properties in REST API format | |
---|---|
account_sid
|
The SID of the Account that created the Defaults resource. |
assistant_sid
|
The SID of the Assistant that is the parent of the resource. |
url
|
The absolute URL of the Defaults resource. |
data
|
The JSON string that describes the default task links for the |
Fetch a Defaults resource
https://autopilot.twilio.com/v1/Assistants/{AssistantSid}/Defaults
Parameters
Parameters in REST API format | |
---|---|
assistant_sid
Path
|
The SID of the Assistant that is the parent of the resource to fetch. |
Example 1
Update a Defaults resource
https://autopilot.twilio.com/v1/Assistants/{AssistantSid}/Defaults
Parameters
Parameters in REST API format | |
---|---|
assistant_sid
Path
|
The SID of the Assistant that is the parent of the resource to update. |
defaults
Optional
|
A JSON string that describes the default task links for the |
Example 1
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.