Aggiungi un Agente Voce di Babbo Natale alla tua app React in pochi minuti
- Pubblicato
AscoltaAscolta questo articolo
Per queste feste, aggiungi Babbo Natale alla tua app.
Con ElevenLabs Piattaforma Agents e l’SDK @elevenlabs/react, puoi inserire un agente vocale di Babbo Natale nella tua app React in pochi minuti. In questa guida vedrai come:
- Creare un Agente Babbo Natale nella dashboard di ElevenLabs
- Collegarlo a un componente React usando WebRTC
- Aggiungere un semplice pulsante “Chiama Babbo Natale”
1. Registrati e apri la Agents Platform
- Registrati / accedi a ElevenLabs.
- Nella barra laterale a sinistra, apri il selettore piattaforma in alto.
- Seleziona Piattaforma Agents.
Dovresti vedere una barra laterale con Agent, Knowledge Base, Strumenti e Voci nella sezione “Build”.
2. Crea il tuo Agente Babbo Natale
Ora creiamo un agente che si comporta come Babbo Natale e parla con la sua voce.
- Nella barra laterale, clicca su Agent.
- Clicca su + Nuovo Agente.
- Seleziona Agente Vuoto per partire da zero.
Chiamalo: Babbo Natale.
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?
Questo è ciò che gli utenti sentiranno quando inizia la chiamata.
Voce
Nella sezione Voce:
- Seleziona “Jerry B. – Babbo Natale”
- ID Voce:
MDLAMJ0jxkpYkjXbmG4t
Ora Babbo Natale suonerà davvero come Babbo Natale.
Sicurezza
Per questo esempio, lasciamo tutto aperto:
- Nella sezione Sicurezza, assicurati che Abilita autenticazione sia disattivato.
Per la tua prima demo, va benissimo lasciare Abilita autenticazione disattivato così chiunque può collegarsi all’Agente senza restrizioni. Questo velocizza l’onboarding ed è ideale per prototipi rapidi, hackathon o demo interne.
Tuttavia, per qualsiasi applicazione in produzione o accessibile dall’esterno, non dovresti mai lasciare il tuo Agente aperto. Usa invece l’Endpoint token di ElevenLabs per generare token di accesso temporanei e limitati per ogni sessione utente. In questo modo hai il pieno controllo su chi può collegarsi, per quanto tempo e quali azioni può eseguire. Abilitare l’autenticazione protegge il tuo Agente da chiamate non autorizzate, abusi o utilizzi fuori dai limiti previsti — ed è fortemente consigliato prima di andare live.
3. Recupera l’ID dell’Agente
In alto nella pagina dell’Agente, vedrai un campo ID dell’Agente.
Annota questo valore — lo incolleremo nel nostro componente React in uno dei prossimi passaggi:
4. Installa l’SDK React
Nel tuo progetto React / Next.js, installa l’SDK React di ElevenLabs:
A questo punto puoi 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 che hai copiato dalla dashboard.
Poi inserisci il pulsante dove preferisci nella tua UI, ad esempio:
6. Provalo
Apri la pagina nel browser e clicca su Avvia chiamata:
- Il browser ti chiederà il permesso per il microfono.
- Si avvia una sessione WebRTC con il tuo Agente Babbo Natale.
- Sentirai:
“Ho, ho, ho! Buon Natale, amico mio. Dimmi, come ti chiami?”
Da qui, Babbo Natale ti chiederà il nome, la lista dei desideri e cosa hai fatto quest’anno per restare nella Lista dei Buoni.
Cosa fare dopo
Quando la base funziona, puoi:
- Proteggere Babbo Natale con autenticazione usando le impostazioni di Sicurezza dell’Agente
- Cambiare lingua passando la lingua utente e lasciando che il prompt la gestisca
- Personalizzare la UI con pulsanti, animazioni o una schermata “Chiama Babbo Natale” su misura
Ma l’integrazione di base è solo:
- Un Agente nella Piattaforma Agents
- Un
ID dell'agente - Un hook
useConversatione un pulsante
Ti basta questo per portare la magia di Babbo Natale in tempo reale nella tua app React.


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