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

# STARFACE SIP integration

> Create a STARFACE line, route calls by schedule and transfer callers back over SIP.

Send calls from your STARFACE phone system to a Famulor assistant, for example outside business hours. You need administrator access to STARFACE, a number that can be assigned to the new line, and the public SIP-signaling addresses of your STARFACE system or SBC.

## Create the line in STARFACE

1. In Famulor, open **Settings → Phone numbers → Add a number → Add SIP integration**. Select your **SIP region** and copy the hostname from the SIP URI.
2. In STARFACE, open **Configuration → Lines (Leitungen)** and choose **Neue Leitung**. Use a host-based SIP line without registration.
3. On the **Provider** tab, enter the Famulor hostname in **host** and **fromdomain**, and choose **tcp** for **transport**. The line can show as unregistered when configured this way.
4. Add the number on the **Rufnummern** tab. Enable **CLIP No Screening** if your STARFACE setup permits the original caller ID to be sent, and note the line prefix, for example `**2*`. [STARFACE documentation](https://knowledge.starface.de/).

![STARFACE Lines tab with the Neue Leitung button highlighted](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/starface/starface-neue-leitung.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=ff0f163ca0d26f7d27f7afeae6073e7b)

Create the line under Leitungen in the STARFACE configuration.

![STARFACE provider SIP configuration with host and fromdomain indicated](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/starface/starface-provider-sip.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=0bea9db39f6f2ff655a61a44e519159a)

Set host, fromdomain and transport on the Provider tab.

![Add the number on the line’s Rufnummern tab.](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/starface/starface-rufnummern.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=b102c7d8c2b5a41bd500d3eab1542be9)

Add the number on the line’s Rufnummern tab.

![STARFACE line settings with the line prefix and CLIP No Screening highlighted](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/starface/starface-clip-no-screening.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=122f80fc94ded91d95463b316dc80ee6)

Note the line prefix and check the CLIP No Screening setting.

## Assign the number and schedule the routing

1. In Famulor, choose **Phone number (DID)** and enter the exact `+E.164` number STARFACE will send. Choose **Provider source IPs** and enter the public SIP-signaling addresses of STARFACE. Set **Termination address** to your public STARFACE or SBC SIP host. Set **Outbound authentication** to **No outbound credentials** for an IP-based setup. Save and assign an assistant.
2. In STARFACE, open **Configuration → Users (Benutzer) → Rufnummern** for the user and assign the external SIP number on the new line.
3. Open **Modules → Zeitgesteuerte Umleitung**. Select the number to forward, choose **Rufnummer** as the destination type, and enter the line prefix followed by the international dial string. With prefix `**2*`, use `**2*0012025550123` to dial `+12025550123`. Set the time windows and confirm that the outgoing SIP request carries the exact DID saved in Famulor.

![STARFACE user settings showing the assigned line number under Rufnummern](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/starface/starface-benutzer-rufnummer.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=be1ab51da15fef3945c549f63ec7b367)

Assign the external SIP number on the user’s Rufnummern tab.

![STARFACE timed forwarding form with the destination number field highlighted](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/starface/starface-zeitgesteuerte-umleitung.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=a38e51c093a5675f9ed4a3f52c7fdd8a)

In Zeitgesteuerte Umleitung, use the line prefix in the destination number.

![Check the public media address when STARFACE runs behind NAT.](https://mintcdn.com/ouraicall/YHkeF3SwYhU0rNTj/images/starface/starface-nat.png?fit=max\&auto=format\&n=YHkeF3SwYhU0rNTj\&q=85\&s=ea2aad740b11b177670ea2a863a724e3)

Check the public media address when STARFACE runs behind NAT.

### 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 STARFACE / 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 STARFACE / SBC and the selected route.

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

Example in the English app

* **Termination address** · Use the provider hostname from the setup above (STARFACE / 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 calls and transfers

Call the number during a configured time window and confirm the inbound entry in **History**, the assigned assistant and two-way audio. If audio only works in one direction and STARFACE is behind NAT, check **Server configuration → Network → Behind NAT?** and the line’s **nat** setting. Make sure STARFACE advertises its reachable public media address.

For a transfer back to a STARFACE user, configure a SIP destination for the intended extension on your PBX or SBC. Test the transfer separately. Sending the caller back to the same public number that forwards to Famulor creates a call loop. [Assistant transfer settings](https://docs.famulor.io/assistants/built-in-tools.md).


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