> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 3CX SIP integration

> Connect your 3CX phone system to Famulor and route a DID through an outbound rule.

Route an existing 3CX number to your Famulor assistant, for example when the office is closed or a queue is full. You need a 3CX instance that exposes **Generic SIP Trunk (IP Based)** and the public signaling IPs of the 3CX instance or SBC that will send SIP calls to Famulor.

## Create an IP-based trunk

1. In Famulor, open **Settings → Phone numbers → Add a number → Add SIP integration**. Choose the **SIP region** and copy the hostname from the SIP URI.
2. In 3CX, open **Trunks & Chat** (called **Voice & Chat** in some versions), click **+ Trunk**, and select **Generic SIP Trunk (IP Based)**.
3. Enter the Famulor hostname as **Registrar/Server** and choose **Do not require – IP Based** for authentication. If your version shows **Disable Registration**, turn it on.
4. In **Options**, set **Transport Protocol** to TCP and enable G.711 A-law and µ-law (PCMA and PCMU). Use RFC 2833 DTMF. If the original caller ID is missing, set **From: Display Name** and **Remote Party ID – Calling Party: Display Name** to `OriginatorCallerID`. [3CX SIP trunk settings](https://www.3cx.com/docs/manual/sip-trunks/) · [3CX caller ID fields](https://www.3cx.com/docs/sip-trunk-outbound-calls/).

![Use the Trunk action in 3CX to add the connection.](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/famulor_3cx_trunk_create_new_en.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=734d9ebe593d5f9694b3159f4f45b13f)

Use the Trunk action in 3CX to add the connection.

![3CX trunk provider menu with Generic SIP Trunk (IP Based) selected](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/famulor_3cx_trunk_creation_en.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=0ba5d6d5afeee48ba837dc4024a6432f)

Select Generic SIP Trunk (IP Based) in 3CX.

![3CX trunk options highlighting Transport Protocol](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/famulor_3cx_tcp_protocol_en.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=ddd1b913ef77717ec02a5a4987a4c146)

Set the transport protocol to TCP in the trunk options.

![3CX caller ID settings highlighting the From and Remote Party ID fields](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/famulor_3cx_caller_id_settings_en.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=8433ecd3c782421ec1d9d3e28ce37334)

Use OriginatorCallerID to pass through the caller number.

## Route a 3CX call to the assistant

1. In Famulor, enter the DID the trunk will send as **Phone number (DID)**. Choose **Provider source IPs** and add the fixed public signaling addresses of your 3CX system. Enter the PBX or SBC’s public SIP hostname as the **Termination address**. Set **Outbound authentication** to **No outbound credentials** for an IP-based setup. Save the trunk and assign the DID to an assistant.
2. In 3CX **Outbound Rules**, add a rule for a distinct prefix such as `999`. Select the Famulor trunk as the first route, strip three digits and put this rule above any rule that would catch the call first. For example, dial `99912025550123` with **Prepend** set to `+` to send `+12025550123` to Famulor.
3. In the DID’s inbound routing rule or its user or queue settings, send calls to that external dial string for the hours or overflow conditions you want. This inbound rule triggers the outbound rule. [3CX outbound call routing](https://www.3cx.com/docs/manual/outbound-call-routing/).

### What to enter in Famulor

The screenshots use the English app labels.

![Incoming calls in Famulor](https://mintcdn.com/ouraicall/1SYDI0Rp2OzxQz66/images/guide-ui/sip-inbound-2026-11-17.webp?fit=max\&auto=format\&n=1SYDI0Rp2OzxQz66\&q=85\&s=3ccc75bb7a279b3fed67f99237270ff5)

Incoming calls in Famulor

* **Your phone number (DID)** · Enter the exact number delivered by 3CX / SBC, with its country code and leading + for an E.164 DID.
* **Inbound authentication / Allowed source IPs** · Choose **Provider source IPs** and enter the complete SIP signaling list for 3CX / SBC and the selected route.

![Example in the English app](https://mintcdn.com/ouraicall/4u43DrIxuKKqCPTo/images/guide-ui/sip-3cx-out-example.webp?fit=max\&auto=format\&n=4u43DrIxuKKqCPTo\&q=85\&s=572c4940b17c97a32d740e52e1e898ab)

Example in the English app

* **Termination address** · Use the provider hostname from the setup above (3CX / SBC). Enter only the hostname, without a SIP prefix or port.
* **Outbound authentication** · For the IP-based setup, select **No outbound credentials** after configuring the PBX or SBC to allow Famulor’s outbound sources.

## Test and configure the reverse direction

Call the public number on 3CX and verify that **History** in Famulor shows an inbound call with the right assistant and two-way audio. If it stays in 3CX, check the inbound and outbound rules together and confirm that the trunk receives the exact DID.

For calls from Famulor to 3CX, configure the 3CX system or SBC to accept a new INVITE from the [Famulor outbound source addresses](https://docs.famulor.io/telephony/sip-trunks.md#outbound-source-addresses) for the selected **Outbound region**. Set **No outbound credentials** for IP authentication. Verify the reverse route separately. For one-way audio on a self-hosted system, check 3CX’s public media address and RTP port configuration. [3CX firewall guide](https://www.3cx.com/docs/manual/firewall-router-configuration/).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.