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 ElevenLabs Plateforme Agents et le SDK @elevenlabs/react, vous pouvez intégrer un agent vocal du Père Noël dans votre application React en quelques minutes. Dans ce guide, nous allons :
- Créer un agent Père Noël dans le tableau de bord ElevenLabs
- Le connecter dans un composant React avec WebRTC
- Ajouter un bouton simple “Appeler le Père Noël”
1. Inscrivez-vous et ouvrez la plateforme Agents
- Inscrivez-vous / connectez-vous à ElevenLabs.
- Dans la barre latérale à gauche, ouvrez le sélecteur de plateforme en haut.
- Sélectionnez Plateforme Agents.
Vous devriez voir une barre latérale avec Agents, Base de connaissances, Outils, et Voix dans la section « Build ».
2. Créez votre agent Père Noël
Ensuite, nous allons 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 + Nouvel agent.
- Sélectionnez Agent vierge pour partir de zéro.
Nommez-le : Père Noël.
Invite système
Dans le champ Invite système , collez ce qui suit :
Premier message
Définissez Premier message sur :
Ho, ho, ho ! Joyeux Noël, mon ami. Dis-moi, comment tu t’appelles ?
C’est ce que les utilisateurs entendront au début de l’appel.
Voix
Dans la section Voix :
- Sélectionnez « Jerry B. – Santa Claus »
- ID de la voix :
MDLAMJ0jxkpYkjXbmG4t
Maintenant, le Père Noël va vraiment sonner comme le Père Noël.
Sécurité
Pour cet exemple, nous allons laisser l’accès ouvert :
- Dans Sécurité , vérifiez que Activer l’authentification est désactivé.
Pour une première démo, il est tout à fait possible de laisser Activer l’authentification désactivé pour que tout le monde puisse se connecter à l’agent sans restriction. Cela accélère la prise en main et c’est idéal pour des prototypes rapides, des hackathons ou des démonstrations internes.
En revanche, pour toute application en production ou accessible à l’extérieur, vous ne devez jamais laisser votre agent ouvert. Utilisez plutôt le Point de terminaison du jeton d’ElevenLabs pour générer des jetons d’accès temporaires et limités pour chaque session utilisateur. Cela vous permet de garder le contrôle sur qui se connecte, combien de temps l’accès dure et ce que l’utilisateur peut faire. Activer l’authentification protège votre agent contre les appels non autorisés, les abus ou une utilisation hors de vos limites prévues — c’est fortement recommandé avant toute mise en ligne.
3. Récupérez l’ID de votre agent
En haut de la page de l’agent, vous verrez un champ ID de l'agent.
Notez cette valeur — nous la collerons dans notre composant React à l’étape suivante :
4. Installez le SDK React
Dans votre projet React / Next.js, installez le SDK React ElevenLabs :
Avec ça en place, nous pouvons utiliser le hook utiliserConversation 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, et collez ce code :
Ensuite, remplacez "<AGENT_ID>" par l’ID réel de l’agent que vous avez copié depuis le tableau de bord.
Puis affichez le bouton où vous voulez dans votre interface, par exemple :
6. Testez
Ouvrez dans votre navigateur et cliquez sur Démarrer l’appel:
- Votre navigateur va demander l’autorisation du micro.
- Une session WebRTC démarre avec votre agent Père Noël.
- Vous entendrez :
« Ho, ho, ho ! Joyeux Noël, mon ami. Dis-moi, comment tu t’appelles ? »
Ensuite, le Père Noël vous demandera votre prénom, votre liste de souhaits et ce que vous avez fait cette année pour rester sur la liste des gentils.
Où aller ensuite
Une fois que tout fonctionne, vous pouvez :
- Protéger l’accès au Père Noël via les paramètres de sécurité de l’agent
- Changer de langue en passant la langue de l’utilisateur et en laissant l’invite s’en charger
- Personnaliser l’interface avec des boutons, animations ou un écran « Appeler le Père Noël » complet
Mais l’intégration de base, c’est simplement :
- Un agent dans la Plateforme Agents
- Un
identifiantAgent - Un hook
utiliserConversationet un bouton
C’est tout ce qu’il vous faut pour ajouter la magie du Père Noël en temps réel dans votre application React.


.webp&w=3840&q=80)
.webp&w=3840&q=80)
