Menu

Expand
Rate this page:

Assistant

An Assistant is a conversational application or bot that you can deploy across different channels with Twilio's Autopilot.

Each Assistant is independent of other Assistants – you can create multiple Assistants that serve different purposes. For example, you may wish to create an Assistant for a lead-qualification-bot and a different one for support-bot.

All Autopilot REST API resources use the following base URL:

https://autopilot.twilio.com/v1/

Assistant properties

Resource Properties in REST API format
account_sid
sid<AC> Not PII

The SID of the Account that created the Assistant resource.

date_created
date_time<iso8601> Not PII

The date and time in GMT when the resource was created specified in RFC 2822 format.

date_updated
date_time<iso8601> Not PII

The date and time in GMT when the resource was last updated specified in RFC 2822 format.

friendly_name
string Not PII

The string that you assigned to describe the resource. It is not unique and can be up to 255 characters long.

latest_model_build_sid
sid<UG> Not PII

Reserved.

links
uri_map Not PII

A list of the URLs of the Assistant's related resources.

log_queries
boolean Not PII

Whether queries should be logged and kept after training. Can be: true or false and defaults to true. If true, queries are stored for 30 days, and then deleted. If false, no queries are stored.

development_stage
string Not PII

A string describing the state of the assistant.

needs_model_build
boolean Not PII

Whether model needs to be rebuilt.

sid
sid<UA> Not PII

The unique string that we created to identify the Assistant resource.

unique_name
string Not PII

An application-defined string that uniquely identifies the resource. It can be used in place of the resource's sid in the URL to address the resource. It can be up to 64 characters long.

url
url Not PII

The absolute URL of the Assistant resource.

callback_url
url Not PII

Reserved.

callback_events
string Not PII

Reserved.

Create an Assistant resource

post
https://autopilot.twilio.com/v1/Assistants

Creates a new Assistant resource.

Parameters
Parameters in REST API format
friendly_name
Optional
post string Not PII

A descriptive string that you create to describe the new resource. It is not unique and can be up to 255 characters long.

log_queries
Optional
post boolean Not PII

Whether queries should be logged and kept after training. Can be: true or false and defaults to true. If true, queries are stored for 30 days, and then deleted. If false, no queries are stored.

unique_name
Optional
post string Not PII

An application-defined string that uniquely identifies the new resource. It can be used as an alternative to the sid in the URL path to address the resource. The first 64 characters must be unique.

callback_url
Optional
post url Not PII

Reserved.

callback_events
Optional
post string Not PII

Reserved.

style_sheet
Optional
post object Not PII

The JSON string that defines the Assistant's style sheet

defaults
Optional
post object Not PII

A JSON object that defines the Assistant's default tasks for various scenarios, including initiation actions and fallback tasks.

Example 1
        
        
        

        Create an Assistant

        Example 2
              
              
              

              Create a named assistant

              Example 3
                    
                    
                    

                    Create a named assistant with a stylesheet

                    Fetch an Assistant resource

                    get
                    https://autopilot.twilio.com/v1/Assistants/{Sid}

                    Returns the Assistant instance identified by {AssistantSid} or {AssistantUniqueName}.

                    Parameters
                    Parameters in REST API format
                    sid
                    Path
                    get sid_like<UA> Not PII

                    The Twilio-provided string that uniquely identifies the Assistant resource to fetch.

                    Example 1
                          
                          
                          

                          Fetch an Assistant

                          Read multiple Assistant resources

                          get
                          https://autopilot.twilio.com/v1/Assistants

                          Returns a list of Assistants within an Account. The list includes paging information.

                          Example 1
                                
                                
                                

                                Read: List all Assistants

                                Update an Assistant resource

                                post
                                https://autopilot.twilio.com/v1/Assistants/{Sid}

                                Updates the Assistant instance identified by {AssistantSid} or {AssistantUniqueName}.

                                Parameters
                                Parameters in REST API format
                                sid
                                Path
                                post sid_like<UA> Not PII

                                The Twilio-provided string that uniquely identifies the Assistant resource to update.

                                friendly_name
                                Optional
                                post string Not PII

                                A descriptive string that you create to describe the resource. It is not unique and can be up to 255 characters long.

                                log_queries
                                Optional
                                post boolean Not PII

                                Whether queries should be logged and kept after training. Can be: true or false and defaults to true. If true, queries are stored for 30 days, and then deleted. If false, no queries are stored.

                                unique_name
                                Optional
                                post string Not PII

                                An application-defined string that uniquely identifies the resource. It can be used as an alternative to the sid in the URL path to address the resource. The first 64 characters must be unique.

                                callback_url
                                Optional
                                post url Not PII

                                Reserved.

                                callback_events
                                Optional
                                post string Not PII

                                Reserved.

                                style_sheet
                                Optional
                                post object Not PII

                                The JSON string that defines the Assistant's style sheet

                                defaults
                                Optional
                                post object Not PII

                                A JSON object that defines the Assistant's default tasks for various scenarios, including initiation actions and fallback tasks.

                                development_stage
                                Optional
                                post string Not PII

                                A string describing the state of the assistant.

                                Example 1
                                      
                                      
                                      

                                      Update an Assistant

                                      Example 2
                                            
                                            
                                            

                                            Update an assistant with a stylesheet

                                            Delete an Assistant resource

                                            delete
                                            https://autopilot.twilio.com/v1/Assistants/{Sid}

                                            Deletes an Assistant.

                                            Deleting an Assistant is potentially a very destructive action. Before it can be deleted, an Assistant cannot have any Intents, Fields, Samples, Field Types, Queries, or Model Builds associated with it. You must delete those first, then delete the Assistant.

                                            Parameters
                                            Parameters in REST API format
                                            sid
                                            Path
                                            delete sid_like<UA> Not PII

                                            The Twilio-provided string that uniquely identifies the Assistant resource to delete.

                                            Example 1
                                                  
                                                  
                                                  

                                                  Delete an Assistant

                                                  Rate this page:

                                                  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.

                                                        
                                                        
                                                        

                                                        Thank you for your feedback!

                                                        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                                                        Sending your feedback...
                                                        🎉 Thank you for your feedback!
                                                        Something went wrong. Please try again.

                                                        Thanks for your feedback!

                                                        thanks-feedback-gif