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

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

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