SIP Configurations: Connect Any Phone System to MediaSFU

2026-03-11 · Tutorial

SIP Configurations: Connect Any Phone System to MediaSFU

Bring your own SIP trunk, configure AI auto-attendants, set up IVR flows, and secure your telephony with IP/geo restrictions — all from the dashboard.

What Is a SIP Configuration?

A SIP Configuration connects your phone numbers (DID numbers) to the MediaSFU platform. Once connected, that phone number can:

• Receive inbound calls and route them through MediaSFU's media pipeline
• Make outbound calls via your SIP trunk or MediaSFU's system numbers
• Auto-answer with an AI agent, IVR menu, or audio playback
• Join callers into MediaSFU meeting rooms automatically
• Record calls, apply geo/IP restrictions, and trigger webhooks on events

Think of each SIP config as a "profile" for a phone number — it defines how that number behaves when someone calls it or when you call out from it.

Two Paths: System SIP vs. Bring Your Own Trunk

🔵 System SIP Easy

No SIP trunk needed. MediaSFU provides shared phone numbers from a pool. You select a number, and the system handles registration, routing, and failover.

• Available on Standard & Advanced plans
• No provider account required
• MediaSFU manages everything
• Per-minute usage on your balance
• Great for click-to-call and campaigns

🟣 Bring Your Own Trunk Advanced

Connect your existing SIP provider. Enter your trunk credentials and MediaSFU registers to your provider. Full control over your numbers, routing, and pricing.

• Any plan
• Your own phone numbers
• Your provider's rates for PSTN
• Primary + backup trunks
• Custom SIP domains & ports

Supported Providers

The SIP Config wizard has built-in presets for popular providers. Select your provider and the wizard pre-fills the SIP host, port, and transport settings:

The Setup Wizard: 7 Steps

Creating a SIP config is guided by a step-by-step wizard in the Developer Dashboard:

Step 1: Basics

Select your provider, enter your DID phone number (E.164 format, e.g. +14155551234), and choose the call direction: inbound, outbound, or both.

Step 2: Peer Configuration

For BYOT users: enter the SIP host (e.g. sip.telnyx.com), port (default 5060), transport (UDP, TCP, or TLS), and authentication credentials. Optionally configure a backup peer for failover.

Step 3: Features

Toggle the settings that control call behavior:

Step 4: AI Auto-Agent

This is where it gets powerful. You can configure an AI agent to automatically handle calls on this number:

🤖 AI Mode

Full conversational AI. Configure:

• System prompt — personality, role, instructions
• First message — what the AI says when it answers
• Personality traits — friendly, professional, etc.
• Temperature — creativity (0.0 – 1.0)
• Speak first — AI initiates or waits for caller
• Fallback behavior — what to do when uncertain
• Agent-only mode — AI handles everything, no human escalation
• Human escalation webhook — notify when AI transfers to human

📞 IVR / Playback Mode

Traditional phone tree or audio playback:

• Welcome audio — greeting when call connects
• Wait music — hold music while routing
• Passcode entry — gate calls with a pin
• Goodbye audio — farewell on hang-up
• Error audio — invalid input message
• Callback offer — "Press 1 to receive a callback"
• 14 configurable audio slots total
• Each slot accepts a URL or TTS text with {template_variables}

Step 5: AI Credentials

If using AI mode, specify which LLM, STT, and TTS providers to use. Bring Your Own Keys — enter API key nicknames for OpenAI, Anthropic, Google, DeepSeek, ElevenLabs, Deepgram, and more. Credentials are stored securely and referenced by nickname.

Step 6: Integrations (MCP)

Connect external tools that your AI agent can use during calls:

Step 7: Review & Confirm

Review all settings and create the config. The system sends a verification code via SMS or call to the DID number. Enter the code to verify ownership, and the config goes live.

Security: IP & Geo Restrictions

Every SIP config supports layered security:

Callback System

When all agents are busy or unavailable, the callback system offers callers an alternative to waiting on hold:

Number Verification Flow

Every SIP config goes through number verification to confirm you own the phone number:

Verification prevents unauthorized use of phone numbers. You can resend the code if it doesn't arrive, and the system tracks attempt counts for abuse prevention.

SIP Registration Management

For BYOT configurations, the dashboard provides trunk registration controls:

Each action targets either the primary peer or backup peer independently. Registration status (registered, unregistered, failed, pending) is displayed in real time on the config card.

Click-to-Call: The Zero-Trunk Option

Not everyone needs a SIP trunk. The Click-to-Call provider type lets you connect your personal or business phone number without any SIP infrastructure:

The wizard auto-configures everything: peer host is set to click-to-call.mediasfu.com, direction is forced to inbound, and no SIP credentials are needed. Just enter your phone number and verify it.

This is the fastest path to "website visitor can call your team" — no Twilio account, no SIP trunk, no phone system changes. It works with any phone number worldwide.

Where SIP Configs Are Used

Once configured, SIP configs power multiple features across the platform:

Quick Reference: All Configurable Fields

Set Up Your First SIP Config

Connect your phone number in minutes. Click-to-Call needs zero SIP knowledge — just enter your number.