> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://poly-ai.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://poly-ai.ferndocs.com/_mcp/server.

# Phone number integration

> Integrate a Twilio phone number with PolyAI Agent Studio

Connect a phone number hosted in your [Twilio](https://www.twilio.com/) account to your PolyAI agent. This routes incoming calls from your Twilio number to your agent using [SIP](https://en.wikipedia.org/wiki/Session_Initiation_Protocol) (Session Initiation Protocol).

## Prerequisites

* A Twilio account with at least one phone number
* A PolyAI agent project

## Integration steps

#### Generate a SIP address in Agent Studio

1. Go to your agent page and click **Voice > Numbers** in the sidebar.
2. Scroll to **Connect Twilio Phone Number**.
3. Click **Generate SIP** to create a SIP address for your agent.
4. Copy the generated SIP address – you will need it in the next step.

#### Configure the number in Twilio

1. Log in to your [Twilio console](https://console.twilio.com/).
2. Navigate to **Phone Numbers > Manage > Active Numbers**.
3. Select the phone number you want to connect.
4. Under **Voice configuration**, set the incoming call routing to use the SIP address you generated in Agent Studio.
5. Save your changes.

#### Test the connection

Call your Twilio number and confirm the call reaches your PolyAI agent. Review the conversation in **Analytics > Conversations > Voice** to verify the call was handled correctly.

## Next steps

#### [SMS messaging](/agent-studio/voice/message-templates)

Set up SMS messaging with your Twilio account

#### [Handoff integration](/agent-studio/voice/numbers/twilio/handoff-integration)

Configure call transfers to live agents

#### [Twilio Flex integration](/integrations/telephony/twilio)

Advanced contact center routing setup

#### [Telephony overview](/agent-studio/voice/numbers/overview)

Explore other phone number integration options