Fügen Sie Ihrer React-App in wenigen Minuten einen Santa-Stimmenagenten hinzu
- Veröffentlicht
AnhörenArtikel anhören
Fügen Sie Ihrer App in dieser Weihnachtszeit den Weihnachtsmann hinzu.
Mit der ElevenLabs Agents Platform und dem @elevenlabs/react SDK können Sie einen Weihnachtsmann-Voice Agent in wenigen Minuten in Ihre React-App einbinden. In dieser Anleitung:
- Erstellen Sie einen Weihnachtsmann-Agent im ElevenLabs-Dashboard
- Binden Sie ihn per WebRTC in eine React-Komponente ein
- Fügen Sie eine einfache Schaltfläche „Santa anrufen“ hinzu
1. Registrieren und die Agents Platform öffnen
- Registrieren Sie sich / melden Sie sich an bei ElevenLabs.
- Öffnen Sie in der linken Seitenleiste oben den Platform Switcher.
- Wählen Sie Agents Platform aus.
Darunter sehen Sie in der Seitenleiste im Bereich „Build“ Agents, Knowledge Base, Tools und Voices.
2. Weihnachtsmann-Agent erstellen
Als Nächstes erstellen wir einen Agent, der sich wie der Weihnachtsmann verhält und mit einer Weihnachtsmann-Stimme spricht.
- Klicken Sie in der Seitenleiste auf Agents.
- Klicken Sie auf + New Agent.
- Wählen Sie Blank Agent aus, um von Grund auf zu beginnen.
Nennen Sie ihn: Santa.
System Prompt
Fügen Sie im Feld System Prompt Folgendes ein:
Erste Nachricht
Setzen Sie First Message auf:
Ho, ho, ho! Frohe Weihnachten, mein Freund. Wie heißt du?
Das hören Nutzer, wenn der Anruf beginnt.
Stimme
Im Bereich Voice:
- Wählen Sie „Jerry B. – Santa Claus“
- Stimm-ID:
MDLAMJ0jxkpYkjXbmG4t
Jetzt klingt Santa auch wirklich wie der Weihnachtsmann.
Sicherheit
Für dieses Beispiel lassen wir den Zugriff offen:
- Stellen Sie unter Security sicher, dass Enable authentication deaktiviert ist.
Für Ihre erste Demo können Sie Enable Authentication problemlos deaktiviert lassen, damit sich jeder ohne Einschränkungen mit dem Agent verbinden kann. Das beschleunigt das Onboarding und eignet sich ideal für schnelle Prototypen, Hackathon-Projekte oder interne Präsentationen.
Bei jeder Produktiv- oder extern zugänglichen Anwendung sollten Sie Ihren Agent jedoch nie offen lassen. Nutzen Sie stattdessen den ElevenLabs-Token Endpoint, um für jede Nutzersitzung kurzlebige Zugriffstokens mit begrenztem Geltungsbereich zu erstellen. So behalten Sie die volle Kontrolle darüber, wer sich verbinden kann, wie lange der Zugriff besteht und welche Aktionen Nutzer ausführen dürfen. Die aktivierte Authentifizierung schützt Ihren Agent vor unbefugten Anrufen, Missbrauch und Nutzung außerhalb Ihrer vorgesehenen Grenzen — und wird vor dem Livegang dringend empfohlen.
3. Agent-ID abrufen
Oben auf der Agent-Seite sehen Sie ein Feld für die Agent ID.
Notieren Sie sich diesen Wert — wir fügen ihn in einem späteren Schritt in unsere React-Komponente ein:
4. React SDK installieren
Installieren Sie in Ihrem React-/Next.js-Projekt das ElevenLabs React SDK:
Danach können wir den useConversation Hook verwenden, um Voice-Anrufe zu starten und zu beenden.
5. Schaltfläche „Santa anrufen“ hinzufügen
Erstellen Sie eine neue Komponente, z. B. CallSantaButton.tsx, und fügen Sie diesen Code ein:
Ersetzen Sie jetzt "<AGENT_ID>" durch die tatsächliche Agent-ID, die Sie aus dem Dashboard kopiert haben.
Rendern Sie die Schaltfläche dann an einer Stelle in Ihrer UI, zum Beispiel:
6. Ausprobieren
Öffnen Sie die App in Ihrem Browser und klicken Sie auf Start Call:
- Ihr Browser fragt nach der Mikrofonberechtigung.
- Eine WebRTC-Sitzung mit Ihrem Weihnachtsmann-Agent startet.
- Sie hören:
„Ho, ho, ho! Frohe Weihnachten, mein Freund. Wie heißt du?“
Danach fragt Santa nach Ihrem Namen, Ihrer Wunschliste und danach, was Sie dieses Jahr getan haben, um auf der Liste der braven Kinder zu bleiben.
Nächste Schritte
Sobald die Grundlagen funktionieren, können Sie:
- Santa durch Authentifizierung schützen – über die Sicherheitseinstellungen des Agent
- Sprachen wechseln – indem Sie das Nutzergebietsschema übergeben und den Prompt den Rest erledigen lassen
- Die UI gestalten – mit benutzerdefinierten Schaltflächen, Animationen oder einem vollständigen Bildschirm „Santa anrufen“
Die Kernintegration besteht jedoch nur aus:
- Einem Agent in der Agents Platform
- Einer
agentId - Einem
useConversationHook und einer Schaltfläche
Das ist alles, was Sie brauchen, um echte Weihnachtsmann-Magie in Echtzeit und als Gespräch in Ihre React-App zu bringen.



