Helpium

Solución de Problemas Comunes

Widget No Aparece

Verifica tu clave API. Asegúrate de que el apiKey en Helpium.init() coincida con la clave del widget en Configuración → Canales → Widget.

Verifica la URL del script. La URL del script del widget debe apuntar a tu espacio de trabajo de Helpium. Verifica que no haya errores tipográficos.

Verifica la consola de tu navegador. Abre las Herramientas de Desarrollo (F12) y busca errores en la pestaña de Consola. Problemas comunes:

404 en el script del widget — URL incorrecta
401 No autenticado — clave API inválida
Errores de CORS — contacta al soporte si ves estos

Política de Seguridad de Contenido (CSP). Si tu sitio utiliza una CSP estricta, necesitas incluir el dominio del widget de Helpium en tus directivas script-src y connect-src.

AI No Responde o Da Respuestas Pobre

Verifica tu base de conocimientos. La IA solo puede responder preguntas cubiertas por tus artículos publicados. Los artículos en borrador no se incluyen en las búsquedas de la IA.

Genera embeddings. Después de agregar o actualizar artículos, los embeddings se generan automáticamente. Si la IA aún no puede encontrar contenido relevante, ve a Configuración → AI & Automatización → Búsqueda & Embeddings y haz clic en Regenerar Embeddings.

Verifica los límites de mensajes de la IA. Si tu espacio de trabajo ha alcanzado su límite mensual de mensajes de IA, el bot dejará de responder. Verifica tu uso en Configuración → Facturación o actualiza tu plan.

Mejora el contenido del artículo. Escribe artículos con encabezados claros, terminología específica y respuestas completas. La IA funciona mejor con contenido bien estructurado.

Mensajes No Enviados

Verifica la conexión WebSocket. El widget utiliza WebSockets para mensajería en tiempo real. Si los mensajes no se envían:

Verifica que tu firewall no esté bloqueando conexiones WebSocket
Comprueba si un VPN o proxy está interfiriendo
Intenta refrescar la página

Verifica el estado de la conversación. Las conversaciones cerradas no pueden recibir nuevos mensajes. El cliente necesita iniciar una nueva conversación.

Cliente No Identificado

Llama a identify() después de init(). Asegúrate de que Helpium.init() se complete antes de llamar a Helpium.identify(). Usa el callback onload como se muestra en la guía de instalación.

Verifica el formato del correo electrónico. El correo debe tener un formato válido. Los correos inválidos son rechazados silenciosamente.

Verifica la clave API. La identificación requiere la misma clave API utilizada para la inicialización del widget.

Canal de Correo Electrónico No Funciona

Verifica el reenvío. Asegúrate de que tu proveedor de correo esté reenviando a la dirección correcta de Helpium mostrada en Configuración → Canales → Correo Electrónico.

Verifica los filtros de spam. Asegúrate de que los correos reenviados no estén siendo atrapados por filtros de spam antes de llegar a Helpium.

Fallos en Acciones de IA

Prueba el endpoint. Usa el botón de prueba en la página de configuración de la acción. Verifica que tu endpoint API sea accesible y devuelva JSON válido.

Verifica la autenticación. Asegúrate de que la clave API o el token de portador sean correctos y no hayan expirado.

Verifica el tiempo de espera. Si tu API es lenta, aumenta el tiempo de espera en la configuración de la acción. El valor predeterminado es de 10 segundos.

Verifica los parámetros. Verifica que los nombres de los parámetros coincidan con lo que tu API espera.

¿Aún Necesitas Ayuda?

Si no puedes resolver un problema, inicia una conversación con nuestro equipo de soporte utilizando el widget de chat — ¡estamos aquí para ayudar!

Solución de problemas comunes