Skip to main content

Twilio Setup Guide

This guide explains how to configure Twilio to work with your Deepdesk voice agent.

Prerequisites​

  • An active Twilio account
  • A Deepdesk voice agent (assistant) configured
  • A Twilio phone number

Configuration Steps​

1. Get Your Webhook URL​

Your Deepdesk voice agent webhook URL follows this format:

https://<account>.deepdesk.com/api/v2/assistants/<assistant>/twilio/v2/incoming-call

Where:

  • <account> is your Deepdesk account subdomain
  • <assistant> is your assistant's code/identifier

2. Configure Your Twilio Phone Number​

  1. Log in to your Twilio Console
  2. Navigate to Phone Numbers > Manage > Active Numbers
  3. Select the phone number you want to use for your voice agent
  4. Scroll down to the Voice & Fax section
  5. Under A Call Comes In, configure:
    • Set to Webhook
    • Enter your Deepdesk webhook URL
    • Set HTTP method to POST
  6. Click Save to apply the changes

3. Test Your Configuration​

  1. Call your Twilio phone number
  2. Your Deepdesk voice agent should answer the call
  3. Verify that the voice agent responds correctly to your queries

Troubleshooting​

Call Not Connecting​

  • Verify that your webhook URL is correct
  • Ensure your Deepdesk assistant is properly configured and active
  • Check Twilio's debugger logs for any error messages

Voice Quality Issues​

  • Check your network connection
  • Review Twilio's voice quality best practices
  • Verify that your assistant's voice settings are configured correctly

Additional Resources​