Voeg in enkele minuten een Santa-stemagent toe aan je React-app
- Gepubliceerd
LuisterenLuister naar dit artikel
Voeg deze feestdagen Santa toe aan je app.
Met ElevenLabs Agents Platform en de @elevenlabs/react SDK kun je in slechts enkele minuten een Santa Claus-stemagent toevoegen aan je React-app. In deze handleiding gaan we:
- Een Santa Agent maken in het ElevenLabs-dashboard
- Deze koppelen in een React-component met WebRTC
- Een eenvoudige knop ‘Bel Santa’ toevoegen
1. Registreren en het Agents Platform openen
- Registreer je / log in bij ElevenLabs.
- Open bovenaan in de linkerzijbalk de platform switcher.
- Kies Agents Platform.
Je ziet een zijbalk met Agents, Knowledge Base, Tools en Voices onder het gedeelte ‘Build’.
2. Je Santa Agent maken
Vervolgens maken we een agent die zich gedraagt als Santa en spreekt met een Santa-stem.
- Klik in de zijbalk op Agents.
- Klik op + New Agent.
- Kies Blank Agent om vanaf nul te beginnen.
Noem hem: Santa.
Systeemprompt
Plak het volgende in het veld System Prompt:
Eerste bericht
Stel First Message in op:
Ho, ho, ho! Vrolijk kerstfeest, mijn vriend. Vertel eens, hoe heet je?
Dit horen gebruikers wanneer het gesprek begint.
Stem
In het gedeelte Voice:
- Kies ‘Jerry B. – Santa Claus’
- Stem-ID:
MDLAMJ0jxkpYkjXbmG4t
Nu klinkt Santa ook echt als Santa.
Beveiliging
Voor dit voorbeeld laten we de toegang open:
- Controleer onder Security of Enable authentication is uitgeschakeld.
Voor je eerste demo kun je Enable Authentication gerust uitgeschakeld laten, zodat iedereen zonder beperkingen verbinding kan maken met de Agent. Dit versnelt onboarding en is ideaal voor snelle prototypes, hackathonprojecten of interne presentaties.
Voor elke productie- of extern toegankelijke applicatie mag je je Agent echter nooit open laten staan. Gebruik in plaats daarvan de ElevenLabs Token Endpoint om kortdurende, afgebakende toegangstokens voor elke gebruikerssessie te genereren. Zo houd je volledige controle over wie verbinding kan maken, hoelang de toegang duurt en welke acties de gebruiker mag uitvoeren. Door authenticatie in te schakelen bescherm je je Agent tegen ongeautoriseerde gesprekken, misbruik of gebruik buiten je beoogde limieten — en dat wordt sterk aanbevolen voordat je live gaat.
3. Je Agent ID ophalen
Bovenaan de Agent-pagina zie je een veld Agent ID.
Noteer deze waarde — in een latere stap plakken we deze in onze React-component:
4. De React SDK installeren
Installeer de ElevenLabs React SDK in je React- / Next.js-project:
Daarna kunnen we de useConversation hook gebruiken om spraakgesprekken te starten en te stoppen.
5. De knop ‘Bel Santa’ toevoegen
Maak een nieuwe component, bijvoorbeeld CallSantaButton.tsx, en plak deze code:
Vervang "<AGENT_ID>" nu door de daadwerkelijke Agent ID die je uit het dashboard hebt gekopieerd.
Render de knop vervolgens ergens in je UI, bijvoorbeeld:
6. Probeer het
Open het in je browser en klik op Start Call:
- Je browser vraagt om microfoonrechten.
- Er wordt een WebRTC-sessie gestart met je Santa Agent.
- Je hoort:
‘Ho, ho, ho! Vrolijk kerstfeest, mijn vriend. Vertel eens, hoe heet je?’
Daarna vraagt Santa naar je naam, verlanglijstje en wat je dit jaar hebt gedaan om op de Nice List te blijven.
Volgende stappen
Zodra de basis werkt, kun je:
- De toegang tot Santa beperken met de beveiligingsinstellingen van de Agent
- Van taal wisselen door de gebruikerslocale door te geven en dit door de prompt te laten afhandelen
- De UI vormgeven met aangepaste knoppen, animaties of een volledig scherm ‘Bel Santa’
Maar de kern van de integratie bestaat alleen uit:
- Eén Agent in het Agents Platform
- Eén
agentId - Een
useConversationhook en een knop
Dat is alles wat je nodig hebt om realtime, conversationele Santa-magie naar je React-app te brengen.



