Widget del sitio web

Pon tu asistente de ReadyChatAI en tu propio sitio web

Ruta: Configuración de IA > Configurar > Widget del sitio web

Si la pestaña Widget del sitio web está disponible para tu cuenta, úsala para definir el aspecto del chat, limitar dónde puede funcionar y copiar el código de instalación. La página tiene tres pestañas: Configuración, Instalación y Clave API.

Configuración

La vista de escritorio incluye una vista previa en vivo. Refleja la configuración guardada y avisa cuando el formulario tiene cambios que todavía no has guardado.

Apariencia

• Color del tema acepta un color hexadecimal como #0084ff.
• Texto del encabezado es obligatorio y admite hasta 100 caracteres.
• Logo acepta archivos PNG, JPG, WebP o SVG de hasta 2 MB.
• Posición coloca el botón en la esquina superior izquierda, superior derecha, inferior izquierda o inferior derecha.

Comportamiento

• Abrir automáticamente abre el widget cuando un visitante carga la página.
• Recopilar correo del visitante pide un correo antes de comenzar la conversación. No es obligatorio: el visitante puede pulsar Skip (omitir) en lugar de Continue, y el formulario no vuelve a aparecer en esa página. Como la conversación misma, reaparece tras recargar o al hacer clic a otra página.
• Mensaje de bienvenida controla el mensaje que ven los visitantes al abrir el chat.

Pulsa Guardar cambios después de editar esta configuración.

Restringe el widget a tus dominios

Dominios permitidos controla qué sitios web pueden iniciar tu widget. Agrega un nombre de host como ejemplo.com y luego pulsa Enter, escribe una coma o haz clic en Agregar.

• Ingresa únicamente un nombre de host, sin la ruta de una página. El puerto es opcional cuando sea necesario.
• Un nombre de host base también permite sus subdominios. Por ejemplo, ejemplo.com permite tienda.ejemplo.com.
• Dejar la lista vacía permite el widget en cualquier sitio web.

Para una instalación pública, agrega los dominios que controlas antes de compartir el código de inserción. Elimina la etiqueta de un dominio y guarda si ese sitio ya no debe cargar el widget.

Instálalo

Abre Instalación y:

1. Haz clic en Copiar para copiar el código de inserción generado.
2. Abre el HTML de tu sitio o el área de código personalizado de tu constructor web.
3. Pega el código inmediatamente antes de la etiqueta de cierre </body>.
4. Guarda y publica el sitio web.
5. Actualiza la página pública y comprueba que aparezca el botón de chat.

Instalación también enlaza a guías paso a paso para las plataformas más comunes —WordPress, Shopify, Wix, Squarespace, Webflow, GoDaddy Websites+Marketing y Google Tag Manager— cada una con el menú y el cuadro exacto donde pegar el código. Algunas plataformas tienen requisitos propios: WordPress.com necesita un plan Business para agregar código personalizado, Wix y Squarespace exigen su propio plan de sitio pagado antes de que aparezca la opción de código personalizado, Webflow requiere volver a publicar después de guardar, los planes Websites+Marketing de GoDaddy no tienen un pie de página global donde pegarlo, y las páginas de pago de Shopify nunca cargan el widget porque Shopify no ejecuta código del tema ahí.

Si no puedes editar el sitio tú mismo, haz clic en Compartir con tu desarrollador web para copiar un enlace público a esa misma guía. No pide iniciar sesión en ReadyChatAI y muestra una clave de ejemplo en lugar de la real, por lo que es seguro entregarlo a un desarrollador o agencia sin acceso al panel. La clave real de inserción sigue siendo visible para los navegadores una vez instalada, así que Dominios permitidos es lo que realmente impide que otro sitio web use tu configuración.

Cómo funcionan las conversaciones de los visitantes

Cada vez que el navegador de un visitante carga o recarga una página con el widget, comienza una conversación anónima completamente nueva a propósito, para que un navegador nunca pueda heredar el historial de chat de otra persona. Cerrar y volver a abrir la burbuja de chat en la misma página mantiene la conversación, pero recargar, hacer clic en un enlace a otra página de tu sitio o volver más tarde reinician todo: los mensajes anteriores siguen en tu bandeja de Mensajes, solo que bajo una conversación a la que el visitante ya no puede acceder. Por eso, la misma persona navegando dos páginas de tu sitio puede aparecer como dos conversaciones separadas.

Un visitante que nunca da un nombre (ni un correo del que se pueda derivar uno) aparece en tu bandeja de Mensajes como Website Visitor seguido de un id corto. Si solo da un correo, ReadyChatAI convierte la parte antes del arroba en un nombre —por ejemplo, maria.lopez@example.com se vuelve "Maria Lopez"— y si eso falla, usa Website Visitor.

Las respuestas del widget se facturan igual que las de cualquier otro canal: cuentan contra el límite de mensajes de tu plan, a diferencia de las pruebas en el Área de pruebas, que no cuentan. El mensaje de un visitante tiene un límite de 2000 caracteres; uno más largo se rechaza con un error en vez de enviarse o dividirse.

Actívalo o desactívalo

El interruptor junto a las pestañas activa o desactiva el widget. Desactivarlo impide que la clave actual inicie el widget. Puedes conservar la configuración y volver a activarlo más adelante.

Administra la clave API

La pestaña Clave API oculta la clave actual de forma predeterminada. Usa Mostrar solo cuando necesites revisarla o Copiar al instalar el widget.

Usa Regenerar clave únicamente cuando quieras reemplazar la instalación actual. La regeneración invalida de inmediato la clave anterior: todos los sitios que usen el código antiguo dejan de funcionar hasta que copies y publiques el nuevo código generado.

Solución de problemas

• No aparece el botón de chat: confirma que el widget esté activo, que el sitio esté publicado y que el código esté antes de </body>. Si todo eso está bien, revisa si un plugin de caché sigue sirviendo la página vieja, un plugin de optimización de velocidad retrasa el script, Cloudflare Rocket Loader lo reescribe, un encabezado Content-Security-Policy lo bloquea, o un bloqueador de anuncios oculta el botón.
• Funciona en un sitio, pero no en otro: revisa en Dominios permitidos el nombre de host del sitio que falla.
• Dejó de funcionar tras regenerar la clave: reemplaza el código anterior en todos los lugares donde instalaste el widget.
• La vista previa difiere del sitio: guarda los cambios pendientes y luego actualiza la página pública.

Prueba por separado las respuestas del asistente en el Área de pruebas.