Lägg till en tomteröst-agent i din React-app på några minuter
- Publicerad
LyssnaLyssna på den här artikeln
Låt tomten flytta in i din app i jul.
Med ElevenLabs Agentsplattform och @elevenlabs/react SDK kan du lägga till en tomteröst-agent i din React-app på bara några minuter. I den här guiden kommer vi att:
- Skapa en tomte-agent i ElevenLabs dashboard
- Koppla ihop den i en React-komponent med WebRTC
- Lägga till en enkel “Ring tomten”-knapp
1. Skapa konto och öppna Agents Platform
- Registrera dig / logga in på ElevenLabs.
- I vänstermenyn, öppna plattformsväljaren högst upp.
- Välj Agentsplattform.
Du ska nu se en sidomeny med Agenter, Kunskapsbas, Verktyg, och Röster under avsnittet “Build”.
2. Skapa din tomte-agent
Nu skapar vi en agent som beter sig som tomten och pratar med tomteröst.
- I sidomenyn, klicka på Agenter.
- Klicka på + Ny agent.
- Välj Tom agent för att börja från början.
Döp den till: Tomten.
Systemprompt
I fältet Systemprompt klistrar du in följande:
Första meddelande
Ställ in Första meddelandet till:
Ho, ho, ho! God jul, min vän. Vad heter du?
Det här är vad användarna hör när samtalet startar.
Röst
I avsnittet Röst:
- Välj “Jerry B. – Jultomten”
- Röst-ID:
MDLAMJ0jxkpYkjXbmG4t
Nu kommer tomten faktiskt att låta som tomten.
Säkerhet
I det här exemplet låter vi det vara öppet:
- Under Säkerhet, se till att Aktivera autentisering är av.
För din första demo går det utmärkt att lämna Aktivera autentisering avstängt så att vem som helst kan ansluta till agenten utan begränsningar. Det gör det snabbare att komma igång och passar bra för snabba prototyper, hackathons eller interna demo.
Men för alla produktion eller publika applikationer ska du aldrig lämna din agent öppen. Använd istället ElevenLabs Token-endpoint för att skapa tillfälliga, begränsade access tokens för varje användarsession. Då har du full kontroll över vem som kan ansluta, hur länge och vad användaren får göra. Att aktivera autentisering skyddar din agent mot obehöriga samtal, missbruk eller användning utanför dina gränser — och rekommenderas starkt innan du går live.
3. Hämta din Agent ID
Högst upp på agent-sidan ser du ett fält för Agent-ID.
Spara det här värdet — vi klistrar in det i vår React-komponent senare:
4. Installera React SDK
I ditt React- eller Next.js-projekt, installera ElevenLabs React SDK:
Nu kan vi använda useConversation-hooken för att starta och stoppa röstsamtal.
5. Lägg till knappen "Ring tomten"
Skapa en ny komponent, t.ex. CallSantaButton.tsx, och klistra in den här koden:
Nu ska du ersätta "<AGENT_ID>" med det faktiska Agent ID du kopierade från dashboarden.
Rendera sedan knappen någonstans i din UI, till exempel:
6. Testa
Öppna i webbläsaren och klicka på Starta samtal:
- Din webbläsare kommer att be om mikrofontillstånd.
- En WebRTC-session startar med din tomte-agent.
- Du hör:
“Ho, ho, ho! God jul, min vän. Vad heter du?”
Därefter frågar tomten efter ditt namn, önskelista och vad du gjort i år för att hamna på snälla-listan.
Vad du kan göra härnäst
När grunderna fungerar kan du:
- Skydda tomten med inloggning via agentens säkerhetsinställningar
- Byta språk genom att skicka användarens språk och låta prompten hantera det
- Anpassa UI:t med egna knappar, animationer eller en hel “Ring tomten”-skärm
Men själva integrationen är bara:
- En agent i Agentsplattform
- Ett
agentId - En
useConversation-hook och en knapp
Det är allt du behöver för att få in riktig, samtalsbaserad tomtemagi i din React-app.


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