Adicione um Agente de Voz do Papai Noel ao seu app React em minutos
- Publicado
OuvirOuça este artigo
Nesta temporada de festas, adicione o Papai Noel ao seu app.
Com a Agents Platform da ElevenLabs e o SDK @elevenlabs/react, você pode adicionar um agente de voz do Papai Noel ao seu app React em poucos minutos. Neste guia, vamos:
- Criar um Agente Papai Noel no painel da ElevenLabs
- Conectá-lo a um componente React usando WebRTC
- Adicionar um botão simples "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 na parte superior.
- Escolha Agents Platform.
Você verá uma barra lateral com Agentes, Base de conhecimento, Ferramentas e Vozes na seção "Criar".
2. Crie seu Agente Papai Noel
Agora, vamos criar um agente que se comporta como o Papai Noel e fala com uma voz de Papai Noel.
- Na barra lateral, clique em Agentes.
- 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 conte: qual é o seu nome?
É isso que os usuários ouvirão 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 deixá-lo aberto:
- Em Segurança, confirme que Ativar autenticação está desativado.
Para sua primeira demonstração, não há problema em deixar Ativar autenticação desativado para que qualquer pessoa possa se conectar ao Agente sem restrições. Isso torna a configuração inicial mais rápida e é ideal para protótipos rápidos, projetos de hackathon ou demonstrações internas.
No entanto, em qualquer aplicação de produção ou acessível externamente, você nunca deve deixar seu Agente aberto. Em vez disso, use o Endpoint de token da ElevenLabs para gerar tokens de acesso temporários e com escopo definido para cada sessão de usuário. Isso garante que você mantenha controle total sobre quem pode se conectar, por quanto tempo o acesso dura e quais ações o usuário pode realizar. Ativar a autenticação protege seu Agente contra chamadas não autorizadas, abusos ou uso fora dos limites pretendidos — e é altamente recomendado antes de publicar sua aplicação.
3. Pegue o ID do seu Agente
Na parte superior da página do Agente, você verá um campo ID do Agente.
Anote esse valor — vamos colá-lo no componente React em uma etapa posterior:
4. Instale o SDK para React
No seu projeto React / Next.js, instale o SDK React 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 ID real do Agente que você copiou do painel.
Em seguida, renderize o botão em algum lugar da sua interface, por exemplo:
6. Experimente
Abra-o no navegador e clique em Iniciar chamada:
- Seu navegador solicitará permissão para usar o microfone.
- Uma sessão WebRTC começa com seu Agente Papai Noel.
- Você ouvirá:
“Ho, ho, ho! Feliz Natal, meu amigo. Me conte: qual é o seu nome?”
A partir daí, o Papai Noel pedirá seu nome, sua lista de desejos e o que você fez este ano para continuar na Lista dos Bons.
Próximos passos
Quando o básico estiver funcionando, você pode:
- Restringir o acesso ao Papai Noel com autenticação usando as configurações de Segurança do Agente
- Alternar idiomas passando o idioma do usuário e deixando o prompt cuidar disso
- Personalizar a interface com botões, animações ou uma tela completa de "Ligar para o Papai Noel"
Mas a integração principal é só:
- Um Agente na Agents Platform
- Um
agentId - Um hook
useConversatione um botão
É tudo o que você precisa para levar a magia conversacional do Papai Noel, em tempo real, ao seu app React.



