Adicione um Agente de Voz do Papai Noel ao seu app React em minutos
- Publicado
OuvirOuça este artigo
Neste fim de ano, coloque o Papai Noel no seu app.
Com a ElevenLabs Plataforma de Agents e o @elevenlabs/react SDK, você pode adicionar um agente de voz do Papai Noel ao seu app React em poucos minutos. Neste guia, vamos:
- Criar um Agente do Papai Noel no painel da ElevenLabs
- Conectar em um componente React usando WebRTC
- Adicionar um botão simples de “Ligar para o Papai Noel”
1. Cadastre-se e abra a Agents Platform
- Cadastre-se / faça login na ElevenLabs.
- Na barra lateral à esquerda, abra o seletor de plataforma no topo.
- Escolha Plataforma de Agents.
Você verá uma barra lateral com Agents, Base de conhecimento, Ferramentas e Vozes na seção “Build”.
2. Crie seu Agente do Papai Noel
Agora vamos criar um agente que se comporta como o Papai Noel e fala com a voz dele.
- Na barra lateral, clique em Agents.
- Clique em + Novo Agente.
- Escolha Agente em branco para começar do zero.
Dê o nome: Papai Noel.
Prompt do sistema
No campo Prompt do sistema, cole o seguinte:
Primeira mensagem
Defina Primeira mensagem como:
Ho, ho, ho! Feliz Natal, meu amigo. Me diga, qual é o seu nome?
É isso que os usuários vão ouvir quando a chamada começar.
Voz
Na seção Voz:
- Escolha “Jerry B. – Papai Noel”
- ID da voz:
MDLAMJ0jxkpYkjXbmG4t
Agora o Papai Noel vai realmente soar como o Papai Noel.
Segurança
Neste exemplo, vamos deixar aberto:
- Em Segurança, confira se Habilitar autenticação está desligado.
Para seu primeiro teste, não tem problema deixar Ativar autenticação desligado, assim qualquer pessoa pode se conectar ao Agente sem restrições. Isso agiliza o uso inicial e é ideal para protótipos rápidos, hackathons ou demonstrações internas.
Mas para qualquer aplicação em produção ou acessível externamente, você nunca deve deixar seu Agente aberto. Use o Endpoint de token da ElevenLabs para gerar tokens de acesso temporários e específicos para cada sessão de usuário. Assim, você mantém controle total sobre quem pode acessar, por quanto tempo e o que cada usuário pode fazer. Habilitar autenticação protege seu Agente contra acessos não autorizados, abusos ou uso fora do esperado — e é altamente recomendado antes de colocar em produção.
3. Pegue o ID do seu Agente
No topo da página do Agente, você verá o campo ID do Agent.
Anote esse valor — vamos colar no componente React mais adiante:
4. Instale o React SDK
No seu projeto React / Next.js, instale o React SDK da ElevenLabs:
Com isso pronto, podemos usar o hook useConversation para iniciar e encerrar chamadas de voz.
5. Adicione o botão "Ligar para o Papai Noel"
Crie um novo componente, por exemplo CallSantaButton.tsx, e cole este código:
Agora substitua "<AGENT_ID>" pelo Agent ID que você copiou do painel.
Depois, coloque o botão em algum lugar da sua interface, por exemplo:
6. Teste
Abra no navegador e clique em Iniciar chamada:
- Seu navegador vai pedir permissão para o microfone.
- Uma sessão WebRTC começa com seu Agente do Papai Noel.
- Você vai ouvir:
“Ho, ho, ho! Feliz Natal, meu amigo. Me diga, qual é o seu nome?”
A partir daí, o Papai Noel vai perguntar seu nome, sua lista de desejos e o que você fez este ano para ficar na Lista dos Bonzinhos.
O que fazer depois
Quando tudo estiver funcionando, você pode:
- Proteger o Papai Noel com autenticação usando as configurações de segurança do Agente
- Trocar o idioma passando o idioma do usuário e deixando o prompt lidar com isso
- Personalizar a interface com botões, animações ou até uma tela completa de “Ligar para o Papai Noel”
Mas a integração principal é só:
- Um Agente na Plataforma de Agents
- Um
agentId - Um hook
useConversatione um botão
É só isso que você precisa para trazer a magia do Papai Noel em tempo real e de forma conversacional para seu app React.



