Fügen Sie Ihrer React-App in wenigen Minuten einen Santa-Stimmenagenten hinzu
- Veröffentlicht
AnhörenArtikel anhören
Bringen Sie in dieser Weihnachtszeit Santa in Ihre App.
Mit ElevenLabs Agents-Plattform und dem @elevenlabs/react SDK können Sie in wenigen Minuten einen Santa-Stimmenagenten in Ihre React-App integrieren. In dieser Anleitung werden wir:
- Einen Santa-Agenten im ElevenLabs-Dashboard erstellen
- In einer React-Komponente mit WebRTC verbinden
- Einen einfachen „Santa anrufen“-Button hinzufügen
1. Registrieren und Agents Platform öffnen
- Registrieren / Anmelden bei ElevenLabs.
- Öffnen Sie in der linken Seitenleiste den Plattform-Umschalter oben.
- Wählen Sie Agents-Plattform.
Sie sehen nun eine Seitenleiste mit Agenten, Wissensdatenbank, Tools und Stimmen im Bereich „Build“.
2. Santa-Agenten erstellen
Jetzt erstellen wir einen Agenten, der sich wie Santa verhält und mit Santa-Stimme spricht.
- Klicken Sie in der Seitenleiste auf Agenten.
- Klicken Sie auf + Neuer Agent.
- Wählen Sie Leerer Agent, um von Grund auf zu starten.
Nennen Sie ihn: Santa.
System-Prompt
Im Feld System-Prompt fügen Sie Folgendes ein:
Erste Nachricht
Setzen Sie Erste Nachricht auf:
Ho, ho, ho! Frohe Weihnachten, mein Freund. Wie ist Ihr Name?
Das hören Nutzer, wenn der Anruf startet.
Stimme
Im Bereich Stimme:
- Wählen Sie „Jerry B. – Santa Claus“
- Stimmen-ID:
MDLAMJ0jxkpYkjXbmG4t
Jetzt klingt Santa tatsächlich wie Santa.
Sicherheit
Für dieses Beispiel lassen wir es offen:
- Unter Sicherheit stellen Sie sicher, dass Authentifizierung aktivieren aus.
Für Ihr erstes Demo ist es völlig in Ordnung, Authentifizierung aktivieren deaktiviert zu lassen, damit jeder ohne Einschränkung eine Verbindung zum Agenten herstellen kann. Das beschleunigt das Onboarding und eignet sich ideal für schnelle Prototypen, Hackathons oder interne Präsentationen.
Für jede Produktivumgebung oder öffentlich zugängliche Anwendung sollten Sie niemals Ihren Agenten offen lassen. Nutzen Sie stattdessen den ElevenLabs Token-Endpunkt, um für jede Sitzung kurzlebige, eingeschränkte Zugriffstoken zu generieren. So behalten Sie die volle Kontrolle darüber, wer sich verbindet, wie lange der Zugriff gilt und welche Aktionen erlaubt sind. Die Aktivierung der Authentifizierung schützt Ihren Agenten vor unbefugten Anrufen, Missbrauch oder Nutzung außerhalb Ihrer Vorgaben – und wird vor dem Live-Gang dringend empfohlen.
3. Agent-ID kopieren
Oben auf der Agent-Seite finden Sie das Feld Agenten-ID.
Notieren Sie diesen Wert – wir fügen ihn später in unsere React-Komponente ein:
4. React SDK installieren
Installieren Sie das ElevenLabs React SDK in Ihrem React- oder Next.js-Projekt:
Damit können wir den useConversation-Hook nutzen, um Sprach-Anrufe zu starten und zu beenden.
5. „Santa anrufen“-Button hinzufügen
Erstellen Sie eine neue Komponente, z. B. CallSantaButton.tsx, und fügen Sie diesen Code ein:
Jetzt ersetzen Sie "<AGENT_ID>" durch die Agent-ID, die Sie aus dem Dashboard kopiert haben.
Rendern Sie dann den Button an einer beliebigen Stelle in Ihrem UI, zum Beispiel:
6. Testen
Öffnen Sie die App im Browser und klicken Sie auf Anruf starten:
- Ihr Browser fragt nach Mikrofonberechtigung.
- Eine WebRTC-Sitzung mit Ihrem Santa-Agenten startet.
- Sie hören:
„Ho, ho, ho! Frohe Weihnachten, mein Freund. Wie ist Ihr Name?“
Santa fragt dann nach Ihrem Namen, Ihrer Wunschliste und was Sie dieses Jahr getan haben, um auf der Guten-Liste zu bleiben.
Wie geht es weiter?
Wenn die Grundlagen funktionieren, können Sie:
- Santa mit Authentifizierung absichern über die Sicherheitseinstellungen des Agenten
- Sprache wechseln indem Sie die Nutzer-Lokalisierung übergeben und das Prompt anpassen
- UI anpassen mit eigenen Buttons, Animationen oder einem vollständigen „Santa anrufen“-Screen
Die Kernintegration besteht nur aus:
- Ein Agent in der Agents-Plattform
- Eine
agentId - Ein
useConversation-Hook und ein Button
Mehr brauchen Sie nicht, um Echtzeit-Gespräche mit Santa in Ihre React-App zu bringen.



