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

# Asterisk / FreePBX mit Famulor verbinden

> Richte Routing und Authentifizierung ein und teste Anrufe von Asterisk / FreePBX an deinen Famulor-Assistenten.

Leite mit dieser Anleitung Anrufe von Asterisk / FreePBX an deinen Assistenten. Kläre die Verbindungsart deines Kontos, bevor du die Rufnummer umstellst.

## Ziel in Famulor vorbereiten

1. Öffne **Einstellungen → Telefonnummern → Nummer hinzufügen → SIP-Integration hinzufügen**. Wähle die SIP-Region und kopiere die angezeigte SIP-URI.
2. Stimme für eine statische SIP-Verbindung die genaue Zielrufnummer, den Transport und die eingehende Authentifizierung mit dem Anbieter oder Anlagenadministrator ab. Hinterlege diese Nummer als DID in Famulor. Verwende die vollständigen SIP-Signalisierungsadressen oder SIP-Zugangsdaten, wenn der Anbieter Digest zum Ziel unterstützt.
3. Hinterlege Terminierungshost und ausgehende Authentifizierung des Anbieters oder der Anlage, falls du darüber telefonieren möchtest. Speichere die Integration und weise die Nummer deinem Assistenten zu.

### Was du in Famulor einträgst

Die Screenshots zeigen die englischen Feldnamen der App.

![Eingehende Anrufe 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)

Eingehende Anrufe in Famulor

* **Your phone number (DID)** · Trage die exakte Nummer ein, die Asterisk / FreePBX zustellt. Für eine DID im E.164-Format brauchst du Landesvorwahl und führendes +.
* **Inbound authentication / Allowed source IPs** · Wähle **Provider source IPs** und trage die vollständige SIP-Signalisierungsliste für Asterisk / FreePBX und die gewählte Route ein.
* Wenn der Anbieter Digest an Famulor sendet, wähle **SIP username/password** und nutze dieselben eingehenden Zugangsdaten wie beim Anbieter.

![Beispiel in der englischen App](https://mintcdn.com/ouraicall/4u43DrIxuKKqCPTo/images/guide-ui/sip-asterisk-out-example.webp?fit=max\&auto=format\&n=4u43DrIxuKKqCPTo\&q=85\&s=1fda0b3b07b589aaea09db06c101b1de)

Beispiel in der englischen App

Verwende deine eigene Rufnummer, die Einstellungen deines Anbieters und deinen SIP-Login. Das Passwortfeld bleibt im Beispiel leer.

* **Termination address** · Nutze den Anbieter-Hostnamen aus der Anleitung (Asterisk / FreePBX). Trage nur den Hostnamen ohne SIP-Präfix oder Port ein.
* **Outbound authentication / SIP username / SIP password** · Wähle bei Digest **Username / password**. Trage SIP-Benutzername und Passwort aus **platform-auth** ein.

Wenn beide Richtungen Digest mit unterschiedlichen Logins verwenden, wähle unter **Credentials** die Option **Separate inbound and outbound credentials**. Das Formular zeigt dann eigene Zugangsdatenfelder für jede Richtung.

## Asterisk / FreePBX einrichten

Konfiguriere in beide Richtungen einen statischen, nicht registrierenden Trunk – Asterisk sendet der Plattform nie ein SIP REGISTER, und die Plattform erwartet auch keins.

### FreePBX (GUI)

1. Öffne **Connectivity → Trunks → Add Trunk → Add SIP (chan\_pjsip) Trunk** und gib dem Trunk einen Namen.
2. Setze unter **pjsip Settings → General** den **SIP Server** auf den Famulor-Host deiner Region, den Port auf 5060 und **Transport** auf deinen TCP-Transport. Wähle **Registration → None** und **Authentication → Outbound**. Trage die in Famulor eingerichteten eingehenden SIP-Zugangsdaten als Username und Secret ein.
3. Verwende unter **Advanced** denselben Host als **From Domain** und die genaue Famulor-DID als **From User**. Aktiviere ulaw und alaw und speichere mit **Submit → Apply Config**.
4. Lege unter **Connectivity → Outbound Routes** eine Route für die genaue Famulor-DID an und wähle diesen Trunk unter **Trunk Sequence**. Wähle die DID über diese Route aus dem eingehenden Routing oder Warteschlangenüberlauf. Prüfe, dass die SIP-Anfrage das führende `+` beibehält, wenn die Famulor-DID es enthält.

### Rohkonfiguration (pjsip.conf)

Das Beispiel verwendet den Hostnamen für Europa (EU). Nutze den Famulor-Hostnamen der Region, die du in der SIP-Integration ausgewählt hast. [SIP-Adressen nach Region](https://docs.famulor.io/de/telephony/sip-trunks.md#sip-adressen-für-eingehende-anrufe).

Das Beispiel nutzt einen SIP-Login für beide Richtungen. Trage ihn in Famulor als eingehende und ausgehende Zugangsdaten ein. `outbound_auth` beantwortet die Famulor-Anfrage; `auth` authentifiziert Anrufe aus Famulor. Lege bei unterschiedlichen Logins getrennte Auth-Abschnitte an.

```text theme={null}
[platform]
type=endpoint
context=from-platform
disallow=all
allow=ulaw
allow=alaw
aors=platform-aor
auth=platform-auth
outbound_auth=platform-auth
from_domain=5wxj7da18ea.eu.sip.livekit.cloud
from_user=<did-in-e164>
direct_media=no
rewrite_contact=yes

[platform-aor]
type=aor
contact=sip:5wxj7da18ea.eu.sip.livekit.cloud;transport=tcp

[platform-auth]
type=auth
auth_type=userpass
username=<username>
password=<password>

[platform-identify]
type=identify
endpoint=platform
match=<famulor-outbound-source-cidr>
```

Wähle für diesen Endpoint den TCP-Transport, den du in deiner Asterisk-Installation konfiguriert hast.

Bei Abbrüchen nach etwa 30 Sekunden prüfe im Asterisk-Mitschnitt, ob das SIP-ACK ankommt und ob Contact sowie SIP- und RTP-Adressen öffentlich erreichbar sind. Bei einseitigem Audio prüfe NAT und RTP-Routing. Bei 488 vergleiche die Codecs. Bei 401 oder 407 prüfe den SIP-Zugang auf der Seite, die zur Anmeldung aufgefordert wurde.

Gib für jeden zugelassenen [Famulor-Quellbereich](https://docs.famulor.io/de/telephony/sip-trunks.md#ausgehende-quelladressen) eine eigene `match=`-Zeile an. Ordne den Context `from-platform` der gewünschten Nebenstelle oder ausgehenden Route zu.

Route in `extensions.conf` nur die in Famulor konfigurierte DID zu diesem Endpunkt. Das Beispiel nutzt `+12025550123`; ersetze sie durch deine DID und verknüpfe den Kontext mit der gewünschten Eingangsroute oder Warteschlange.

```text theme={null}
[to-famulor]
exten => +12025550123,1,Dial(PJSIP/${EXTEN}@platform,60)
 same => n,Hangup()
```

![Famulor-SIP-Integration mit Europa und der eingehenden SIP-Adresse](https://mintcdn.com/ouraicall/1SYDI0Rp2OzxQz66/images/guide-ui/sip-region-2026-11-17.webp?fit=max\&auto=format\&n=1SYDI0Rp2OzxQz66\&q=85\&s=8f35c05be47202a269bf598eb620bc3b)

Im SIP-Formular findest du das eingehende Ziel der gewählten Region.

## Gesamten Anrufweg testen

Rufe deine vorhandene Nummer von extern an. Prüfe im **Verlauf** den eingehenden Eintrag, den Assistenten, die ursprüngliche Anrufernummer und Audio in beide Richtungen. Teste den Zeitplan, Warteschlangenüberlauf oder IVR-Zweig zur KI. Wenn du ausgehende Anrufe aktivierst, teste diese separat mit der gewählten ausgehenden Nummer. Teste auch die Übergabe an das vorgesehene menschliche Ziel.

## Wenn der Test fehlschlägt

Fehlt der Anruf im Verlauf, prüfe Rufnummernzuordnung, Zielhost, genaue DID und eingehende Authentifizierung. Bei verbundenen Anrufen ohne Audio prüfe Medien und Codecs. Bei ausgehenden Ablehnungen prüfe Zugangsdaten, Quelladressen, Anrufer-ID und Zielländer. Gib dem Support Anrufzeit und Anruf-ID.

[Gemeinsame SIP-Einstellungen](https://docs.famulor.io/de/telephony/sip-trunks.md).

[Asterisk PJSIP and NAT](https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/Configuring-res_pjsip-to-work-through-NAT/).


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