Skip to main content

​
Overview

A Telepath connection links a SIP username to an AI backend. Creating a connection involves three key steps: selecting your AI provider, configuring authentication, and activating your bridge. The first phase involves authentication and credential management.

​
Access the Dashboard

Log in to Telepath Dashboard and navigate to the Agents section.

​
Select Your AI Provider

Choose from three options:
Provider: OpenAI Realtime APIRequirements:
  • OpenAI API key with access to gpt-4o-realtime-preview
  • Model: gpt-4o-realtime-preview
  • Optional: Custom system prompt
Setup:
  1. Get your API key from platform.openai.com
  2. In Telepath, select “OpenAI”
  3. Paste your API key
  4. Optionally configure a system prompt

​
Step 2: Configure SIP Authentication

Set up your SIP credentials that will be used to authenticate calls.
SIP Username: A unique identifier for this connection (e.g., agent-support-01)SIP Password: A secure password for authentication (minimum 12 characters recommended)
  1. Enter a unique SIP username (alphanumeric and hyphens only)
  2. Create a strong SIP password
  3. Click Generate Credentials if you want system-generated values
  4. Save your SIP username and password securely—you’ll need these for carrier configuration

​
Step 3: Point Your SIP Trunk

Once your agent is connected, configure your telephony carrier to route calls to Telepath.

​
Origination URI Format

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

​
Authentication

Use these credentials when prompted by your carrier:
  • Username: Your SIP username
  • Password: Your SIP password
  • Protocol: UDP or TLS (both supported)
  • Codecs: G.711 (PCMU/PCMA) or G.722 (recommended for HD audio)

​
Step 4: Activate Your Connection

  1. Return to Telepath dashboard
  2. Verify all credentials are entered correctly
  3. Click Activate Connection
  4. Your connection status should show as Active
Once activated, your connection will automatically accept inbound calls from your configured carriers. No additional deployment steps required.

​
Managing Your Connection

​
View Connection Details

In the dashboard, you can:
  • View your SIP username and regenerate your password
  • See connection status and uptime
  • View recent calls routed through this connection
  • Update your AI agent configuration

​
Update Credentials

To rotate your SIP password:
  1. Go to your connection settings
  2. Click Rotate SIP Password
  3. Update your carrier configuration with the new password
  4. Confirm the change in Telepath
Rotating your password will immediately invalidate the old password. Ensure your carrier is updated before rotating to avoid dropped calls.

​
Delete a Connection

To remove a connection:
  1. Go to connection settings
  2. Click Delete Connection
  3. Confirm the deletion
  4. Update your carrier to stop routing calls to this endpoint

​
API Integration

You can also manage connections programmatically using the Telepath API.

API Reference

Create, update, and manage connections via REST API

​
Troubleshooting

Connection won’t activate:
  • Verify your AI provider credentials are correct
  • Check that your SIP username is unique
  • Ensure password meets minimum requirements
Calls not routing:
  • Confirm your carrier configuration has the correct origination URI
  • Verify SIP username and password match your connection
  • Check carrier logs for any SIP errors
See Troubleshooting for more help.