> 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. # Intégration native Twilio ## Présentation Ce guide explique comment connecter un numéro de téléphone Twilio à votre agent ElevenLabs afin de gérer les appels entrants et sortants. Vous apprendrez à : * Importer un numéro de téléphone Twilio existant. * L’associer à votre agent pour gérer les appels entrants. * Lancer des appels sortants avec votre agent. ## Types et capacités des numéros de téléphone ElevenLabs prend en charge deux types de numéros de téléphone Twilio aux capacités différentes : ### Numéros Twilio achetés (prise en charge complète) * **Appels entrants** : pris en charge, peuvent recevoir des appels et les acheminer vers des agents * **Appels sortants** : pris en charge, peuvent passer des appels avec des agents * **Exigences** : le numéro doit être acheté via Twilio et apparaître dans votre section « Phone Numbers » ### Identifiants d’appelant vérifiés (sortants uniquement) * **Appels entrants** : non pris en charge, ne peuvent pas recevoir d’appels ni être attribués à des agents * **Appels sortants** : pris en charge, peuvent passer des appels avec des agents * **Exigences** : le numéro doit être vérifié dans la section « Verified Caller IDs » de Twilio * **Cas d’utilisation** : idéal pour utiliser votre numéro professionnel existant pour des appels IA sortants Pour en savoir plus, consultez la documentation Twilio sur la [vérification d’identifiants d’appelant à grande échelle](https://www.twilio.com/docs/voice/api/verifying-caller-ids-scale). > **Note** > > Lors de l’importation d’un numéro de téléphone, ElevenLabs détecte automatiquement les capacités de votre numéro selon > sa configuration dans Twilio. ## Guide ### Prérequis * Un [compte Twilio](https://twilio.com/). * Soit : * Un [numéro de téléphone](https://www.twilio.com/docs/phone-numbers) Twilio acheté et provisionné (pour les appels entrants et sortants) * OU un [identifiant d’appelant vérifié](https://www.twilio.com/docs/voice/make-calls#verify-your-caller-id) dans Twilio (pour les appels sortants uniquement) #### Importer un numéro de téléphone Twilio Dans le Dashboard ElevenAgents, accédez à l’onglet [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers). ![Page des numéros de téléphone ElevenAgents](/docs/_fern-img/7efb681147acd8f04803f84ed7f3289f0e90eb1fb0173e2a825836408cee89d1.webp) Renseignez ensuite les informations suivantes : * **Libellé :** un nom descriptif (par exemple, `Ligne d’assistance client`). * **Numéro de téléphone :** le numéro Twilio que vous souhaitez utiliser. * **SID Twilio :** votre SID de compte Twilio ou votre SID de clé API. * **Jeton Twilio :** votre jeton d’authentification Twilio ou le secret de votre clé API. > **Tip** > > **Recommandation : utilisez des clés API pour une sécurité renforcée.** Au lieu d’utiliser les identifiants de l’ensemble de votre compte, vous pouvez [créer une clé API Twilio](https://www.twilio.com/docs/iam/api-keys) avec des autorisations limitées. Lorsque vous créez une clé API, Twilio fournit un **SID** (commençant par `SK`) et un **secret** : utilisez-les dans les champs ci-dessus. > **Note** > > Vous trouverez le SID de votre compte et votre jeton d’authentification [**dans la console d’administration Twilio**](https://www.twilio.com/console), ou pourrez créer des clés API dans la [section des clés API](https://www.twilio.com/console/project/api-keys). #### Dashboard ElevenAgents ![Configuration du numéro de téléphone](/docs/_fern-img/9501110d58bfeca27cb9983bc44035864504bdc2ed9c78d9decbd04802f64418.webp) #### Console d’administration Twilio Copiez le SID Twilio et le jeton d’authentification depuis la [console d’administration Twilio](https://www.twilio.com/console). ![Détails du numéro de téléphone](/docs/_fern-img/42da512d1cdfb4ca4504c3162fecfed108580d9488236a0cc6a4a1d23a19da14.webp) > **Note** > > ElevenLabs configure automatiquement le numéro de téléphone Twilio avec les paramètres appropriés. #### Paramètres appliqués ![Configuration du numéro de téléphone Twilio](/docs/_fern-img/b11d57a0aa588964bbd0117d2135c55592569a4bf051f00f17aa3ee632833a47.webp) > **Info** > > **Détection du numéro de téléphone** : ElevenLabs détecte automatiquement si votre numéro prend en charge : > > * **Entrants et sortants** : numéros achetés via Twilio > * **Sortants uniquement** : numéros vérifiés comme identifiants d’appelant dans Twilio > > Si votre numéro n’est trouvé dans aucune de ces catégories, vous recevrez une erreur vous demandant de vérifier qu’il existe dans votre compte Twilio. #### Attribuer votre agent (numéros prenant en charge les appels entrants uniquement) Si votre numéro de téléphone prend en charge les appels entrants, vous pouvez attribuer un agent pour gérer les appels reçus. ![Sélectionner un agent pour les appels entrants](/docs/_fern-img/b85c122ef8607527041516e789b0a19047cbf85a13cd3237ee5a7670683815a7.webp) > **Note** > > Les numéros qui prennent uniquement en charge les appels sortants (identifiants d’appelant vérifiés) ne peuvent pas être attribués à des agents et > apparaissent comme désactivés dans le menu déroulant des agents. Testez l’agent en appelant le numéro de téléphone. Votre agent est désormais prêt à gérer les appels entrants et à échanger avec vos clients. > **Tip** > > Suivez vos premiers appels dans le [Dashboard de l’historique des appels](https://elevenlabs.io/app/agents/history) pour vérifier que tout fonctionne comme prévu. ## Passer des appels sortants > **Info** > > Les numéros Twilio achetés comme les identifiants d’appelant vérifiés peuvent être utilisés pour les appels sortants. Le bouton d’appel > sortant est désactivé pour les numéros qui ne prennent pas en charge les appels sortants. Votre numéro de téléphone Twilio importé peut également servir à lancer des appels sortants, lors desquels votre agent appelle un numéro de téléphone indiqué. #### Lancer un appel sortant Dans l’onglet [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers), repérez votre numéro Twilio importé et cliquez sur le bouton **Outbound call**. ![Bouton d’appel sortant](/docs/_fern-img/953a870b0ab0c0aa30872b3692260f0879f390d4b4b83c7f82e816385504034f.webp) #### Configurer l’appel Dans la fenêtre modale Outbound Call : 1. Sélectionnez l’agent qui gérera la conversation 2. Saisissez le numéro de téléphone à appeler 3. Cliquez sur **Send Test Call** pour lancer l’appel ![Configuration de l’appel sortant](/docs/_fern-img/f6b01412a68217661028e6924ce90089bdd5eaa693c8aeafbc321c632de921b7.webp) Une fois lancé, le destinataire reçoit un appel depuis votre numéro Twilio. Lorsqu’il répond, votre agent démarre la conversation. > **Tip** > > Les appels sortants apparaissent dans votre [Dashboard de l’historique des appels](https://elevenlabs.io/app/agents/history) > avec les appels entrants, ce qui vous permet de consulter toutes les conversations. > **Note** > > Lors des appels sortants, votre agent lance la conversation. Assurez-vous donc que les premiers messages de votre > agent sont configurés de façon à démarrer efficacement la conversation.