AstrhorusDocumentación

Solución de problemas

Qué revisar cuando el widget no aparece, no responde o muestra un error.

El botón no aparece

Revise en este orden:

  1. ¿Está el código en la página? Abra la página, pulse Ctrl U (ver código fuente) y busque widget.astrhorus.io.
  2. ¿Tiene data-key? Sin la clave, el widget no se crea y la consola muestra: Astrhorus: falta data-key en el script del widget.
  3. ¿Está autorizado el dominio? Abra la consola (F12 → Network) y busque la petición widget/session. Si responde 403 con domain_not_allowed, agregue el dominio en Canales. Recuerde que www.mitienda.cl y mitienda.cl son distintos. Vea Dominios autorizados.
  4. ¿Está activa su cuenta? El asistente funciona cuando el plan está activo. Si el primer pago no se confirmó, el widget responde inactive.
  5. ¿Una extensión bloquea el script? Pruebe en una ventana de incógnito sin extensiones.

Mi sitio tiene una CSP

Si su sitio envía una cabecera Content-Security-Policy, debe permitir los dominios del widget. Agregue:

script-src  https://widget.astrhorus.io;
connect-src https://widget.astrhorus.io;
frame-src   https://app.astrhorus.io;
Directiva Para qué
script-src Cargar el script del widget
connect-src Que el script pida la sesión a Astrhorus
frame-src Mostrar la ventana del chat (se carga desde el panel de Astrhorus)

«Estás escribiendo muy rápido»

El chat limita la velocidad para evitar abusos: hasta 10 mensajes por minuto en una misma conversación, y topes por conexión y por cuenta. Espere un momento y vuelva a intentar. Si un visitante legítimo lo ve a menudo, escríbanos.

«Alcanzaste el límite de conversaciones»

Su plan incluye un número de conversaciones por ciclo (150 en Básico, 300 en Intermedio y 500 en Avanzado). Al superarlo, las conversaciones nuevas se pausan hasta que se reinicie su cupo (el mismo día de cada mes en que contrató); las ya iniciadas continúan. Puede sumar un pack de 50 conversaciones en Facturación o escribirnos para cambiar a un plan mayor.

«Llegamos al máximo de mensajes de esta conversación»

Cada conversación admite hasta 20 mensajes de la persona. Al llegar a ese tope, el asistente le avisa y le pide contactar directamente al negocio; no gasta más de su cuota ni responde más en esa conversación. Es un tope del servicio y no se puede cambiar desde el panel.

El asistente dice «No tengo ese dato»

No es un error: significa que su contexto no tiene esa información. Revise Contexto → Preguntas sin respuesta, complete la respuesta y el asistente la aprende al instante. Vea Cómo responde el asistente.

El asistente responde algo equivocado

  1. Busque la conversación en Chats.
  2. Revise Contexto y confirme que la información correcta esté escrita sin ambigüedad (precios, horarios, políticas).
  3. Si hay dos fuentes que se contradicen (un PDF viejo y la web), desactive la que sobra.
  4. Lea las buenas prácticas de contexto.

Los cambios no se ven en el sitio

El navegador guarda el script unos minutos. Recargue con Ctrl Shift R. Los cambios de diseño y de contexto se aplican en el siguiente mensaje, sin tocar su sitio.

Sigue sin funcionar

Escríbanos a contacto@astromind.cl con la dirección de su sitio y, si puede, el mensaje que ve en la consola del navegador (F12).