Lägg till en tomteröst-agent i din React-app på några minuter
- Publicerad
LyssnaLyssna på den här artikeln
Den här julen kan du lägga till tomten i din app.
Med ElevenLabs Agents Platform och @elevenlabs/react-SDK:t kan du lägga till en tomte röstagent i din React-app på bara några minuter. I den här guiden ska vi:
- Skapa en tomteagent i ElevenLabs kontrollpanel
- Koppla den till en React-komponent med WebRTC
- Lägga till en enkel knapp för ”Ring tomten”
1. Registrera dig och öppna Agents Platform
- Registrera dig / logga in på ElevenLabs.
- Öppna plattformsväxlaren högst upp i vänster sidofält.
- Välj Agents Platform.
Du bör se ett sidofält med Agents, Knowledge Base, Tools och Voices under avsnittet ”Build”.
2. Skapa din tomteagent
Nu skapar vi en agent som beter sig som tomten och talar med en tomteröst.
- Klicka på Agents i sidofältet.
- Klicka på + New Agent.
- Välj Blank Agent för att börja från grunden.
Namnge den till Santa.
Systemprompt
Klistra in följande i fältet System Prompt:
Första meddelandet
Ställ in First Message på:
Ho, ho, ho! God jul, min vän. Säg mig, vad heter du?
Det här är vad användarna hör när samtalet startar.
Röst
I avsnittet Voice:
- Välj ”Jerry B. – Santa Claus”
- Röst-ID:
MDLAMJ0jxkpYkjXbmG4t
Nu kommer tomten faktiskt att låta som tomten.
Säkerhet
I det här exemplet lämnar vi den öppen:
- Under Security kontrollerar du att Enable authentication är av.
För din första demo går det bra att lämna Enable Authentication avstängt, så att vem som helst kan ansluta till agenten utan begränsningar. Det gör onboarding snabbare och passar bra för snabba prototyper, hackathonprojekt eller interna presentationer.
Men för alla produktions- eller externt tillgängliga appar bör du aldrig lämna agenten öppen. Använd i stället ElevenLabs Token Endpoint för att skapa kortlivade åtkomsttoken med begränsad behörighet för varje användarsession. Då behåller du full kontroll över vem som kan ansluta, hur länge åtkomsten gäller och vilka åtgärder användaren får utföra. När du aktiverar autentisering skyddar du agenten mot obehöriga samtal, missbruk och användning utanför dina avsedda gränser — och det rekommenderas starkt innan du går live.
3. Hämta ditt agent-ID
Längst upp på agentsidan ser du ett fält för Agent ID.
Notera det här värdet — vi klistrar in det i vår React-komponent i ett senare steg:
4. Installera React SDK:t
Installera ElevenLabs React SDK i ditt React-/Next.js-projekt:
När det är klart kan vi använda hooken useConversation för att starta och avsluta röstsamtal.
5. Lägg till knappen ”Ring tomten”
Skapa en ny komponent, till exempel CallSantaButton.tsx, och klistra in den här koden:
Byt nu ut "<AGENT_ID>" mot det faktiska agent-ID:t som du kopierade från kontrollpanelen.
Rendera sedan knappen någonstans i ditt UI, till exempel:
6. Prova själv
Öppna sidan i webbläsaren och klicka på Start Call:
- Webbläsaren ber om behörighet till mikrofonen.
- En WebRTC-session startar med din tomteagent.
- Du hör:
”Ho, ho, ho! God jul, min vän. Säg mig, vad heter du?”
Därefter frågar tomten efter ditt namn, din önskelista och vad du har gjort i år för att hamna på snällistan.
Nästa steg
När grunderna fungerar kan du:
- Skydda tomten med autentisering med agentens säkerhetsinställningar
- Byta språk genom att skicka användarens språkversion och låta prompten hantera det
- Anpassa UI:t med egna knappar, animationer eller en komplett skärm för ”Ring tomten”
Men själva kärnintegrationen är bara:
- En agent i Agents Platform
- Ett
agentId - En
useConversation-hook och en knapp
Det är allt du behöver för att få in tomtemagi i realtid med naturliga samtal i din React-app.



