> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insighto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Twilio Set Up For Voice ai

Connect your Insighto voice assistant to a Twilio phone number and let users interact via real phone calls.\
This guide will walk you through setting up Twilio, integrating it with Insighto, and deploying your assistant.

> ☁ Ideal for users who want to enable call-based interactions using Twilio.

***

## 📞 Twilio Setup Process

1. Sign Up on Twilio

If you're new to Twilio, click **Sign Up** on the login page to create a new account.

> 🔄 Already have an account? Skip to Step 3.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/1.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=8500e50166b2801a8b2ce990c5290744" alt="alt" width="762" height="454" data-path="images/Twilio/1.png" />

***

2. Complete the Sign-Up Process

Fill in your details on the sign-up page and click **Continue** to finish creating your account.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/2.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=c450aeab2796a402872ef4831b1e1b41" alt="alt" width="829" height="490" data-path="images/Twilio/2.png" />

***

3. Log In to Your Twilio Account

Enter your credentials, and access your dashboard.

✅ Once logged in, you'll land on the Twilio Console homepage.

> ⚠ **Important: Upgrade Your Twilio Account**\
> New Twilio accounts start on a free trial, which may prevent your voice assistant from working properly after deployment.\
> To avoid issues, it's recommended to verify and upgrade your account before proceeding.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/3.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=c19307a923c99d8e549580df46d21d54" alt="alt" width="796" height="513" data-path="images/Twilio/3.png" />

***

4. Copy Account SID and Auth Token

On the Twilio Console homepage, locate your **Account SID** and **Auth Token**.\
Copy and keep them handy — you'll need these to integrate Twilio with Insighto.

> 🔒 Treat these as sensitive credentials. Don't share them publicly.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/4.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=475672f496361acf9cd7788792a4277c" alt="alt" width="793" height="499" data-path="images/Twilio/4.png" />

***

5. Buy a Twilio Phone Number

Go to the **Phone Numbers** section in your Twilio Console and click **Buy a Number**.\
Use filters to select your country and ensure the number has **Voice** capability.

> 🔁 Already have a number? Refer to this guide to **Port your existing number on Twilio**.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/5.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=6b0b648c81b3f6d3114e80d5cfd6389f" alt="alt" width="792" height="487" data-path="images/Twilio/5.png" />

***

✅ **Twilio Setup Complete — Final Checks Before Integration**

***

## Twilio integration with Insighto.ai

6. Click on Tools & Integrations

Click on **Tools & Integrations**

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/6.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=c18178ecfc38039a3bd0799a17823d13" alt="alt" width="817" height="480" data-path="images/Twilio/6.png" />

***

7. Click on Twilio Set up

Click on **Twilio Set up**

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/7.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=a490d77d447065dddff0724d5cec03a6" alt="alt" width="820" height="490" data-path="images/Twilio/7.png" />

***

8. Click on Create New

Click on **Create New**

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/8.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=3ee3213970afec1b7dd181ca3912c15e" alt="alt" width="790" height="472" data-path="images/Twilio/8.png" />

***

9. Click on Submit

* Provide a Name
* Input your **Account SID** and **Auth Token**
* Click on **Submit**

***

🔗 **Twilio Integration Complete**\
Your Twilio account is now successfully connected to Insighto.\
Let's move on to the final step — deploying your voice assistant on the Twilio number.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/6.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=c18178ecfc38039a3bd0799a17823d13" alt="alt" width="817" height="480" data-path="images/Twilio/6.png" />

***

## Twilio Widget Set Up Process

10. Click on Widgets

Click on **Widgets**

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/10.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=2560847a5c7aaa9d94e1d4f27498a9db" alt="alt" width="798" height="490" data-path="images/Twilio/10.png" />

***

11. Click on Create Widget

Click on **Create Widget**

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/11.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=0424f40426f0b6762d10c6f162af9b47" alt="alt" width="802" height="489" data-path="images/Twilio/11.png" />

***

12. Select Provider Type

Select **Provider Type**

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/12.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=de09c94fb09a53b043e577aadfb31ca8" alt="alt" width="814" height="492" data-path="images/Twilio/12.png" />

***

13. Select Widget Type

* Select the **Widget Type** as shown below
* Provide **Name** & **Description** of the Widget
* Click on **Next**

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/13.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=721536d6fd3a079b603478b951ff50df" alt="alt" width="801" height="508" data-path="images/Twilio/13.png" />

***

14. Select the Assistant

Select the **Assistant** from the dropdown and proceed

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/14.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=65a09eef3adb1999034eff58d7899fd5" alt="alt" width="810" height="495" data-path="images/Twilio/14.png" />

***

15. Configure Twilio Widget

In this step, set the behavior for your Twilio-powered voice assistant:

* Enable Call Recording (optional) – Recordings will be available in your Twilio dashboard
* Set Maximum Call Duration in seconds (e.g., 300 for 5 minutes)
* Select Your **Twilio Account** from the dropdown
* Choose a **Phone Number** associated with that account

Once done, click **Finish** to complete deployment.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/Twilio/15.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=73d22efd017a2a38f7ede076622d746b" alt="alt" width="1541" height="919" data-path="images/Twilio/15.png" />

***

16. Test Your Voice Assistant

Call the Twilio number you just configured to test your AI voice assistant in action.\
Make sure the conversation flows as expected based on your prompt and voice settings.

***

# 🛠️ Troubleshooting Tips

If your voice assistant isn’t working as expected, refer to the following checks:

| Issue                       | What to Do                                                                                                      |
| --------------------------- | --------------------------------------------------------------------------------------------------------------- |
| System Logs                 | Go to the bottom-left of your Insighto dashboard → click your name → select System Logs to view error messages. |
| Twilio Account Not Upgraded | Ensure your Twilio account is upgraded; trial accounts may block live calls.                                    |
| Voice Routing Region        | Confirm that your Twilio number's Voice routing is set to US1.                                                  |
| Invalid Auth Token or SID   | Double-check that your Twilio Auth Token and SID entered in Insighto are correct.                               |
| Call Diagnostics            | Check call recordings and call status inside your Twilio console.                                               |
