Un widget de ElevenLabs permite preguntar por voz en una web. Esta guía es para quien administra la página y el agente. Cubre una FAQ pública limitada desde la configuración hasta la comprobación en la página publicada, y después el acceso, los registros y el consumo. Sigue la documentación consultada el 20 de octubre de 2026. BIG CHANGE no creó un agente, integró un widget ni realizó una llamada de prueba.

El gran cambio

  • Qué: ElevenLabs documenta un widget web para un agente público ElevenAgents, con voz como modo predeterminado.
  • Cómo: La página carga un elemento personalizado con el ID visible del agente. Su lista de hosts permitidos controla los orígenes de sitio que pueden conectarse.
  • Por qué importa: El propietario puede comprobar una vía de ayuda hablada en una página, pero debe aprobar información pública, aviso y posibles cargos antes de exponerla. Una lista de hosts no identifica a cada visitante.

Prepara una FAQ pública y una prueba pequeña

Necesitas permiso para administrar un agente y editar y publicar una página. Prepara una página HTTPS, navegador con micrófono y una persona que apruebe la FAQ y escuche las respuestas. La herramienta del sitio debe permitir el elemento y script documentados; usa su método actual de HTML personalizado. El ejemplo es la integración HTML simple del proveedor, no instrucciones para una plataforma concreta.

Anota unos hechos públicos aprobados que el agente pueda responder y un contacto humano para el resto. Elige una pregunta cubierta y otra que deba rechazar o derivar. Excluye datos de clientes, políticas privadas, cuentas y secretos API. Decide quién aprueba la voz y el aviso. Comprueba que la voz y las condiciones permitan el uso previsto; esta guía no establece un derecho comercial universal sobre las voces.

Antes de cualquier prueba vocal, revisa tu plan, créditos restantes, pago por uso y costes del modelo elegido. ElevenLabs dice que crear un agente es gratis, pero las llamadas conectadas consumen uso y los cargos LLM pueden ser independientes. El tiempo conectado puede superar el hablado. Obtén aprobación del gasto de las pruebas del panel y del sitio antes de iniciarlas. El límite por llamada no es un tope mensual.

Configura el agente dedicado

  1. Crea un agente público de FAQ independiente en el panel ElevenLabs. Usa una configuración vacía o plantilla aprobada y revisa conocimientos y herramientas heredados. Retira conocimiento privado, reservas, CRM, webhook y otras acciones innecesarias. Define propósito y límites con los hechos aprobados, incluye contacto humano y elige voz e idioma autorizados. No conviertas un agente privado existente desactivando su autenticación.
  2. En Channels → Widget → Interface, elige la interfaz vocal y revisa texto y condiciones para visitantes. El manual también llama a parte de esto pestaña Widget , así que comprueba los controles guardados. La integración requiere un agente público con autenticación desactivada, que el manual sitúa en Advanced. El ID será visible en el código de la página; no es un secreto. Excluye claves API y datos personales o específicos del visitante del marcado y las anulaciones del widget.
  3. En la pestaña Security del agente añade el host exacto a Allowlist, guarda y vuelve a leerlo. ElevenLabs indica coincidencia exacta, hasta diez hosts y registro separado de cada subdominio. Añade un host local solo si necesitas ese origen de prueba. La lista restringe el origen de conexión, no autentica al hablante.
  4. Revisa conservación de transcripciones y grabación de audio y aprueba aviso y consentimiento adecuados. El widget puede mostrar condiciones antes de llamar, pero ese aviso y el permiso de micrófono no resuelven las obligaciones legales del sitio. En Advanced → Call limits, establece y guarda un valor apropiado de Max conversation duration. ElevenLabs documenta 600 segundos predeterminados y un intervalo de 60 a 7.200 segundos. Lee los ajustes guardados de privacidad, duración y acceso antes de una prueba facturable.

Añade la integración a una página en borrador

Coloca este código en el cuerpo mediante la función compatible de HTML o script personalizado. Sustituye YOUR_PUBLIC_AGENT_ID por el ID del agente dedicado. Limita el despliegue inicial a esa página aprobada.

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 es la actual integración oficial del widget. Su URL de script no fija una versión; registra qué instalaste y revisa el manual durante el mantenimiento. En el borrador confirma un solo widget que no tape controles esenciales. Si hay Content Security Policy, pide al responsable revisar las peticiones realmente bloqueadas y hacer un cambio limitado y aprobado. Desactivarla o añadir comodines amplios no es un paso de instalación.

Comprueba el agente y después la vía real del visitante

Tras revisar coste y privacidad, haz las dos preguntas en la prueba vocal del panel. Compara con los hechos y la derivación humana aprobados. Corrige y repite si alguna respuesta es insegura o infundada. Una llamada del panel comprueba ese panel, no la integración web.

El propietario debe revisar contenido, aviso, ubicación y resultado antes de publicar. En la página publicada en el host permitido, abre el widget, concede el micrófono deliberadamente, haz las dos preguntas, escucha y termina. Comprueba que el indicador se apague y que el widget funcione en una vista de teléfono. Compara las palabras con las respuestas aprobadas; hablar con fluidez no demuestra exactitud. Registra hora y agente para investigar consumo. Es una prueba para el lector, no un resultado observado por BIG CHANGE.

Abre Call history del agente si la conservación deja registro y compara la conversación con las dos preguntas. En Analytics, filtra agente y periodo corto para revisar número, duración y coste. Los agregados no identifican por sí solos qué llamada generó un cargo. Si la política aprobada borra conversaciones, conserva solo la observación mínima permitida de la respuesta y revisa el uso agregado. No amplíes la conservación para esta comprobación. La ausencia de registro no demuestra gratuidad.

Si falla la comprobación

Si no aparece el widget, compara el marcado realmente publicado con la integración documentada, busca elementos o scripts duplicados y errores específicos de script o CSP. Si aparece sin conectarse, revisa autenticación pública, host exacto permitido, permiso de micrófono, créditos y error del panel. Si falla la voz, revisa micrófono elegido, permiso y contexto seguro, y después el registro disponible. Termina una sesión incierta y consulta consumo antes de pagar otro intento.

Si inventa una respuesta o sale de la FAQ, retira la integración mientras corriges hechos e instrucciones. Repite ambas preguntas en panel y sitio antes de restaurarla. Si el consumo supera lo aprobado, retírala, revisa estadísticas filtradas y facturación y reconsidera duración y despliegue. Retirarla impide nuevas llamadas en esta página; no demuestra que una llamada activa terminara ni retira el acceso desde otro host permitido.

Para una aplicación vocal de navegador desarrollada localmente, nuestra guía OpenAI Realtime cubre otra tarea. Aquí usamos el widget público alojado de ElevenLabs. El manual menciona en otra sección un atributo signed-url , pero su integración básica exige un agente público; ese atributo solo no es una receta probada para un widget privado.

Fuentes y lecturas adicionales