> ## 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. # 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 (Twilio, Telnyx, Plivo, Easybell, ou tout autre trunk conforme aux standards) ? Connectez-les directement, sans rien porter. Pour la direction du FQDN propre à chaque fournisseur, l'authentification entrante et les listes de signalisation, consultez les [guides des fournisseurs SIP](/fr/telephony/providers/overview). ## Checklist de configuration 1. **Copiez l'URI SIP de la plateforme** depuis **Settings → Numbers → Add a number → Add SIP integration** (ou Carrier import). Choisissez une **SIP region** (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 | | ---------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Phone number (DID)** | La plupart des opérateurs (recommandé) | Un DID E.164 sur le trunk ; répertorié sous **Numbers** | | **SIP Extension** | L'opérateur exige un identifiant sortant national ou de type extension | Un **Primary DID** explicite est requis pour la correspondance entrante — E.164 complet (`+…`) **ou** chiffres nationaux sans indicatif pays (par exemple `0741926265`). Ce n'est pas un caractère générique ; les DID uniquement nationaux ne sont pas répertoriés sous Numéros | ## Entrant (réception d'appels) * **Your phone number (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. * **Inbound authentication** * **SIP username/password** — uniquement si l'opérateur envoie explicitement des identifiants Digest à la destination de transfert. * **Provider source IPs** — à utiliser lorsque l'opérateur transfère vers le FQDN de la plateforme sans Digest en aval et publie des IP/CIDR stables de signalisation SIP. N'utilisez ni réseaux média ni 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 attribuez, exactement comme pour les numéros de la marketplace. ## Sortant (appels sortants) * **Termination address** — 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. * **Outbound region** — l'endroit d'où la plateforme émet l'appel. Privilégiez **Automatic**, ou le pays le plus proche de vos clients / du POP de l'opérateur. * **Outbound calling number format** — 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) * **Credentials** * **Shared** (recommandé) — un seul nom d'utilisateur/mot de passe pour l'entrant et le sortant. * **Separate** — secrets distincts pour l'entrant et le sortant, lorsque l'opérateur l'exige. * **Outbound authentication** — 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](/fr/campaigns/overview) peuvent alors utiliser votre trunk et vos numéros d'appelant. ## Avancé Déployez la section **Advanced** lors de la création ou de la modification d'un trunk BYO : | Paramètre | Signification | Recommandation | | ------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Secure trunking (TLS + SRTP)** | Signalisation et média chiffrés | Activez lorsque l'opérateur prend en charge Secure Trunking / TLS+SRTP | | **Media encryption** | Autoriser (SRTP préféré) ou Exiger SRTP | Autoriser, sauf si la conformité impose Exiger | | **Custom outbound headers** | En-têtes X-\* sur les INVITE sortants (10 max) | Vide, sauf si la documentation de l'opérateur exige un en-tête | | **Inbound headers (200 OK)** | En-têtes X-\* personnalisés dans le SIP 200 OK | Généralement vide | | **Header → attribute maps** | 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 | | **Include SIP headers as attributes** | Aucun / tous les X-\* / tous les en-têtes | **None** (ne mappez que ce dont vous avez besoin) | | **Media codecs** | 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 | | **Media / ringing timeouts** | Surcharges facultatives (secondes) | Laissez vide (valeurs par défaut de la plateforme), sauf en cas de dépannage | **HD Voice (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 **Numbers → Configure → Carrier Settings** (pas depuis une liste de trunks séparée sur Add SIP integration). ## Routage UE Pour les clients de l'UE, sélectionnez la **EU SIP region** lors de la création de la connexion. Consultez votre contrat et la documentation sur le traitement des données pour connaître les engagements régionaux applicables. ## Limites et comportement * Les numéros E.164 sur les trunks BYO comptent dans la même allocation de numéros que les numéros achetés. * 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](/fr/billing/minutes). * Les fonctionnalités des assistants telles que les Flows, le transfert à chaud et l'enregistrement fonctionnent à l'identique sur les trunks BYO. ## Dépannage **Les appels sortants échouent ou ne se connectent pas** — vérifiez d'abord l'hôte de terminaison, le transport et les identifiants au regard de la documentation de votre fournisseur : un mauvais transport (UDP au lieu de TLS), ou un préfixe `sip:` ou un port superflu sur l'adresse de terminaison, est la cause la plus fréquente. Comparez ensuite le format du numéro d'appel sortant et les réglages de codec avec ce qu'attend le fournisseur. Modifiez un seul réglage à la fois et passez un appel test après chacun, pour que **History** vous montre quel changement a résolu le problème. **Les appels entrants n'atteignent pas l'assistant** — le fournisseur doit envoyer les appels vers le **FQDN** SIP de la plateforme, jamais vers une adresse IP brute ; envoyer vers une IP est la cause la plus fréquente d'échec en entrant. Avec les Provider source IPs, vérifiez que chaque IP ou CIDR de signalisation actuel est bien saisi — une liste obsolète ou incomplète rejette les appels silencieusement. Confirmez ensuite que le DID correspond exactement à ce qu'envoie le fournisseur : un trunk Extension SIP a aussi besoin de son DID principal renseigné, car ce n'est pas un caractère générique. **Les transferts d'appel via SIP REFER échouent** — vérifiez d'abord que le fournisseur de destination prend réellement en charge SIP REFER ; ce n'est pas le cas de tous les opérateurs, et c'est la cause la plus fréquente. Si un format d'URI échoue, essayez les alternatives dans l'ordre : avec le port (`sip:+1234567890@sip-server:5060`), sans le port, puis un `sip:+1234567890` nu. Écartez aussi la destination elle-même : vérifiez que le numéro cible est joignable et non bloqué avant de conclure que le trunk est en cause. Lorsqu'un transfert a été tenté et a échoué, le journal d'événements de l'appel contient `call_transfer_failed` ou `warm_transfer_failed` ; consultez [Appels entrants et sortants](/fr/telephony/inbound-outbound#indications-en-cas-déchec) pour la structure d'échec commune. Testez l'entrant et le sortant indépendamment : le bon fonctionnement de l'un ne confirme pas celui de l'autre. Toujours bloqué ? Contactez le support avec l'ID d'appel, la configuration exacte du trunk et, pour les problèmes de transfert, le format d'URI SIP que vous avez essayé. ## API et MCP Créez et gérez vos trunks via l'API publique (`POST /api/v1/sip-trunks` et les endpoints associés dans la référence API), ou avec les outils MCP `create_sip_trunk`, `list_sip_trunks`, `get_sip_trunk` et `delete_sip_trunk`. Les deux surfaces prennent en charge les mêmes paramètres destinés aux clients que l'interface, et les mots de passe ne sont jamais renvoyés. Testez d'abord l'entrant : appelez l'un de vos numéros et vérifiez qu'il apparaît dans **History** avec le bon assistant. Vérifiez ensuite le sortant avec un seul appel test avant de brancher le trunk sur vos campagnes.