AI-translated from English; not yet reviewed by a fluent editor.
# Adicione um widget de FAQ por voz do ElevenLabs a uma página
> Configure um agente público de FAQ dedicado, restrinja hostnames, incorpore o widget em uma página e confira conversa ao vivo, privacidade e consumo.
By BIG CHANGE Editorial
Published: 2026-10-20T06:57:39.691Z
Updated: 2026-10-20T06:57:39.691Z
Canonical: https://bigchange.ai/blog/elevenlabs-voice-faq-widget-website-guide
AI-generated conceptual illustration by BIG CHANGE.
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, registros 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 registros 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 aba **Widget** , então confira os controles salvos. 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. Na aba **Security** do agente, adicione o hostname exato a **Allowlist**, salve 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 tela e a permissão do microfone não resolvem as obrigações legais do site. Em **Advanced → Call limits**, defina e salve 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. Restrinja a estreia à página aprovada.
```html
```
Esta é a atual [incorporação oficial do widget](https://elevenlabs.io/docs/eleven-agents/customization/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 controles 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 tela 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 registro 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 registros, 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 registro não prova gratuidade.
## Se a verificação falhar
Se não aparece, compare o código publicado com [a incorporação documentada](https://elevenlabs.io/docs/eleven-agents/customization/widget), 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 registro 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 um aplicativo de voz de navegador desenvolvido localmente, [nosso guia OpenAI Realtime](https://bigchange.ai/blog/openai-realtime-browser-voice-webrtc-guide) 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
- [Personalização do widget ElevenLabs](https://elevenlabs.io/docs/eleven-agents/customization/widget): agente público, interface e incorporação atual. A URL não fixa versão.
- [Autenticação do agente](https://elevenlabs.io/docs/eleven-agents/customization/authentication): hostnames exatos, limite de dez e diferença da autenticação individual.
- [Fluxo da conversa](https://elevenlabs.io/docs/eleven-agents/customization/conversation-flow) e [controles de privacidade](https://elevenlabs.io/docs/eleven-agents/customization/privacy): duração, retenção e gravação de áudio.
- [Introdução ao ElevenAgents](https://elevenlabs.io/docs/eleven-agents/quickstart), [Analytics](https://elevenlabs.io/docs/eleven-agents/dashboard) e [ajuda de custos](https://elevenlabs.io/docs/help-center/product/eleven-agents/how-much-does-eleven-agents-cost): testes, histórico, consumo agregado e cobrança. Termos do plano determinam franquia e fatura reais.
## Sources
- [Personalização do widget](https://elevenlabs.io/docs/eleven-agents/customization/widget) — Consultado em 20 de outubro de 2026. Agente público, modos, elemento básico e script sem versão fixa. Não verifica implementação privada assinada.
- [Autenticação do agente](https://elevenlabs.io/docs/eleven-agents/customization/authentication) — Consultado em 20 de outubro de 2026. Hostnames exatos e limite de dez; controle de origem, não autenticação do visitante.
- [Fluxo da conversa](https://elevenlabs.io/docs/eleven-agents/customization/conversation-flow) — Consultado em 20 de outubro de 2026. Padrão e intervalo da duração e salvamento por chamada; nenhum teto agregado de gasto estabelecido.
- [Privacidade](https://elevenlabs.io/docs/eleven-agents/customization/privacy) — Consultado em 20 de outubro de 2026. Retenção de transcrição e áudio; aviso e base legal exigem revisão do proprietário.
- [Introdução ao ElevenAgents](https://elevenlabs.io/docs/eleven-agents/quickstart) — Consultado em 20 de outubro de 2026. Configuração e teste no painel, Call history e código oficial; nenhum teste da BIG CHANGE.
- [Analytics](https://elevenlabs.io/docs/eleven-agents/dashboard) — Consultado em 20 de outubro de 2026. Filtros de agente/tempo e totais de quantidade, duração e custo; não identificam sozinhos uma chamada de teste.
- [Quanto custa o ElevenAgents?](https://elevenlabs.io/docs/help-center/product/eleven-agents/how-much-does-eleven-agents-cost) — Consultado em 20 de outubro de 2026. Criação, tempo conectado e custos LLM separados; confira plano, créditos e direitos da voz específicos.