Ajoutez un agent vocal du Père Noël à votre application React en quelques minutes
- Publié
ÉcouterÉcouter cet article
Pour les fêtes, ajoutez le Père Noël à votre application.
Avec la Agents Platform d’ElevenLabs et le SDK @elevenlabs/react, intégrez un agent vocal du Père Noël à votre application React en quelques minutes. Dans ce guide, vous allez :
- Créer un agent Père Noël dans le Dashboard d’ElevenLabs
- L’intégrer à un composant React avec WebRTC
- Ajouter un simple bouton « Appeler le Père Noël »
1. Inscrivez-vous et ouvrez la Agents Platform
- Inscrivez-vous / connectez-vous à ElevenLabs.
- Dans la barre latérale gauche, ouvrez le sélecteur de plateforme situé en haut.
- Sélectionnez Agents Platform.
Vous devriez voir une barre latérale avec Agents, Knowledge Base, Tools et Voices dans la section « Build ».
2. Créez votre agent Père Noël
Nous allons maintenant créer un agent qui se comporte comme le Père Noël et parle avec sa voix.
- Dans la barre latérale, cliquez sur Agents.
- Cliquez sur + New Agent.
- Sélectionnez Blank Agent pour partir de zéro.
Nommez-le : Santa.
Prompt système
Dans le champ System Prompt, collez le texte suivant :
Premier message
Définissez First Message sur :
Ho, ho, ho ! Joyeux Noël, mon ami. Dis-moi, quel est ton prénom ?
C’est ce que les utilisateurs entendront au début de l’appel.
Voix
Dans la section Voice :
- Sélectionnez « Jerry B. – Santa Claus »
- ID de voix :
MDLAMJ0jxkpYkjXbmG4t
Le Père Noël aura alors vraiment la voix du Père Noël.
Sécurité
Pour cet exemple, nous laisserons l’accès ouvert :
- Dans Security, vérifiez que Enable authentication est désactivé.
Pour votre première démo, vous pouvez tout à fait laisser Enable Authentication désactivé afin que tout le monde puisse se connecter à l’agent sans restriction. Cela accélère la prise en main et convient parfaitement aux prototypes rapides, aux projets de hackathon ou aux démonstrations internes.
En revanche, pour toute application en production ou accessible de l’extérieur, vous ne devez jamais laisser votre agent ouvert. Utilisez plutôt le Token Endpoint d’ElevenLabs pour générer des jetons d’accès à durée limitée et à périmètre défini pour chaque session utilisateur. Vous gardez ainsi le contrôle total sur les personnes autorisées à se connecter, la durée de l’accès et les actions que l’utilisateur peut effectuer. L’activation de l’authentification protège votre agent contre les appels non autorisés, les abus et les utilisations en dehors des limites prévues. Elle est vivement recommandée avant la mise en production.
3. Récupérez l’ID de votre agent
En haut de la page de l’agent, vous verrez un champ Agent ID.
Notez cette valeur, vous la collerez dans votre composant React à l’étape suivante :
4. Installez le SDK React
Dans votre projet React / Next.js, installez le SDK React d’ElevenLabs :
Vous pouvez alors utiliser le hook useConversation pour démarrer et arrêter les appels vocaux.
5. Ajoutez le bouton « Appeler le Père Noël »
Créez un nouveau composant, par exemple CallSantaButton.tsx, puis collez ce code :
Remplacez ensuite "<AGENT_ID>" par l’ID réel de l’agent que vous avez copié depuis le Dashboard.
Affichez ensuite le bouton quelque part dans votre interface, par exemple :
6. Essayez
Ouvrez l’application dans votre navigateur et cliquez sur Start Call :
- Votre navigateur demandera l’autorisation d’accéder au microphone.
- Une session WebRTC démarre avec votre agent Père Noël.
- Vous entendrez :
« Ho, ho, ho ! Joyeux Noël, mon ami. Dis-moi, quel est ton prénom ? »
Le Père Noël vous demandera ensuite votre prénom, votre liste de souhaits et ce que vous avez fait cette année pour rester sur la liste des enfants sages.
Pour aller plus loin
Une fois les bases en place, vous pouvez :
- Protéger l’accès au Père Noël par authentification via les paramètres de sécurité de l’agent
- Changer de langue en transmettant la langue de l’utilisateur et en laissant le prompt s’en charger
- Personnaliser l’interface avec des boutons, animations ou un écran complet « Appeler le Père Noël »
Mais l’intégration essentielle se résume à :
- Un agent dans la Agents Platform
- Un
agentId - Un hook
useConversationet un bouton
C’est tout ce dont vous avez besoin pour intégrer la magie conversationnelle du Père Noël en temps réel à votre application React.


