Um widget ElevenLabs permite perguntas faladas no site. Este guia é para quem administra a página e o agente. Acompanha uma FAQ pública restrita da configuração à verificação no site, depois acesso, registos e consumo. Segue a documentação consultada em 20 de outubro de 2026. A BIG CHANGE não criou agente, incorporou widget nem fez chamada de teste.

A grande mudança

  • O quê: O ElevenLabs documenta um widget para agente público ElevenAgents, com voz como modo padrão.
  • Como: A página carrega um elemento personalizado com o ID visível do agente. A lista de hostnames permitidos controla quais origens podem se conectar.
  • Por que importa: O proprietário pode verificar a ajuda falada em uma página, mas deve aprovar informação pública, aviso e possíveis cobranças antes de expor o serviço. A lista de hostnames não identifica cada visitante.

Prepare uma FAQ pública e um teste pequeno

É preciso permissão para administrar um agente e editar e publicar uma página. Tenha uma página HTTPS, navegador com microfone e pessoa que aprove a FAQ e ouça as respostas. A ferramenta do site deve permitir o elemento e script documentados; use seu método atual de HTML personalizado. O exemplo é a incorporação HTML simples do fornecedor, não uma instalação específica de plataforma.

Anote alguns fatos públicos aprovados e um contato humano para pedidos fora do escopo. Escolha uma pergunta respondida por esses fatos e outra que deva ser recusada ou encaminhada. Exclua registos de clientes, políticas privadas, dados de conta e segredos API. Defina quem aprova voz e aviso. Confira se a voz e os termos permitem o uso; este guia não estabelece direito comercial universal sobre vozes.

Antes de testar, confira plano, créditos restantes, pagamento por uso e custos do modelo. O ElevenLabs diz que criar agente é gratuito, mas chamadas conectadas consomem uso e os custos LLM podem ser separados. O tempo conectado pode superar o tempo falado. Obtenha aprovação do gasto para testes no painel e no site antes de iniciar. Limite por chamada não é teto mensal.

Configure o agente dedicado

  1. Crie um agente público de FAQ separado no painel ElevenLabs. Use configuração vazia ou modelo aprovado e confira conhecimento e ferramentas herdados. Remova conhecimento privado, reservas, CRM, webhook e ações desnecessárias. Defina propósito e limites pelos fatos aprovados, contato humano e voz e idioma autorizados. Não transforme agente privado existente em público desativando a autenticação.
  2. Em Channels → Widget → Interface, escolha a interface de voz e revise texto e termos para visitantes. O manual também chama parte disso de separador Widget , então confira os controlos guardados. A incorporação exige um agente público com autenticação desativada, localizado pelo manual em Advanced. O ID fica visível no código da página; não é segredo. Exclua chaves API e dados pessoais ou específicos do visitante do código e das substituições do widget.
  3. No separador Security do agente, adicione o hostname exato a Allowlist, guarde e leia novamente. O ElevenLabs informa correspondência exata, até dez e cada subdomínio separado. Adicione um host local somente se precisar desse teste. A lista limita a origem, não autentica quem fala.
  4. Revise retenção de transcrições e gravação de áudio e aprove aviso e consentimento adequados. O widget pode exibir termos antes da chamada, mas a ecrã e a permissão do microfone não resolvem as obrigações legais do site. Em Advanced → Call limits, defina e guarde um valor adequado de Max conversation duration. O manual documenta 600 segundos por padrão e intervalo de 60 a 7.200 segundos. Leia as configurações salvas antes de um teste cobrado.

Adicione a incorporação a uma página em rascunho

Coloque o código no corpo pela função compatível de HTML ou script personalizado. Substitua YOUR_PUBLIC_AGENT_ID pelo ID do agente dedicado. Limite a primeira disponibilização à página aprovada.

HTML
<elevenlabs-convai agent-id="YOUR_PUBLIC_AGENT_ID"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>

Esta é a atual incorporação oficial do widget. A URL do script não fixa uma versão; registre a instalação e consulte o manual na manutenção. No rascunho confira um único widget sem esconder controlos essenciais. Com Content Security Policy, peça ao responsável verificar as solicitações realmente bloqueadas e fazer mudança restrita e revisada. Desativar a política ou abrir curingas amplos não é etapa de instalação.

Confira o agente e depois o caminho real do visitante

Após revisão de custos e privacidade, faça as duas perguntas no teste de voz do painel. Compare respostas aos fatos e ao encaminhamento humano aprovados. Corrija e repita se a resposta for insegura ou sem base. Uma chamada do painel verifica esse caminho, não a incorporação no site.

O proprietário deve revisar conteúdo, aviso, posição e resultado antes de publicar. Na página publicada no hostname permitido, abra o widget, autorize deliberadamente o microfone, faça as duas perguntas, ouça e encerre. Confira indicador apagado e uso na ecrã de telefone. Compare o que foi dito às respostas aprovadas; fluência não prova fatos corretos. Anote horário e agente para investigar consumo. É uma verificação para o leitor, não resultado observado pela BIG CHANGE.

Abra Call history se a retenção conservar um registo e confira a conversa pelas duas perguntas. Em Analytics, filtre agente e curto período para número, duração e custo. Totais não provam sozinhos qual chamada gerou uma cobrança. Se a política apaga registos, guarde apenas a observação mínima autorizada da resposta e veja os agregados disponíveis. Não prolongue retenção só por isso. Falta de registo não prova gratuidade.

Se a verificação falhar

Se não aparece, compare o código publicado com a incorporação documentada, procure duplicações e erros específicos de script ou CSP. Se aparece sem conectar, releia autenticação pública, hostname exato, microfone, créditos e erro do painel. Se a voz falha, confira microfone escolhido, permissão, contexto seguro e registo disponível. Encerre uma sessão incerta e veja consumo antes de pagar outra tentativa.

Se inventa ou sai da FAQ, remova a incorporação enquanto revisa fatos e instruções. Repita as duas perguntas no painel e no site antes de restaurar. Se o consumo supera a aprovação, remova, veja estatísticas filtradas e cobrança e reconsidere duração e alcance. Remover impede novas chamadas nesta página; não prova que uma chamada ativa terminou nem retira acesso de outro host permitido.

Para uma aplicação de voz de navegador desenvolvido localmente, nosso guia OpenAI Realtime trata de outra tarefa. Aqui usamos o widget público hospedado ElevenLabs. O manual lista em outro ponto um atributo signed-url , mas a incorporação básica exige explicitamente agente público; só esse atributo não é receita testada de widget privado.

Fontes e leituras adicionais