SignalWire Integration

Connect your agents to phone numbers through SignalWire. This chapter covers account setup, phone number configuration, and testing your voice agents.

What You’ll Learn

This chapter covers SignalWire integration:

1. Account Setup - Create and configure your SignalWire account
2. Phone Numbers - Purchase and manage phone numbers
3. Mapping Numbers - Connect phone numbers to your agents
4. Testing - Test your agents before going live
5. Troubleshooting - Common issues and solutions

Integration Overview

Prerequisites

Before connecting to SignalWire:

• Working agent (tested locally)
• Publicly accessible server
• SignalWire account

Chapter Contents

Quick Integration Steps

Step 1: Account Setup

• Create SignalWire account
• Create a project
• Note your Space Name

Step 2: Phone Number

• Purchase a phone number
• Or use a SIP endpoint

Step 3: Deploy Agent

• Deploy agent to public URL
• Verify HTTPS is working
• Test SWML endpoint responds

Step 4: Connect

• Point phone number to agent URL
• Make test call
• Verify agent responds

Architecture

Required URLs

Your agent needs to be accessible at these endpoints:

Security Considerations

• Always use HTTPS for production
• Enable basic auth for SWML endpoints
• Use secure tokens for SWAIG functions
• Don’t expose sensitive data in prompts
• Monitor for unusual call patterns

Let’s start with setting up your SignalWire account.

Create Account

1. Go to signalwire.com
2. Click Sign Up or Login
3. Complete registration with email and password
4. Verify your email address

Note: If you have problems verifying your account, email support@signalwire.com

Create a Project

After logging in:

1. Navigate to Projects in the dashboard
2. Click “Create New Project”
3. Enter a project name (e.g., “Voice Agents”)
4. Select your use case

Space Name

Your Space Name is your unique SignalWire identifier.

URL Format: https://YOUR-SPACE-NAME.signalwire.com

Example: https://mycompany.signalwire.com

You’ll need this for:

• API authentication
• Dashboard access
• SWML webhook configuration

API Credentials

Get your API credentials from the project:

1. Go to API Credentials
2. Note your Project ID
3. Create an API Token if needed

Keep these secure - don’t commit to version control!

Environment Variables

Set these for your agent:

$
export SIGNALWIRE_PROJECT_ID="your-project-id"
$
export SIGNALWIRE_API_TOKEN="your-api-token"
$
export SIGNALWIRE_SPACE_NAME="your-Space"

Dashboard Overview

Add Credit

Before making calls:

1. Go to Billing
2. Add payment method
3. Add credit to your account

Trial accounts may have limited credit for testing.

Account Verification

Some features require account verification:

• Phone number purchases
• Outbound calling
• Certain number types

Complete verification in Account Settings if prompted.

Next Steps

With your account ready:

1. Purchase a phone number
2. Deploy your agent
3. Connect the number to your agent