Widget web de voz
Personaliza y copia el embed del agente de voz para un sitio web.
Que se logra
- Resultado: un sitio externo ofrece una entrada de voz identificada con la marca de la organización y conectada al asistente sincronizado.
- Caso de uso: una escuela de idiomas inserta el widget en su página de cursos para que visitantes hablen con el agente y soliciten información.
- Se combina con: Configuración de voz, Sitios y S3 para el logo cargado.
Donde esta
- Ruta:
/[orgId]/ai-assistant - Acceso en UI:
AI Assistant - Componente(s): WebWidgetEmbedSection.tsx
Como funciona
- En un asistente de voz abre
Voice > Embed on your website. - Cuando exista el ID tras la sincronización, pulsa
Copy embed code. - En
Widget appearanceajusta tema, posición, estado inicial y textos del widget. - Sube un logo de imagen de hasta 5 MB o pega una URL pública; usa
Clear appearance fieldspara limpiar los campos administrados. - Persiste el aspecto con
Update Assistant.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
Theme |
lista | No | Default, light o dark. |
Position |
lista | No | Default, fixed o static. |
| logo y textos | URL / texto | No | Incluye inicio, espera e interrupción. |
Reglas y validaciones
- Sin ID del recurso de voz, no se genera embed y la UI pide guardar y esperar sincronización.
- Solo se aceptan archivos de imagen de 5 MB o menos.
Backend
- Servicios:
ai-assistants(patch),s3-url-signing(create) y sincronización Telnyx. - Efectos: el logo se sube al almacenamiento de archivos de la organización.
Relaciones
- Requiere: asistente de voz sincronizado.
- Dispara / afecta: el widget Telnyx insertado en un sitio externo.
Notas
Por confirmar: las opciones adicionales aceptadas por el widget de Telnyx.