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

# Connecter Asterisk / FreePBX à Famulor

> Configurez le routage, authentifiez les appels et testez la connexion de Asterisk / FreePBX à votre assistant Famulor.

Acheminez les appels de Asterisk / FreePBX vers votre assistant. Confirmez le mode de connexion de votre compte avant de modifier le routage du numéro.

## Préparer la destination Famulor

1. Ouvrez **Paramètres → Numéros de téléphone → Ajouter un numéro → Ajouter une intégration SIP**. Choisissez la région SIP et copiez l’URI affichée.
2. Pour une connexion SIP statique, confirmez le numéro appelé exact, le transport et l’authentification entrante avec l’opérateur ou l’administrateur du PBX. Saisissez ce numéro comme DID dans Famulor. Utilisez toutes les adresses de signalisation SIP ou des identifiants si le fournisseur prend en charge Digest vers cette destination.
3. Renseignez l’hôte de terminaison et l’authentification sortante si vous passez des appels via cette connexion. Enregistrez et attribuez le numéro à votre assistant.

### Champs à renseigner dans Famulor

Les captures montrent les libellés anglais de l’application.

![Appels entrants dans 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)

Appels entrants dans Famulor

* **Your phone number (DID)** · Saisissez le numéro exact transmis par Asterisk / FreePBX, avec l’indicatif du pays et le signe + pour un DID au format E.164.
* **Inbound authentication / Allowed source IPs** · Sélectionnez **Provider source IPs** et saisissez la liste complète des sources de signalisation SIP de Asterisk / FreePBX pour la route choisie.
* Si le fournisseur envoie une authentification Digest à Famulor, sélectionnez **SIP username/password** et saisissez les mêmes identifiants entrants que chez le fournisseur.

![Exemple dans l’application en anglais](https://mintcdn.com/ouraicall/4u43DrIxuKKqCPTo/images/guide-ui/sip-asterisk-out-example.webp?fit=max\&auto=format\&n=4u43DrIxuKKqCPTo\&q=85\&s=1fda0b3b07b589aaea09db06c101b1de)

Exemple dans l’application en anglais

Utilisez votre numéro, les paramètres de votre fournisseur et vos identifiants SIP. Le champ du mot de passe est vide dans l’exemple.

* **Termination address** · Utilisez le nom d’hôte du fournisseur indiqué dans la configuration (Asterisk / FreePBX), sans préfixe SIP ni port.
* **Outbound authentication / SIP username / SIP password** · Pour Digest, sélectionnez **Username / password** et saisissez les identifiants SIP de **platform-auth**.

Si les deux sens utilisent Digest avec des identifiants différents, choisissez **Separate inbound and outbound credentials** dans **Credentials**. Un groupe de champs s’affiche pour chaque sens.

## Configurer Asterisk / FreePBX

Configurez un trunk statique, sans enregistrement, dans les deux sens — Asterisk n'envoie jamais de SIP REGISTER à la plateforme, et la plateforme n'en attend jamais.

### FreePBX (interface graphique)

1. Ouvrez **Connectivity → Trunks → Add Trunk → Add SIP (chan\_pjsip) Trunk** et nommez le trunk.
2. Sous **pjsip Settings → General**, indiquez le nom d’hôte Famulor de votre région comme **SIP Server**, le port 5060 et votre transport TCP. Réglez **Registration** sur **None** et **Authentication** sur **Outbound**. Renseignez le nom d’utilisateur et le secret configurés comme identifiants entrants dans Famulor.
3. Sous **Advanced**, utilisez le même hôte pour **From Domain** et le DID exact pour **From User**. Activez ulaw et alaw, puis **Submit → Apply Config**.
4. Sous **Connectivity → Outbound Routes**, ajoutez une route pour le DID Famulor exact et sélectionnez ce trunk dans **Trunk Sequence**. Depuis la destination du numéro entrant ou le débordement de file, composez ce DID par la route. Vérifiez que la requête SIP conserve le `+` du DID Famulor.

### Configuration brute (pjsip.conf)

Cet exemple utilise l’hôte Europe (UE). Utilisez le nom d’hôte Famulor de la région sélectionnée dans l’intégration SIP. [Adresses SIP par région](https://docs.famulor.io/fr/telephony/sip-trunks.md#adresses-sip-entrantes).

L’exemple utilise un identifiant SIP pour les deux sens. Renseignez-le dans les identifiants entrants et sortants de Famulor. `outbound_auth` répond au défi de Famulor ; `auth` authentifie les appels provenant de Famulor. Créez des sections distinctes pour des identifiants différents.

```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>
```

Pour cet endpoint, sélectionnez le transport TCP configuré dans votre installation Asterisk.

Pour une coupure après environ 30 secondes, vérifiez dans la trace Asterisk la réception de l’ACK SIP et les adresses publiques de Contact, SIP et RTP. En cas de son à sens unique, vérifiez le NAT et le routage RTP. Pour un 488, comparez les codecs. Pour un 401 ou 407, vérifiez les identifiants de la partie qui a reçu la demande d’authentification.

Ajoutez une ligne `match=` pour chaque [plage source Famulor](https://docs.famulor.io/fr/telephony/sip-trunks.md#adresses-source-sortantes) autorisée. Associez le contexte `from-platform` à l’extension ou à la route sortante voulue.

Dans `extensions.conf`, acheminez uniquement le DID configuré dans Famulor vers cet endpoint. Remplacez `+12025550123` par votre DID et reliez ce contexte à la route entrante ou à la file prévue.

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

![Intégration SIP Famulor avec Europe et l’adresse SIP entrante](https://mintcdn.com/ouraicall/1SYDI0Rp2OzxQz66/images/guide-ui/sip-region-2026-11-17.webp?fit=max\&auto=format\&n=1SYDI0Rp2OzxQz66\&q=85\&s=8f35c05be47202a269bf598eb620bc3b)

Le formulaire SIP affiche la destination entrante de la région choisie.

## Tester le parcours complet

Appelez votre numéro depuis un téléphone externe. Vérifiez dans l’**Historique** l’appel entrant, l’assistant attribué, le numéro d’origine et le son dans les deux sens. Testez les horaires, le débordement de file ou la branche IVR qui mène à l’assistant. Si vous activez les appels sortants, testez-les séparément avec le numéro choisi. Testez aussi le transfert vers la destination humaine prévue.

## Si le test échoue

Si l’appel manque dans l’Historique, vérifiez l’attribution du numéro, l’hôte, le DID exact et l’authentification entrante. En cas d’appel connecté sans audio, vérifiez les médias et les codecs. Pour un refus sortant, vérifiez les identifiants, les IP autorisées, le numéro appelant et les destinations. Fournissez l’heure et l’identifiant d’appel à l’assistance.

[Paramètres SIP communs](https://docs.famulor.io/fr/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.