Telepath

Creating a Connection

Link your AI agent and configure SIP authentication

Overview

A Telepath connection links a SIP username to an AI backend. There are three key steps to get up and running: selecting your AI provider, configuring authentication, and activating your bridge. Once active, your connection will accept inbound SIP calls and route audio to your configured AI agent in real time.

Step 1: Link Your AI Agent

Access the Dashboard

Log in to the Telepath Dashboard and navigate to the Agents section in the left-hand navigation. From here you can view all existing connections and create new ones.

Select Your AI Provider

Choose the AI provider that powers your voice agent. Telepath supports three provider types:

Provider: OpenAI Realtime API

Requirements:

  • OpenAI API key with gpt-4o-realtime-preview access
  • Optional: a system prompt to define your agent's behavior

Setup:

  1. Select OpenAI Realtime API from the provider dropdown

  2. Paste your OpenAI API key into the API Key field

  3. Optionally enter a system prompt to shape the agent's personality and behavior

  4. Click Save to store the provider configuration

Provider: ElevenLabs Conversational AI

Requirements:

  • ElevenLabs API key
  • Agent ID from your ElevenLabs dashboard
  • Optional: Voice ID to specify a particular voice

Setup:

  1. Select ElevenLabs Conversational AI from the provider dropdown

  2. Paste your ElevenLabs API key and Agent ID

  3. Optionally specify a Voice ID if you want a specific voice

  4. Click Save to store the provider configuration

Provider: Your own WebSocket endpoint

Requirements:

  • A publicly accessible wss:// URL
  • Optional: custom authentication headers

Setup:

  1. Select Custom WebSocket from the provider dropdown

  2. Enter your public wss:// endpoint URL

  3. Optionally add authentication headers (e.g., Authorization: Bearer <token>)

  4. Click Save to store the provider configuration

Step 2: Configure SIP Authentication

Info: Your SIP Username is a unique identifier for this connection on the Telepath network. Your SIP Password must be secure — a minimum of 12 characters is recommended, using a mix of upper/lowercase letters, numbers, and symbols.

  1. Enter a SIP Username

    Choose a unique username that identifies this connection (e.g., sales-bot-prod). It must be alphanumeric and may include hyphens.

  2. Create a Strong Password

    Enter a secure SIP password. Avoid simple or reused passwords. This credential will be used by your telephony carrier to authenticate with Telepath.

  3. Optionally Generate Credentials

    Click Generate Credentials to have Telepath auto-create a cryptographically secure username/password pair for you.

  4. Save Your Credentials Securely

    Copy the SIP username and password and store them in a secure location (e.g., a secrets manager). You will not be able to view the password again after leaving this screen.

Step 3: Point Your SIP Trunk

Origination URI Format

Configure your carrier's SIP trunk to send calls to the following origination URI, replacing {your-sip-username} with the username you created:

text
sip:{your-sip-username}@sip.telepathvoice.com

Authentication

When configuring your carrier's trunk, provide the following details:

  • Username: Your Telepath SIP username
  • Password: Your Telepath SIP password
  • Protocol: UDP or TLS (TLS recommended for production)
  • Codecs: G.711 (PCMU/PCMA) or G.722 (recommended for HD audio)

Step 4: Activate Your Connection

  1. Review your configuration

    Confirm the AI provider, SIP credentials, and trunk settings are all correctly entered.

  2. Click Activate Connection

    In the dashboard, click the Activate button on your connection card.

  3. Verify the status indicator turns green

    A green "Active" badge confirms your connection is ready to receive calls.

  4. Place a test call

    Dial the phone number associated with your configured trunk to confirm audio flows end-to-end through to your AI agent.

Tip: Once activated, your connection will automatically accept inbound calls. There is no need to restart or re-configure after initial activation unless you change credentials or provider settings.

Managing Your Connection

View Connection Details

From the dashboard Connections page you can view:

  • Current status (Active / Inactive / Error)
  • SIP username and masked password
  • Configured AI provider and model
  • Total calls handled and last-call timestamp
  • Average latency metrics

Update Credentials

To rotate your SIP password:

  1. Click Edit on the connection card
  2. Click Rotate Password
  3. Copy the newly generated password
  4. Update your carrier's trunk configuration with the new password

Warning: After rotating your SIP password you must update your carrier's trunk configuration immediately. Calls will fail to authenticate until the carrier is updated with the new credentials.

Delete a Connection

  1. Navigate to the Connections page in the dashboard
  2. Click the three-dot menu (…) on the connection card
  3. Select Delete Connection
  4. Confirm the deletion in the dialog box — this action is irreversible

API Integration

You can also create and manage connections programmatically using the Telepath REST API.

POST Create Trunk

Create a new SIP trunk connection via the API, including provider settings and SIP credentials.

Troubleshooting

Connection Won't Activate

  • Ensure your AI provider API key is valid and has not expired
  • Verify that the selected model (e.g., gpt-4o-realtime-preview) is available on your API key's plan
  • Check that your SIP username is unique and does not contain invalid characters

Calls Not Routing

  • Confirm the origination URI in your carrier matches the format sip:{username}@sip.telepathvoice.com exactly
  • Verify the SIP username and password at the carrier match what is stored in Telepath
  • Check that your carrier trunk is set to Active/Enabled in your carrier's dashboard

For more detailed troubleshooting steps, see the Troubleshooting guide.