Using the dashboard

Crea un widget web en el dashboard

Configura un widget de clic para hablar para tu sitio desde la página Widgets web; no se requieren llamadas a la API.

La página Widgets web (/dashboard/web-widgets) crea y administra las claves publicables que impulsan el widget de voz insertable de ThunderPhone. Todo lo que la versión de API de esta guía hace con cURL, esta página lo hace con un formulario, además de generar el código de inserción por ti.

Crea un widget#

1. Haz clic en Nuevo widget y elige un modo
   • Modo de agente — el widget siempre ejecuta un agente que eliges en el menú desplegable. La configuración más sencilla.
   • Modo webhook — en cada sesión del widget, ThunderPhone llama a la URL de tu webhook y tu servidor devuelve la configuración del agente para ese visitante (enrutamiento por página, usuarios con sesión iniciada, lanzamientos graduales). Deja la URL en blanco para usar el webhook predeterminado de tu organización; cuando ingreses una URL nueva, también puedes establecerla como predeterminada de la organización.
2. Enumera los dominios permitidos

   Las claves publicables están restringidas por origen: se requiere al menos un dominio, y el widget solo funciona en los nombres de host que enumeres. Se permiten comodines de subdominio como *.example.com (coinciden con subdominios, no con el dominio raíz); se rechazan los comodines sin dominio como *. localhost y 127.0.0.1 siempre están permitidos, por lo que el desarrollo local funciona sin necesidad de enumerarlos.

3. Ponle un nombre, actívalo y créalo

   El interruptor Activar widget controla si la clave acepta sesiones; puedes crear un widget desactivado y activarlo al momento del lanzamiento.

Obtén el código de inserción#

Justo después de crearlo (o mediante el botón Insertar de cada fila), un cuadro de diálogo de inserción genera código listo para pegar con tu clave publicable incluida:

• React — un fragmento <ThunderPhoneWidget /> para aplicaciones con empaquetador.
• Etiqueta de script — un par de <script> de CDN y hoja de estilos para cualquier sitio.

El cuadro de diálogo también muestra una vista previa de las opciones básicas de apariencia: título, color principal, posición de la esquina y tema claro/oscuro, e incorpora tus elecciones en el fragmento. Para consultar la referencia completa de props, los hooks de estilos y la opción headless, consulta la documentación del SDK del widget.

Administra widgets desde la lista#

Cada fila se edita directamente:

• Modo / Agente — cambia entre el modo de agente y webhook, o redirige el agente, con selectores integrados.
• Dominios — agrega o elimina dominios permitidos como etiquetas.
• Activar/desactivar — un interruptor por widget; los widgets desactivados dejan de aceptar sesiones de inmediato.
• Transferir a organización — copia o mueve el widget a otra organización a la que pertenezcas (moverlo lo elimina de aquí).
• Eliminar — revoca la clave publicable; el widget deja de funcionar de inmediato en todos los dominios. Esto no se puede deshacer.

Las sesiones del widget aparecen en el historial de llamadas con la misma transcripción, grabación y evaluación que las llamadas telefónicas.

Próximos pasos#