Skip to main content

Phone Numbers

Phone numbers are the entry point for calls into VOCALS. Each number is connected via a SIP provider and assigned to an agent that handles all calls to that number.

Setting Up a SIP Provider​

Before assigning phone numbers, you need to configure at least one SIP provider. VOCALS supports Twilio, Netelip, and any generic SIP trunk provider.

See the SIP Providers guide for detailed setup instructions for each provider type.

How Calls Are Routed​

Caller dials number
    |
SIP provider receives call (PSTN)
    |
SIP provider routes to VOCALS via SIP trunk
    |
VOCALS orchestrator receives the call
    |
VOCALS opens a WebSocket Media Stream
    |
Real-time audio streaming begins (mulaw/8kHz)

Assigning Numbers to Agents​

Each phone number maps to exactly one agent. When a call arrives on that number, VOCALS loads the assigned agent's configuration (system prompt, providers, settings) and starts the voice pipeline.

To Change the Agent Assignment​

  1. Go to Phone Numbers in the dashboard.
  2. Click the number you want to update.
  3. Select a different agent from the dropdown.
  4. Click Save.

The change takes effect on the next incoming call. Active calls are not affected.

Multiple Numbers, One Agent​

You can assign the same agent to multiple phone numbers. This is useful when:

  • You have local numbers in different area codes that all route to the same agent.
  • You want separate numbers for tracking purposes (e.g., one number per marketing campaign) but the same conversational experience.