Añade un agente de voz de Papá Noel a tu app React en minutos
- Publicado
EscucharEscucha este artículo
Estas fiestas, añade a Papá Noel a tu app.
Con ElevenLabs Plataforma de Agents y el @elevenlabs/react SDK, puedes añadir un agente de voz de Papá Noel a tu app React en solo unos minutos. En esta guía vamos a:
- Crear un agente de Papá Noel en el panel de ElevenLabs
- Conectarlo en un componente React usando WebRTC
- Añadir un botón sencillo de “Llamar a Papá Noel”
1. Regístrate y abre Agents Platform
- Regístrate / inicia sesión en ElevenLabs.
- En la barra lateral izquierda, abre el selector de plataforma en la parte superior.
- Elige Plataforma de Agents.
Verás una barra lateral con Agents, Base de conocimiento, Herramientas y Voces en la sección “Build”.
2. Crea tu agente de Papá Noel
Ahora vamos a crear un agente que actúe como Papá Noel y hable con su voz.
- En la barra lateral, haz clic en Agents.
- Haz clic en + Nuevo agente.
- Elige Agent en blanco para empezar desde cero.
Ponle el nombre: Santa.
Prompt del sistema
En el campo Prompt del sistema, pega lo siguiente:
Primer mensaje
Pon Primer mensaje como:
¡Jo, jo, jo! Feliz Navidad, amigo. Dime, ¿cómo te llamas?
Esto es lo que escucharán los usuarios al empezar la llamada.
Voz
En la sección Voz:
- Elige “Jerry B. – Papá Noel”
- ID de voz:
MDLAMJ0jxkpYkjXbmG4t
Ahora Papá Noel realmente sonará como Papá Noel.
Seguridad
En este ejemplo, lo dejaremos abierto:
- En Seguridad, asegúrate de que Activar autenticación está desactivado.
Para tu primera demo, está bien dejar Activar autenticación desactivado para que cualquiera pueda conectarse al agente sin restricciones. Así el acceso es más rápido y es ideal para prototipos rápidos, hackathones o demos internas.
Sin embargo, en cualquier entorno de producción o aplicación accesible desde fuera, nunca deberías dejar tu agente abierto. En su lugar, usa la Ruta de token de ElevenLabs para generar tokens de acceso temporales y personalizados para cada sesión de usuario. Así controlas quién puede conectarse, cuánto dura el acceso y qué puede hacer cada usuario. Activar la autenticación protege tu agente de llamadas no autorizadas, abusos o usos fuera de tus límites — y es muy recomendable antes de lanzar en producción.
3. Copia el ID de tu agente
En la parte superior de la página del agente verás un campo ID del Agent.
Guarda este valor — lo pegaremos en el componente React más adelante:
4. Instala el SDK de React
En tu proyecto React / Next.js, instala el SDK de React de ElevenLabs:
Con esto listo, podemos usar el hook usarConversacion para iniciar y terminar llamadas de voz.
5. Añade el botón "Llamar a Papá Noel"
Crea un nuevo componente, por ejemplo CallSantaButton.tsx, y pega este código:
Ahora sustituye "<AGENT_ID>" por el Agent ID real que copiaste del panel.
Después, muestra el botón donde quieras en tu interfaz, por ejemplo:
6. Pruébalo
Ábrelo en tu navegador y haz clic en Iniciar llamada:
- Tu navegador pedirá permiso para el micrófono.
- Se inicia una sesión WebRTC con tu agente de Papá Noel.
- Escucharás:
“¡Jo, jo, jo! Feliz Navidad, amigo. Dime, ¿cómo te llamas?”
A partir de ahí, Papá Noel te preguntará tu nombre, tu lista de deseos y qué has hecho este año para estar en la lista de los buenos.
¿Qué más puedes hacer?
Cuando tengas lo básico funcionando, puedes:
- Proteger el acceso a Papá Noel con autenticación usando los ajustes de seguridad del agente
- Cambiar de idioma pasando la configuración de idioma del usuario y dejando que el prompt lo gestione
- Personalizar la interfaz con botones propios, animaciones o una pantalla completa de “Llamar a Papá Noel”
Pero la integración básica es solo:
- Un agente en la Plataforma de Agents
- Un
idAgente - Un hook
usarConversaciony un botón
Eso es todo lo que necesitas para llevar la magia de Papá Noel en tiempo real y de forma conversacional a tu app React.



