Skip to main content

​
SIP Integration

​
Overview

Connect your existing phone system and numbers with Famulor. This guide will help you understand and set up the SIP integration. If you need assistance during the setup, our support team is available to help.

​
What is SIP Integration?

SIP (Session Initiation Protocol) integration allows you to connect your existing phone system with Famulor. Think of it as building a bridge between your current phone setup and our AI platform. This means you can:
  • Use your existing phone numbers with our AI assistants
  • Keep your current phone system and provider
  • Make and receive calls through your existing setup
  • Retain full control over your numbers
  • Reduce carrier costs by using local VoIP providers with better rates

​
How It Works

When you integrate your phone system with Famulor: Incoming Calls: Calls to your numbers are routed through your phone system to our AI assistants. Outgoing Calls: Our AI assistants can make calls that appear to come from your numbers. Management: You continue to manage your numbers through your current provider. Cost Efficiency: Benefit from competitive rates of your VoIP provider for call termination.

​
Integration Options

You can connect your phone system to Famulor in two ways:

​
1. PBX Extension Integration

This is like giving our AI platform an “extension” on your phone system: What it is: Connect a specific extension from your PBX/phone system. Ideal for:
  • Testing the integration
  • Forwarding specific extensions to the AI
  • Simple setup with existing phone systems
You need:
  • Your extension number (e.g., 1000)
  • Extension username and password
  • Your PBX server address (e.g., pbx.yourcompany.com)
Example in practice: 
Your office uses extensions 1001-1010 for staff
You set up extension 1011 for the AI assistant
Calls to 1011 go to the AI
The AI can make calls appearing as extension 1011

​
2. Direct Number Integration

This connects specific phone numbers to our platform: What it is: Forward one or more of your phone numbers to our AI. Ideal for:
  • Dedicated AI phone lines
  • Customer service numbers
  • Sales or support lines
You need:
  • Your phone number (e.g., +49 30 123456)
  • SIP credentials from your provider
  • Your provider’s SIP server address
Example in practice: 
You have a support number: +49 30 123456
You connect this number to our AI
All calls to +49 30 123456 are handled by the AI assistant
The AI makes outbound calls showing +49 30 123456

​
Authentication & Call Flow

​
Bidirectional Configuration

The SIP integration uses the same credentials for inbound and outbound calls: Incoming Calls (VoIP → Famulor): 
Your VoIP system authenticates using username/password
↓
Calls reach our platform
↓
AI assistant answers
Outgoing Calls (Famulor → VoIP): 
AI initiates call
↓
Our platform authenticates to your VoIP using the same username/password
↓
Call reaches the destination

​
Credential Synchronization

To ensure proper operation:
  • The credentials you enter in the Famulor dashboard must exactly match your VoIP configuration.
  • The same username/password pair is used for both directions.
  • Any credential changes must be updated in both systems.
  • If you change credentials in your VoIP system, make sure to update them in the Famulor dashboard (and vice versa) to maintain the connection.

​
Setting Up Your Integration

​
Step 1: Gather Your Information

For PBX Extension: 
Extension number: e.g., 1000
Server address: e.g., pbx.company.com
Username: Your extension username
Password: Your extension password
For Direct Number: 
Phone number: e.g., +49 30 123456
SIP server: e.g., sip.provider.com
Username: Provided by your telephony provider
Password: Provided by your telephony provider

​
Step 2: Configure in the Dashboard

  1. Go to your Famulor dashboard
  2. Navigate to “Your Phone Numbers”
  3. Click on “Integrate SIP Trunk”

​
Step 3: Select SIP Trunk Type

At the top of the form, choose one of these trunk types:
  • SIP Extension – Use this if you already have SIP credentials (an extension) provided by your VoIP provider.
  • Phone Number (DID) – Use this if you want to integrate a dedicated Direct Inward Dial (DID) number instead of a generic SIP extension.
For PBX Extension: 
Extension number: e.g., 1000
Username: Your extension username
Password: Your extension password
For Direct Number: 
Phone number: e.g., +49 30 123456
Username: Provided by your telephony provider
Password: Provided by your telephony provider

​
Step 4: Outgoing Settings

These control how Famulor sends outbound calls via your SIP provider. SIP Address – Enter the address/server of the SIP trunk without the port. Outgoing Proxy (Static IP) – Some SIP providers require calls to originate from a single whitelisted IP address. Configure as follows:
  • Toggle ON – If your SIP provider requires a fixed source IP, enable “Outgoing Proxy comes from a fixed IP address.” Famulor will then send all outbound requests from a known static IP. Use only if your provider explicitly requires a single source IP.
  • Toggle OFF – If your provider accepts calls from any IP, leave off. Famulor will send calls from dynamic IPs.
SIP Address: (e.g., pbx.company.com/sip.provider.com)

​
Step 5: Number Format Configuration

This informs our system how to format phone numbers when placing calls. Choose based on your provider’s requirements: International with + 
Format: +[Country][Number]
Example: +49 30 123456
SIP Request: sip:+4930123456@your.pbx.com
International without + 
Format: [Country][Number]
Example: 49 30 123456
SIP Request: sip:4930123456@your.pbx.com
National Format 
Format: [Local Number]
Example: 030 123456
SIP Request: sip:030123456@your.pbx.com

​
Step 6: Incoming Settings

These determine how Famulor receives and authenticates incoming calls from your SIP provider. Our SIP Address – Famulor assigns a unique inbound SIP URI (e.g., your-unique-id.sip.livekit.cloud). Your SIP provider must be configured to send inbound calls to this address by pointing their outbound trunk or routing rule to this URI.
Important: You can find your specific SIP URL in your Famulor dashboard under “Phone Numbers” → “Integrate SIP Trunk” → “Our SIP Address”.
IP Address (Whitelist IPs) – If your SIP provider sends calls from a known set of public IP addresses, select “IP Address.” Then add each provider IP to the whitelist under “Incoming Authentication.” Username and Password – If your provider supports SIP authentication, select “Username and Password.” The same credentials you entered under “Outgoing Settings” (username/password) will be used to authenticate incoming calls. Make sure your provider’s PBX is configured to use these credentials.

​
Step 7: Select Country

Select the country where your SIP trunk is provisioned.

​
Step 8: Verify Setup

After configuration:
  1. Place a test call to your number/extension
  2. Confirm the AI assistant answers
  3. Use the test call feature to verify outbound calls

​
Security Requirements

Your SIP credentials must be secure:
  • Username: Your extension number or username provided by the provider
  • Password requirements:
    • 12 or more characters
    • Numbers
    • Upper and lowercase letters
    • Special characters recommended

​
Frequently Asked Questions

Can I use multiple numbers? Yes! You can integrate multiple extensions or direct numbers with our platform. Will I lose control over my numbers? No, you retain full control via your current provider. The integration only connects your system to our platform. Can I still use my numbers for regular calls? Yes, you can set up routing rules in your phone system to decide which calls go to the AI and which go to your standard phone system. What if I need to change settings later? You can update your integration settings anytime via the dashboard. All configuration options remain accessible after initial setup. How does this help with call costs? By using your own VoIP provider, you benefit from their local rates and existing agreements, which are often more competitive than standard carrier rates. This is especially advantageous for international calls.

​
Need Help?

Our support team specializes in assisting customers with integrating their phone systems. We guide you through the entire process to ensure a smooth setup with your specific phone system configuration.