> ## 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/).

![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/).

![3CX outbound rule with prefix 999, the Famulor route and three digits to strip](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/famulor_3cx_outbound_rule_en.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=bdc9bec74df5786f8d6e4e12a54b16de)

Send a dedicated dialing prefix through the Famulor trunk.

## 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.