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

# 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

<Steps>
  <Step title="Generate a SIP address in Agent Studio">
    1. Go to your agent page and click **Configure > 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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="SMS messaging" icon="message" href="/sms/introduction">
    Set up SMS messaging with your Twilio account
  </Card>

  <Card title="Handoff integration" icon="phone-volume" href="/telephony/twilio/how-to-handoff">
    Configure call transfers to live agents
  </Card>

  <Card title="Twilio Flex integration" icon="diagram-project" href="/integrations/voice/twilio">
    Advanced contact center routing setup
  </Card>

  <Card title="Telephony overview" icon="phone" href="/telephony/introduction">
    Explore other phone number integration options
  </Card>
</CardGroup>