Esta guía es para agentes hechos en el Constructor. El widget usa siempre la versión publicada del agente, nunca el borrador que estás editando.
Lo que necesitas
- Un agente publicado. Para ofrecer voz, el agente necesita su voz y su transcripción configuradas, igual que para las llamadas.
- Un método de pago guardado y créditos en tu cuenta.
- Acceso al código de tu sitio, o al lugar donde tu constructor de sitios te deja pegar un script.
Configura el widget
1
Abre el agente en el Constructor
Desde Agentes, abre el agente y entra a la pestaña Canales. Haz clic en Configurar en la tarjeta Widget web.
2
Elige dónde se puede mostrar
En Dominios Permitidos, escribe el dominio de tu sitio sin
https://, uno por línea: tudominio.com. Usa *.tudominio.com para permitir todos sus subdominios; no incluye tudominio.com a secas, así que escribe los dos si quieres los dos. localhost:3000 sirve para probar en tu computadora.3
Elige qué puede hacer el visitante
Enciende o apaga Escribir (chat de texto) y Hablar (una llamada desde el navegador), luego enciende Mostrar el widget y haz clic en Guardar cambios.
4
Pega el código
Copia el código de Código para tu sitio y pégalo antes de
</body> en cada página donde quieras la burbuja.Cómo está protegido
El código lleva una llave publicable (ryvo_pk_...). Es pública a propósito: cualquiera que abra tu sitio puede verla, igual que ve el resto de tu código. Lo que impide que alguien use tu agente desde otro sitio:
- Los dominios permitidos. El widget sólo se abre dentro de los dominios que escribiste. Lo hace cumplir el propio navegador del visitante, así que otro sitio que copie tu código recibe un marco vacío.
- Una verificación humana. Cada conversación y cada llamada empiezan con una verificación invisible que distingue a una persona de un bot.
- Límites de uso por visitante, por agente y por cuenta.
- Los límites de tu propia cuenta. El saldo, las llamadas simultáneas de tu plan y el resto de las verificaciones de cualquier conversación siguen aplicando.
Cuánto cuesta
Cada conversación del widget se cobra igual que una conversación web: el texto por mensaje y la voz por minuto, a la tarifa de tu plan. Las conversaciones aparecen en tu historial con el canal Widget, junto al resto de las conversaciones de tu agente.Solución de problemas
La burbuja aparece pero el panel sale en blanco
La burbuja aparece pero el panel sale en blanco
El dominio de la página no está en Dominios Permitidos. Revisa que lo hayas escrito tal como aparece en la barra de direcciones, sin
https:// y sin ruta. www.tudominio.com y tudominio.com son dominios distintos.El widget dice que el asistente no está disponible
El widget dice que el asistente no está disponible
El agente no está publicado o está en pausa, el widget está apagado, o tu cuenta se quedó sin créditos. Revisa la tarjeta Widget web en la pestaña Canales y tu saldo.
La voz no arranca
La voz no arranca
El visitante tiene que permitir el micrófono. Si no aparece el modo Hablar, el agente no tiene voz y transcripción configuradas en su versión publicada.

