Aggiungi un Agente Voce di Babbo Natale alla tua app React in pochi minuti
- Pubblicato
AscoltaAscolta questo articolo
Durante queste feste, aggiungi Babbo Natale alla tua app.
Con Agents Platform di ElevenLabs e l'SDK @elevenlabs/react, puoi integrare un agente vocale di Babbo Natale nella tua app React in pochi minuti. In questa guida:
- Crea un agente di Babbo Natale nella dashboard di ElevenLabs
- Collegalo a un componente React con WebRTC
- Aggiungi un semplice pulsante “Chiama Babbo Natale”
1. Registrati e apri Agents Platform
- Registrati / accedi a ElevenLabs.
- Nella barra laterale sinistra, apri il selettore della piattaforma in alto.
- Scegli Agents Platform.
Vedrai una barra laterale con Agenti, Knowledge Base, Strumenti e Voci nella sezione “Crea”.
2. Crea il tuo agente di Babbo Natale
Ora creeremo un agente che si comporta come Babbo Natale e parla con la sua voce.
- Nella barra laterale, fai clic su Agenti.
- Fai clic su + Nuovo agente.
- Scegli Agente vuoto per iniziare da zero.
Assegnagli il nome: Santa.
Prompt di sistema
Nel campo Prompt di sistema, incolla quanto segue:
Primo messaggio
Imposta Primo messaggio su:
Ho, ho, ho! Buon Natale, amico mio. Dimmi, come ti chiami?
È ciò che gli utenti sentiranno all'inizio della chiamata.
Voce
Nella sezione Voce:
- Scegli “Jerry B. – Babbo Natale”
- ID della voce:
MDLAMJ0jxkpYkjXbmG4t
Ora Babbo Natale suonerà davvero come Babbo Natale.
Sicurezza
Per questo esempio, lo lasceremo aperto:
- In Sicurezza, assicurati che Abilita autenticazione sia disattivato.
Per la tua prima demo, puoi tranquillamente lasciare Abilita autenticazione disattivato, così chiunque potrà connettersi all'agente senza restrizioni. Questo rende l'onboarding più rapido ed è ideale per prototipi veloci, progetti di hackathon o presentazioni interne.
Tuttavia, per qualsiasi applicazione in produzione o accessibile dall'esterno, non dovresti mai lasciare aperto il tuo agente. Usa invece il Token Endpoint di ElevenLabs per generare token di accesso con ambito definito e di breve durata per ogni sessione utente. In questo modo mantieni il pieno controllo su chi può connettersi, sulla durata dell'accesso e sulle azioni che l'utente può eseguire. Abilitare l'autenticazione protegge il tuo agente da chiamate non autorizzate, abusi o utilizzi oltre i limiti previsti — ed è fortemente consigliato prima della pubblicazione.
3. Recupera l'ID dell'agente
In alto nella pagina dell'agente, vedrai un campo ID dell'agente.
Prendi nota di questo valore — lo inseriremo in un componente React in un passaggio successivo:
4. Installa l'SDK React
Nel tuo progetto React / Next.js, installa l'SDK React di ElevenLabs:
A questo punto, possiamo usare l'hook useConversation per avviare e terminare le chiamate vocali.
5. Aggiungi il pulsante "Chiama Babbo Natale"
Crea un nuovo componente, ad esempio CallSantaButton.tsx, e incolla questo codice:
Ora sostituisci "<AGENT_ID>" con l'ID dell'agente effettivo che hai copiato dalla dashboard.
Poi visualizza il pulsante in un punto della tua UI, ad esempio:
6. Provalo
Apri l'app nel browser e fai clic su Avvia chiamata:
- Il browser ti chiederà l'autorizzazione per il microfono.
- Viene avviata una sessione WebRTC con il tuo agente di Babbo Natale.
- Sentirai:
“Ho, ho, ho! Buon Natale, amico mio. Dimmi, come ti chiami?”
Da lì, Babbo Natale ti chiederà il tuo nome, la lista dei desideri e cosa hai fatto quest'anno per restare nella Lista dei Buoni.
Prossimi passi
Una volta che le basi funzionano, puoi:
- Proteggere Babbo Natale con l'autenticazione usando le impostazioni di sicurezza dell'agente
- Cambiare lingua passando la lingua dell'utente e lasciando che il prompt la gestisca
- Personalizzare la UI con pulsanti personalizzati, animazioni o una schermata completa “Chiama Babbo Natale”
Ma l'integrazione essenziale è semplicemente:
- Un agente nella Agents Platform
- Un
agentId - Un hook
useConversatione un pulsante
È tutto ciò che ti serve per portare la magia conversazionale di Babbo Natale in tempo reale nella tua app React.



