> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Trunking SIP

## Vue d'ensemble

Le trunking SIP (Session Initiation Protocol) vous permet de connecter directement votre infrastructure de téléphonie existante à ElevenLabs Agents.
Cette intégration permet à tous les clients d'utiliser leurs systèmes téléphoniques existants tout en tirant parti des fonctionnalités avancées d'IA vocale d'ElevenLabs.

Avec le trunking SIP, vous pouvez :

* Connecter votre autocommutateur privé (PBX) ou votre système téléphonique compatible SIP à la plateforme d'IA vocale d'ElevenLabs
* Acheminer les appels vers des agents IA sans modifier votre infrastructure téléphonique existante
* Gérer les appels entrants comme les appels sortants
* Tirer parti du transport TLS chiffré et du chiffrement des médias pour renforcer la sécurité

> **Tip**
>
> Vous découvrez SIP ? Consultez la [référence SIP](/docs/fr/eleven-agents/phone-numbers/sip-reference) pour obtenir
> des définitions simples des termes utilisés dans ce guide, tels que SIP, SBC, SDP, RTP
> et MTU.

> **Note**
>
> **Serveurs SIP à IP statique**
>
> ElevenLabs propose des serveurs SIP dotés d'adresses IP statiques aux clients Enterprise qui doivent autoriser certaines IP pour respecter leurs politiques de sécurité.
>
> Notre infrastructure à IP statique utilise un bloc d'adresses IP /24 contenant 256 adresses réparties dans plusieurs régions (États-Unis, UE, Inde et Singapour). Vous devez autoriser l'ensemble du bloc /24 dans la configuration de votre pare-feu.
>
> Pour l'environnement par défaut (États-Unis/international), utilisez `sip-static.rtc.elevenlabs.io` comme point de terminaison SIP.
> Pour les régions isolées, utilisez `sip-static.rtc.<region>.residency.elevenlabs.io`, où `<region>` correspond au code de votre région de résidence des données (par exemple `eu`, `in` ou `sg`). Avec ces points de terminaison, tout le trafic provient exclusivement de cette région. L'autorisation spécifique d'IP par région n'est pas disponible. Consultez la section [résidence des données](/docs/fr/overview/administration/data-residency) pour connaître les régions disponibles.
>
> Cette fonctionnalité est disponible pour les comptes Enterprise et peut également être activée pendant les essais Enterprise à des fins de test. Pour demander l'accès, envoyez un email à l'assistance à [support@elevenlabs.io](mailto:support@elevenlabs.io) ou contactez votre responsable de compte. Pour plus d'informations, [nous contacter](https://elevenlabs.io/contact-sales?utm_source=docs\&utm_medium=referral\&utm_campaign=static_ip_sip).

## Fonctionnement du trunking SIP

Le trunking SIP établit une connexion directe entre votre infrastructure de téléphonie et la plateforme ElevenLabs :

1. **Appels entrants** : les appels provenant de votre trunk SIP sont acheminés vers la plateforme ElevenLabs à l'aide de votre adresse SIP INVITE configurée.
2. **Appels sortants** : les appels initiés par ElevenLabs sont acheminés vers votre trunk SIP à l'aide de votre nom d'hôte configuré, ce qui permet à vos agents d'effectuer des appels sortants.
3. **Authentification** : la sécurité de la connexion pour la signalisation est assurée soit par authentification digest (nom d'utilisateur/mot de passe), soit par authentification via liste de contrôle d'accès (ACL) basée sur l'adresse IP source de la signalisation.
4. **Signalisation et médias** : l'établissement initial de l'appel (signalisation) prend en charge plusieurs protocoles de transport, dont TLS pour les communications chiffrées. Une fois l'appel établi, les données audio réelles (flux RTP) peuvent être chiffrées selon vos paramètres de chiffrement des médias.

## Sécurité du transport : certificats et suites de chiffrement

Lorsque vous utilisez le transport TLS, les deux parties effectuent une négociation TLS avant tout échange de signalisation SIP. Durant cette négociation, elles valident un certificat et négocient une suite de chiffrement. La partie qui accepte la connexion agit comme serveur TLS et présente le certificat ; celle qui ouvre la connexion agit comme client TLS et le valide. ElevenLabs exige TLS 1.2 ou une version ultérieure.

Les rôles dépendent du sens de l'appel :

* **Appels entrants vers ElevenLabs** : votre système ouvre la connexion, ElevenLabs agit donc comme serveur TLS. ElevenLabs présente un certificat valide pour `sip.rtc.elevenlabs.io`, que votre système valide en tant que client TLS.
* **Appels sortants depuis ElevenLabs** : ElevenLabs ouvre la connexion vers l'adresse que vous avez configurée. Votre serveur SIP ou SBC agit donc comme serveur TLS. Votre système doit présenter un certificat valide et approuvé, qu'ElevenLabs valide en tant que client TLS.

Assurez-vous que les deux parties approuvent les certificats de l'autre et partagent au moins une suite de chiffrement commune. Dans le cas contraire, la négociation TLS échoue avant l'établissement de l'appel. Consultez la [référence SIP](/docs/fr/eleven-agents/phone-numbers/sip-reference#authentication-and-security) pour connaître la définition de ces termes.

### Connexions de suivi

Certaines requêtes dans le dialogue, telles que `BYE` ou `REFER`, peuvent nécessiter une nouvelle connexion TLS lorsque la connexion initiale est déjà fermée. Le comportement des certificats pour ces connexions de suivi diffère de celui de l'établissement initial de l'appel :

* **Connexions de suivi vers ElevenLabs** : votre système établit la connexion vers l'adresse de l'en-tête `Contact` renvoyée dans la réponse, qui se résout vers un serveur SIP spécifique au format `<ip>.hosts.rtc.elevenlabs.io`. Ce serveur présente un certificat valide pour `*.hosts.rtc.elevenlabs.io`, que votre système valide en tant que client TLS.
* **Connexions de suivi depuis ElevenLabs** : lorsqu'ElevenLabs initie une connexion TLS pour un `BYE` ou un `REFER`, il se connecte à l'adresse de l'en-tête `Via` le plus haut, qui est souvent une adresse IP. Votre système renvoie généralement un certificat valide pour un nom de domaine complet (FQDN), plutôt que pour cette adresse IP. Pour valider ce certificat, configurez le champ **Domaines distants** dans les paramètres de votre numéro de téléphone. Si un domaine pour lequel le certificat reçu est valide correspond à un domaine distant configuré, la validation réussit ; sinon, elle échoue.

> **Tip**
>
> Si les requêtes `BYE` ou `REFER` sortantes via TLS échouent lors de la validation du certificat, ajoutez le FQDN pour lequel le certificat de votre serveur SIP
> a été émis dans le champ **Domaines distants** des paramètres du numéro de téléphone.

## Effectuer des appels vers le trunk SIP d'ElevenLabs

Lorsque vous initiez des appels vers la plateforme ElevenLabs, vous devez utiliser le format d'URI SIP approprié. L'URI du trunk SIP d'ElevenLabs dépend du transport que vous souhaitez utiliser pour la signalisation :

* **TCP** : `sip:sip.rtc.elevenlabs.io:5060;transport=tcp`
* **TLS** : `sip:sip.rtc.elevenlabs.io:5061;transport=tls`
* **UDP** : `sip:sip.rtc.elevenlabs.io:5060;transport=udp` (expérimental ; à utiliser uniquement pour les tests, pas en production)

Pour effectuer un appel, construisez un URI SIP complet qui inclut un identifiant. Par exemple, pour appeler le numéro de téléphone `+19991234567` via TCP :

```
sip:+19991234567@sip.rtc.elevenlabs.io:5060
```

Où :

* `+19991234567` est l'identifiant, généralement un numéro de téléphone au format E.164
* L'identifiant peut aussi être n'importe quelle valeur de chaîne, telle que `1000` ou `john`

> **Warning**
>
> **Erreur fréquente** : n'initiez pas d'appels directement vers `sip@sip.rtc.elevenlabs.io:5060` sans
> identifiant. L'URI SIP doit inclure un numéro de téléphone ou un identifiant après le préfixe `sip:` et
> avant le symbole `@`.

> **Info**
>
> **Format d'URI SIP** : un [URI SIP](https://en.wikipedia.org/wiki/SIP_URI_scheme) suit le format
> `sip:identifier@domain:port`, où l'identifiant est requis pour acheminer correctement l'appel.

## Prérequis

Avant de configurer le trunking SIP, assurez-vous de disposer des éléments suivants :

1. Un PBX ou un système de téléphonie compatible SIP
2. Des numéros de téléphone que vous souhaitez connecter à ElevenLabs
3. Un accès administrateur à la configuration de votre trunk SIP
4. Des paramètres de pare-feu appropriés pour autoriser le trafic SIP
5. **Prise en charge de TLS** : pour renforcer la sécurité, assurez-vous que votre fournisseur de trunk SIP prend en charge le transport TLS
6. **Compatibilité des codecs audio** :
   votre système doit prendre en charge au moins l'un des codecs audio G.722 ou G.711 (PCMU ou PCMA), ou être capable de rééchantillonner l'audio de votre côté. Cela est indépendant de tout format audio configuré sur l'agent pour les connexions websocket directes.

## Configurer le trunking SIP

#### Accéder à Numéros de téléphone

Accédez à la [section Numéros de téléphone](https://elevenlabs.io/app/agents/phone-numbers) du Dashboard ElevenLabs Agents.

#### Importer un trunk SIP

Cliquez sur le bouton « Importer un numéro », puis sélectionnez « Depuis un trunk SIP » pour ouvrir la boîte de dialogue de configuration.

![Menu d’importation de numéro avec l’option Depuis un trunk SIP](/docs/_fern-files/_img/5c6e4969f3ae086d4876674a1399e3f1f2b964d15b955d5f46ad95da655829fb.webp)

#### Saisir la configuration de base

Complétez la configuration de base avec les informations suivantes :

* **Libellé** : un nom descriptif pour le numéro de téléphone
* **Numéro de téléphone** : le numéro de téléphone au format E.164 à connecter (par exemple, +15551234567)

![Configuration de base du trunk SIP avec les champs Libellé et Numéro de téléphone](/docs/_fern-files/_img/682cc9b519dc50553e4849c528837ae3f6ff9ebeef005464004474d201cccb95.webp)

#### Configurer les paramètres entrants

Configurez la manière dont ElevenLabs gère les appels arrivant sur votre trunk SIP, y compris le chiffrement des médias et les contrôles d'accès :

* **Chiffrement des médias** : configurez le chiffrement des flux médias RTP :
  * **Désactivé** : aucun chiffrement des médias
  * **Autorisé** : autorise les flux médias chiffrés
  * **Obligatoire** : impose les flux médias chiffrés
* **Numéros autorisés** (facultatif) : numéros de téléphone autorisés à appeler ce numéro. Laissez vide pour autoriser tous les numéros.
* **Adresses IP source autorisées** (facultatif) : fonctionne uniquement avec le transport TCP/TLS, pas UDP. Adresses IP ou plages CIDR autorisées à envoyer des appels vers ce trunk. Laissez `0.0.0.0/0` pour autoriser toutes les adresses.
* **Domaines distants** (facultatif) : indiquez les domaines FQDN de vos serveurs SIP depuis lesquels vous initiez les appels, par exemple `example.pstn.twilio.com`. Ces domaines sont utilisés pour la validation des certificats TLS. Laissez ce champ vide si vous n'utilisez pas TLS.
* **Authentification** (facultatif) : fournissez les identifiants d'authentification digest qui serviront à authentifier les appels entrants.
  * **Nom d'utilisateur du trunk SIP** : nom d'utilisateur pour l'authentification digest SIP
  * **Mot de passe du trunk SIP** : mot de passe pour l'authentification digest SIP

![Paramètres de configuration entrants, dont le chiffrement des médias, les numéros autorisés, les adresses IP source autorisées, les domaines distants et l’authentification](/docs/_fern-files/_img/83a3ee6dd135f8f0206c08703ade8324d7993d88cc0572eaa1f65246313ccf90.webp)

#### Configurer les paramètres sortants

Configurez où ElevenLabs doit envoyer les appels pour votre numéro de téléphone :

* **Adresse** : nom d'hôte ou adresse IP vers lequel ou laquelle l'invitation SIP est envoyée (par exemple, `sip.telnyx.com`). Il doit s'agir uniquement d'un nom d'hôte ou d'une adresse IP, et non d'un URI SIP complet. Si vous utilisez TLS, utilisez un nom d'hôte avec un certificat valide.
* **Type de transport** : sélectionnez le protocole de transport pour la signalisation SIP :
  * **TCP** : transport TCP standard
  * **TLS** : transport TLS chiffré pour renforcer la sécurité
  * **UDP** : transport sans connexion (expérimental ; utilisez TCP ou TLS en production)
* **Chiffrement des médias** : configurez le chiffrement des flux médias RTP :
  * **Désactivé** : aucun chiffrement des médias
  * **Autorisé** : autorise les flux médias chiffrés
  * **Obligatoire** : impose les flux médias chiffrés
* **Codecs activés** : codecs à proposer dans le SDP pour les appels sortants (G.722, PCMU, PCMA). Utile lorsque votre fournisseur SIP ne prend en charge que certains codecs.
* **En-têtes personnalisés** (facultatif) : ajoutez des en-têtes SIP personnalisés à inclure dans les appels sortants. Cliquez sur « Ajouter un en-tête » pour saisir le nom et la valeur de l'en-tête requis par votre fournisseur ; vous pouvez ajouter plusieurs en-têtes selon vos besoins. Les en-têtes personnalisés peuvent servir à l'acheminement et à l'identification des appels, à la facturation et au suivi, ainsi qu'aux exigences propres à votre fournisseur.
* **Authentification** (facultatif) : fournissez des identifiants d'authentification digest si votre fournisseur de trunk SIP l'exige.

  * **Nom d'utilisateur du trunk SIP** : nom d'utilisateur pour l'authentification digest SIP
  * **Mot de passe du trunk SIP** : mot de passe pour l'authentification digest SIP

  Si ces champs sont laissés vides, l'authentification via liste de contrôle d'accès (ACL) sera utilisée, ce qui vous oblige à autoriser les adresses IP d'ElevenLabs dans les paramètres de votre fournisseur.

![Paramètres de configuration sortants, dont l’adresse, le type de transport, le chiffrement des médias, les codecs activés, les en-têtes personnalisés et l’authentification](/docs/_fern-files/_img/91e0283cb11362220b862856c2365c56fb47388f1b618007c1902d4515390253.webp)

> **Tip**
>
> **Bonne pratique de sécurité** : utilisez le transport TLS avec un chiffrement des médias obligatoire pour une sécurité maximale. Cela garantit que la signalisation et les médias sont chiffrés de bout en bout.

> **Info**
>
> **Méthodes d'authentification** :
>
> * **Authentification digest** : utilise des identifiants nom d'utilisateur/mot de passe pour une authentification sécurisée (recommandée)
> * **Authentification ACL** : utilise l'autorisation d'adresses IP pour le contrôle d'accès
>
> **L'authentification digest est fortement recommandée**, car elle offre une meilleure sécurité sans dépendre de l'autorisation d'adresses IP, qui peut être complexe à gérer avec des adresses IP dynamiques.

> **Note**
>
> Le champ **Adresse** indique où ElevenLabs enverra les appels sortants de vos agents IA. Saisissez uniquement le nom d'hôte ou l'adresse IP, sans le préfixe de protocole `sip:`.

#### Terminer la configuration

Cliquez sur « Importer » pour finaliser la configuration.

## Données client et personnalisation

Pour assurer le transfert et la traçabilité corrects des métadonnées d'appel, incluez les en-têtes SIP personnalisés suivants dans votre charge utile webhook et votre requête SIP INVITE :

* **X-CALL-ID** : identifiant unique de l'appel
* **X-CALLER-ID** : identifiant de l'appelant

Ces en-têtes permettent au système d'associer les métadonnées d'appel à la conversation et de fournir le contexte nécessaire à la personnalisation.

### Prise en charge des en-têtes de secours

Si les en-têtes standard ci-dessus ne sont pas présents, le système recherchera automatiquement l'en-tête SIP spécifique à Twilio :

* **sip.twilio.callSid** : identifiant d'appel unique de Twilio

Ce mécanisme de secours garantit la compatibilité avec Elastic SIP Trunking de Twilio sans nécessiter de modification de configuration.

### Flux de traitement

Une fois les métadonnées pertinentes reçues via l'un des en-têtes pris en charge, `caller_id` et/ou `call_id` sont disponibles dans le [webhook d'initiation de conversation](/docs/fr/eleven-agents/customization/personalization#conversation-initiation-webhooks) et comme [variables dynamiques système](/docs/fr/eleven-agents/customization/personalization/dynamic-variables#system-dynamic-variables).

### En-têtes personnalisés entrants comme variables dynamiques

Les en-têtes SIP personnalisés `X-` issus des appels entrants par trunk SIP sont automatiquement exposés comme [variables dynamiques](/docs/fr/eleven-agents/customization/personalization/dynamic-variables) dans la conversation.

Les noms d'en-tête sont normalisés en supprimant le préfixe `X-`, en convertissant le nom en minuscules, en remplaçant les traits d'union par des traits de soulignement et en ajoutant le préfixe `sip_`. Par exemple, `X-Contact-ID` devient `{{sip_contact_id}}` et `X-Campaign-ID` devient `{{sip_campaign_id}}`.

Utilisez ces variables dans les prompts d'agent, les premiers messages et les outils pour personnaliser la conversation avec le contexte fourni par l'appelant. Les valeurs sont également visibles dans l'historique de conversation, sous l'onglet **Appel téléphonique**.

> **Note**
>
> Les en-têtes réservés tels que `X-Call-ID` et `X-Caller-ID` continuent d'être associés à `system__call_sid` et
> `system__caller_id`. Les en-têtes entrants personnalisés ne peuvent pas remplacer ces variables système.

### En-têtes BYE à partir de variables dynamiques

Lorsqu'un appel se termine, ElevenLabs envoie un SIP BYE pour mettre fin au dialogue. Vous pouvez joindre des en-têtes personnalisés à ce BYE en associant des [variables dynamiques](/docs/fr/eleven-agents/customization/personalization/dynamic-variables) à des noms d'en-tête dans la configuration de votre trunk SIP.

Définissez `attributes_to_headers` sur `inbound_trunk_config` ou `outbound_trunk_config` lors de la [création](/docs/fr/api-reference/phone-numbers/create) ou de la [mise à jour](/docs/fr/api-reference/phone-numbers/update) d'un numéro de téléphone de trunk SIP via l'API. Chaque entrée associe un nom de variable dynamique au nom de l'en-tête SIP à inclure dans le BYE :

```json
"inbound_trunk_config": {
  "attributes_to_headers": {
    "dynamic_variable_name": "bye_header_name"
  }
}
```

La valeur de l'en-tête est la valeur finale de la variable dynamique à la fin de la conversation. Les valeurs définies pendant l'appel, via des outils d'agent, des remplacements par webhook ou d'autres mises à jour lors de l'exécution, sont reflétées dans le BYE.

Par exemple, si `attributes_to_headers` contient `"disposition_code": "X-Disposition"` et que la variable dynamique `disposition_code` vaut `resolved` lorsque la conversation se termine, le BYE inclut `X-Disposition: resolved`.

## Attribuer des agents aux numéros de téléphone

Après avoir importé votre numéro de téléphone de trunk SIP, vous pouvez l'attribuer à un agent ElevenLabs :

1. Accédez à la section Numéros de téléphone du Dashboard ElevenAgents
2. Sélectionnez votre numéro de téléphone de trunk SIP importé
3. Cliquez sur « Attribuer un agent »
4. Sélectionnez l'agent qui doit gérer les appels vers ce numéro

## Résolution des problèmes

#### Problèmes de connexion

Si vous rencontrez des problèmes de connexion :

1. Vérifiez la configuration de votre trunk SIP, à la fois du côté d’ElevenLabs et du côté de votre fournisseur.
2. Vérifiez que votre pare-feu autorise le trafic de signalisation SIP sur le protocole et le port configurés (5060 pour TCP, 5061 pour TLS), et assurez-vous qu’aucune liste d’autorisation n’est appliquée.
3. Confirmez que le nom d’hôte de votre adresse est correctement formaté et accessible.
4. Testez avec et sans identifiants d’authentification Digest.
5. Si vous utilisez le transport TLS, assurez-vous que les certificats TLS de votre fournisseur sont valides et correctement configurés.
6. Essayez différents types de transport (TCP ou TLS ; la prise en charge d’UDP est expérimentale) afin d’isoler les problèmes propres à TLS.

**Informations importantes sur l’architecture réseau :**

* ElevenLabs gère le trafic SIP depuis plusieurs serveurs SIP derrière l’adresse partagée `sip.rtc.elevenlabs.io`.
* Ces serveurs SIP communiquent directement avec votre serveur SIP.
* Les requêtes SIP peuvent provenir de différentes adresses IP en raison de notre infrastructure distribuée.
* Si votre politique de sécurité exige de placer le trafic entrant sur liste d’autorisation, contactez notre équipe d’assistance.

#### Échecs d’authentification

Si les appels échouent en raison de problèmes d’authentification :

1. Vérifiez à nouveau le nom d’utilisateur et le mot de passe de votre trunk SIP si vous utilisez l’authentification Digest.
2. Consultez les journaux de votre fournisseur de trunk SIP pour identifier les messages d’erreur d’authentification spécifiques.
3. Vérifiez que les en-têtes personnalisés, s’ils sont configurés, répondent aux exigences de votre fournisseur.
4. Testez avec des configurations simplifiées, sans en-têtes personnalisés, afin d’isoler les problèmes d’authentification.

#### Problèmes de TLS et de chiffrement

Si vous rencontrez des problèmes avec le transport TLS ou le chiffrement des médias :

1. Vérifiez que votre fournisseur de trunk SIP prend en charge le transport TLS sur le port 5061.
2. Vérifiez la validité des certificats, leurs dates d’expiration et les chaînes de confiance.
3. Assurez-vous que votre fournisseur prend en charge le chiffrement multimédia SRTP si vous utilisez le chiffrement multimédia « Required ».
4. Testez le chiffrement multimédia « Allowed » avant d’utiliser « Required » afin d’isoler les problèmes de chiffrement.
5. Essayez le transport TCP afin d’isoler les problèmes propres à TLS (la prise en charge d’UDP est expérimentale).
6. Contactez votre fournisseur de trunk SIP pour confirmer la prise en charge de TLS et de SRTP.

#### Problèmes d’en-têtes personnalisés

Si vous rencontrez des problèmes avec les en-têtes personnalisés :

1. Vérifiez les noms et valeurs exacts des en-têtes requis par votre fournisseur.
2. Vérifiez la sensibilité à la casse dans les noms d’en-têtes.
3. Assurez-vous que les valeurs des en-têtes ne contiennent pas de caractères spéciaux nécessitant un échappement.
4. Testez d’abord sans en-têtes personnalisés, puis ajoutez-les progressivement.
5. Pour les variables dynamiques des en-têtes personnalisés entrants, confirmez que les en-têtes utilisent le préfixe `X-` et consultez l’onglet **Appel téléphonique** dans l’historique des conversations.
6. Consultez la documentation de votre fournisseur pour connaître les en-têtes personnalisés pris en charge.

#### Absence de son ou son dans un seul sens

Si l’appel se connecte, mais qu’il n’y a pas de son ou que le son ne passe que dans un sens :

1. Vérifiez que votre pare-feu autorise le trafic UDP pour le flux multimédia RTP (généralement les ports 10000-60000).
2. RTP utilisant des adresses IP dynamiques, assurez-vous que les règles du pare-feu ne sont pas limitées à des adresses IP statiques précises.
3. Vérifiez les problèmes de traduction d’adresses réseau (NAT) susceptibles de bloquer le flux RTP.
4. Si vous utilisez le chiffrement multimédia « Required », assurez-vous que les deux extrémités prennent en charge SRTP.
5. Testez avec le chiffrement multimédia « Disabled » afin d’isoler les problèmes audio liés au chiffrement.

#### Problèmes de qualité audio

Si vous constatez une mauvaise qualité audio :

1. Assurez-vous que votre réseau dispose d’une bande passante suffisante (au moins 100 Kbps par appel) et d’une faible latence/gigue pour le trafic UDP.
2. Vérifiez l’absence de congestion réseau ou de perte de paquets, en particulier sur le chemin UDP.
3. Vérifiez que les paramètres de codec correspondent aux deux extrémités.
4. Si vous utilisez le chiffrement multimédia, assurez-vous que les deux extrémités traitent efficacement SRTP.
5. Testez différents paramètres de chiffrement multimédia afin d’isoler les problèmes de qualité.

#### L’appel ne se termine pas après l’envoi de la requête BYE (réception d’une réponse 481)

Une réponse 481 à un BYE signifie généralement que la requête a atteint un serveur SIP qui ne détient pas l’état de dialogue de l’appel.
Cela se produit souvent lorsque la connexion TCP initiale est déjà fermée et que le BYE est renvoyé vers l’adresse partagée générique (par exemple `sip.rtc.elevenlabs.io`)
plutôt que vers l’URI `Contact` spécifique renvoyée dans la réponse 200 OK.

1. Lors du rétablissement d’une connexion TCP pour BYE, ciblez toujours l’adresse `Contact` de la réponse INVITE afin que la requête atteigne le même serveur SIP que celui ayant traité le dialogue.
2. Évitez d’envoyer BYE à l’adresse partagée `sip.rtc.elevenlabs.io`, car la requête peut atteindre un autre nœud SIP, qui la rejettera avec une réponse 481.

> **Note**
>
> Consultez la [section 8.1.1.8 de la RFC 3261](https://datatracker.ietf.org/doc/html/rfc3261#section-8.1.1.8) pour connaître le comportement normatif régissant les en-têtes Contact et le routage des dialogues.

## Limites et points à prendre en compte

* La prise en charge de plusieurs appels simultanés dépend de votre niveau d’abonnement. Activez la [mise en file d’attente des appels](/docs/fr/eleven-agents/guides/call-queueing) pour mettre les appelants entrants en attente lorsque la limite est atteinte, plutôt que de les refuser.
* Les fonctionnalités d’enregistrement des appels et d’analyse sont disponibles, mais peuvent nécessiter une configuration supplémentaire.
* Les capacités d’appels sortants peuvent être limitées par votre fournisseur de trunk SIP.
* **Prise en charge de TLS** : assurez-vous que votre fournisseur de trunk SIP prend en charge TLS 1.2 ou une version ultérieure pour le transport chiffré.
* **Chiffrement multimédia** : la prise en charge de SRTP varie selon les fournisseurs ; vérifiez la compatibilité avant d’exiger le chiffrement.
* **Format audio** : le déploiement SIP d’ElevenLabs émet et reçoit de l’audio à l’aide des codecs PCMU ou PCMA (G.711, 8 kHz), ou G.722 (16 kHz). Cela est indépendant de tout format audio configuré sur l’agent pour les connexions WebSocket directes. Votre système de trunk SIP doit soit prendre en charge l’un de ces codecs de manière native, soit effectuer un rééchantillonnage afin de répondre aux exigences de votre système.

## FAQ

#### Puis-je utiliser mes numéros de téléphone existants avec ElevenLabs ?

Oui. Le trunking SIP vous permet de connecter vos numéros de téléphone existants directement aux
ElevenAgents d’ElevenLabs, sans les porter.

#### Quels fournisseurs de trunk SIP sont compatibles avec ElevenLabs ?

ElevenLabs est compatible avec la plupart des fournisseurs standard de trunk SIP, notamment Twilio, Vonage, Sinch,
Infobip, Telnyx, Exotel, Plivo, Bandwidth et d’autres fournisseurs prenant en charge les normes du protocole SIP. Le transport TLS
et le chiffrement multimédia SRTP sont pris en charge pour renforcer la sécurité.

#### Dois-je utiliser le transport TLS pour améliorer la sécurité ?

Oui. Le transport TLS est vivement recommandé pour les environnements de production. Il assure une signalisation SIP
chiffrée, ce qui renforce la sécurité de vos appels. Associé au chiffrement multimédia requis, il
garantit une protection complète de vos communications. Vérifiez toujours que votre fournisseur de trunk SIP
prend en charge TLS avant de l’activer.

#### Quelle est la différence entre les types de transport ?

* **TCP** : signalisation fiable, mais non chiffrée ; **TLS** : signalisation chiffrée et fiable
  (recommandée pour la production) ; **UDP** : signalisation sans connexion, actuellement expérimentale.

> **Note**
>
> Le transport UDP est expérimental et destiné uniquement aux tests. Pour les environnements de production et
> les applications critiques en matière de sécurité, utilisez toujours le transport TLS.

#### À quoi servent les en-têtes personnalisés ?

Les en-têtes SIP personnalisés vous permettent d’inclure des informations propres au fournisseur dans les appels sortants. Les utilisations
courantes incluent le routage des appels, les codes de facturation, l’identification de l’appelant et le respect d’exigences
spécifiques du fournisseur.

#### Combien d’appels simultanés sont pris en charge ?

Le nombre d’appels simultanés dépend de votre forfait. Les forfaits Enterprise permettent généralement
des volumes plus élevés d’appels simultanés. Lorsque la limite est atteinte, les appelants entrants sont refusés,
sauf si la [mise en file d’attente des appels](/docs/fr/eleven-agents/guides/call-queueing) est activée pour l’agent. Dans ce cas,
ils sont mis en attente avec un son d’attente et connectés dès que de la capacité se libère.

#### Puis-je router conditionnellement les appels vers différents agents ?

Oui. Vous pouvez utiliser les règles de routage de votre système PBX existant pour diriger les appels vers différents numéros de téléphone,
chacun étant connecté à des agents ElevenLabs différents.

#### Dois-je respecter le format avec un + initial lors de l’importation de numéros de téléphone ?

Oui. Le format du numéro de téléphone doit être cohérent entre votre URI SIP et la configuration de votre numéro de téléphone
importé. Si vous appelez l’URI SIP avec un + initial (par exemple,
`sip:+19991234567@sip.rtc.elevenlabs.io:5060`), vous devez également importer le numéro de téléphone avec le

* initial (par exemple, `+19991234567`). De même, si vous appelez sans le + initial, importez le numéro de téléphone
  sans celui-ci. Des formats non concordants empêcheront le bon routage des appels.

#### Prenez-vous en charge les recherches d’enregistrements SRV pour SIP ?

Oui. ElevenLabs fournit des enregistrements NAPTR et SRV pour la découverte de serveurs SIP conforme à la RFC 3263.

## Étapes suivantes

* [Référence SIP : glossaire des termes SIP et réseau](/docs/fr/eleven-agents/phone-numbers/sip-reference)
* [Découvrez comment concevoir des agents ElevenLabs](/docs/fr/eleven-agents/quickstart)