> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trunk SIP externe (BYO)

> Connectez votre propre fournisseur SIP et utilisez vos numéros existants

Vous avez déjà des numéros et un fournisseur SIP (Telekom, sipgate, Twilio, Telnyx, Plivo, ou tout autre trunk conforme aux standards) ? Connectez-les directement : les appels transitent entre votre fournisseur et l'infrastructure vocale de la plateforme, sans aucun portage de numéro.

## Checklist de configuration

1. **Copiez l'URI SIP de la plateforme** depuis **Paramètres → Numéros de téléphone → Ajouter une intégration SIP** (ou Importer depuis un opérateur). Choisissez une **région SIP** (par défaut : mondiale) pour que la signalisation entrante se termine là où vous en avez besoin (par exemple dans l'UE).
2. Chez votre fournisseur, définissez cet URI comme **destination d'origine / de transfert** pour vos numéros.
3. Créez le trunk dans la plateforme (formulaire ci-dessous) : authentification entrante + terminaison sortante.
4. Attribuez des numéros aux assistants, testez les appels entrants, puis passez un appel test sortant.

## Type de trunk

| Type                          | Quand l'utiliser                                                                                    | Numéros                                                                                                                                                                                                                                                                                          |
| ----------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Numéro de téléphone (DID)** | La plupart des opérateurs (recommandé)                                                              | Un DID E.164 sur le trunk ; répertorié sous **Numéros**                                                                                                                                                                                                                                          |
| **Extension SIP**             | L'opérateur envoie plusieurs DID vers un seul trunk ; vous vous authentifiez par identifiants ou IP | Les appels entrants acceptent n'importe quel DID. **DID principal** optionnel pour le numéro de l'appelant sortant — E.164 complet (`+…`) **ou** chiffres nationaux sans indicatif pays (par exemple `0741926265`). Les DID principaux uniquement nationaux ne sont pas répertoriés sous Numéros |

## Entrant (réception d'appels)

* **Votre numéro de téléphone (DID)** — le numéro E.164 public que vos clients composent ; doit correspondre à ce que l'opérateur transmet vers l'URI SIP de la plateforme.
* **Authentification entrante**
  * **Nom d'utilisateur/mot de passe SIP** (recommandé) — authentification digest.
  * **IP sources du fournisseur** — uniquement si l'opérateur ne peut pas faire d'authentification digest et publie des IP/CIDR sources SIP stables. Évitez les plages trop larges.
* Chez le fournisseur : transférez / envoyez vers l'URI SIP de la plateforme que vous avez copié.

Les appels entrants sont associés à l'assistant que vous avez attribué, exactement comme pour les numéros de la marketplace.

## Sortant (appels sortants)

* **Adresse de terminaison** — hôte SIP du fournisseur uniquement (par exemple `sip.telnyx.com`). Sans préfixe `sip:`, sans port.
* **Transport** — `AUTO` (recommandé), `UDP`, `TCP` ou `TLS`. Le trunking sécurisé utilise toujours TLS.
* **Région sortante** — l'endroit d'où la plateforme émet l'appel. Privilégiez **Automatique**, ou le pays le plus proche de vos clients / du POP de l'opérateur.
* **Format du numéro d'appel sortant** — la façon dont le numéro FROM est envoyé à l'opérateur. Doit correspondre au paramètre de l'opérateur (par exemple Telnyx Origination Number Format) :
  * International avec `+` (recommandé dans la plupart des cas)
  * International sans `+`
  * National (sans indicatif pays)
* **Identifiants**
  * **Partagés** (recommandé) — un seul nom d'utilisateur/mot de passe pour l'entrant et le sortant.
  * **Séparés** — secrets distincts pour l'entrant et le sortant, lorsque l'opérateur l'exige.
* **Authentification sortante** — nom d'utilisateur/mot de passe (recommandé). La plateforme n'a **aucune IP sortante statique**, donc les listes blanches d'IP des opérateurs échouent généralement. N'utilisez « aucun identifiant » que si l'opérateur autorise explicitement les appels sortants non authentifiés.

Les appels sortants et les campagnes peuvent alors utiliser votre trunk et vos numéros de l'appelant.

## Avancé

Déployez la section **Avancé** lors de la création ou de la modification d'un trunk BYO :

| Paramètre                                    | Signification                                                            | Recommandation                                                                                                                                                                  |
| -------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Trunking sécurisé (TLS + SRTP)**           | Signalisation et média chiffrés                                          | Activez lorsque l'opérateur prend en charge Secure Trunking / TLS+SRTP                                                                                                          |
| **Chiffrement média**                        | Autoriser (SRTP préféré) ou Exiger SRTP                                  | Autoriser, sauf si la conformité impose Exiger                                                                                                                                  |
| **En-têtes sortants personnalisés**          | En-têtes X-\* sur les INVITE sortants (10 max)                           | Vide, sauf si la documentation de l'opérateur exige un en-tête                                                                                                                  |
| **En-têtes entrants (200 OK)**               | En-têtes X-\* personnalisés dans le SIP 200 OK                           | Généralement vide                                                                                                                                                               |
| **Correspondances en-tête → attribut**       | Mappe les en-têtes SIP vers des attributs d'appel pour les agents/outils | Uniquement si vous avez besoin des métadonnées de l'opérateur                                                                                                                   |
| **Inclure les en-têtes SIP comme attributs** | Aucun / tous les X-\* / tous les en-têtes                                | **Aucun** (ne mappez que ce dont vous avez besoin)                                                                                                                              |
| **Codecs média**                             | Codecs SDP supplémentaires (PCMU, PCMA, G.722, AMR-WB)                   | Conservez les valeurs par défaut de la plateforme ; n'ajoutez AMR-WB que si nécessaire. Évitez « Codecs listés uniquement » sauf si vous connaissez les codecs du correspondant |
| **Délais média / sonnerie**                  | Surcharges facultatives (secondes)                                       | Laissez vide (valeurs par défaut de la plateforme), sauf en cas de dépannage                                                                                                    |

**Voix HD (G.722) :** activez-la dans les paramètres de connexion/codec **Telnyx** si nécessaire (pris en charge avec Telnyx, pas avec Twilio).

## Modifier ultérieurement

Les trunks existants se modifient depuis **Numéros → Configurer → Paramètres opérateur** (pas depuis une liste de trunks séparée sur Ajouter une intégration SIP).

## Routage UE

Pour les clients de l'UE, le trafic SIP peut se terminer sur le **point de terminaison SIP dédié à l'UE** de la plateforme, ce qui conserve le média et la signalisation à l'intérieur de l'UE — pertinent pour la documentation RGPD. Le traitement média/agent s'exécute à Francfort (eu-central).

## Limites et comportement

* Les numéros E.164 sur les trunks BYO comptent dans la même limite de forfait que les numéros achetés (`max_own_numbers`).
* Les appels passant par votre propre trunk évitent la surtaxe opérateur par destination de la plateforme — votre fournisseur facture directement la terminaison. Les minutes de votre forfait sont tout de même consommées ; voir [Facturation](/billing/minutes).
* Toutes les fonctionnalités des assistants — Flows, transfert à chaud, enregistrement, supervision — fonctionnent à l'identique sur les trunks BYO.

## API

Créez et gérez vos trunks via l'API publique (`POST /sip-trunks` et les endpoints associés dans la référence API). Les mêmes champs que dans l'interface (`trunk_kind`, `calling_number_format`, `transport`, correspondances Avancé, etc.) sont acceptés à la création ; les mots de passe ne sont jamais renvoyés.

<Tip>
  Testez d'abord l'entrant : appelez l'un de vos numéros et vérifiez qu'il apparaît dans **Appels** avec le bon assistant. Vérifiez ensuite le sortant avec un seul appel test avant de brancher le trunk sur vos campagnes.
</Tip>
