Troubleshooting

El bot dice "No tengo información sobre eso"

Posibles causas:

1. La fuente aún está indexando. Ve a /documents y confirma que todas las fuentes tienen estado ready.
2. La respuesta existe pero en otra parte. Prueba a reformular la pregunta usando keywords más literales del contenido ("horario abertura" vs. "cuándo abrís").
3. Falta contenido. Añade una fuente nueva con ese contenido y re-intenta en 1–2 minutos.
4. El system prompt es demasiado restrictivo. En /bots/<id>?tab=instructions revisa si has puesto reglas del tipo "responde solo sobre X" que bloqueen la pregunta del usuario.

El widget no carga

1. Abre la consola del navegador (F12). Busca errores de CSP.
2. Revisa que el data-bot-id en el script coincide con el UUID del bot (sin corchetes, con guiones).
3. Si tu bot tiene allowlist de dominio, comprueba que la URL de la página está añadida (incluye el subdominio: www. si usas ambos).
4. Si usas una CSP estricta, añade script-src https://rag.art y connect-src https://rag.art.

La ingesta URL falla con "0 páginas"

• El sitio es SPA y no sirve HTML en el servidor. Alternativas: usar sitemap.xml, exportar contenidos como Markdown/PDF.
• El servidor bloquea crawlers: añade Firecrawl / rag.art a la allowlist de tu WAF.
• robots.txt bloquea todo con Disallow: /. Añade una excepción para nuestros user-agents o desactiva temporalmente.

Los mensajes se cortan en WhatsApp

Normal: WhatsApp limita a 4 096 caracteres por mensaje. rag.art parte automáticamente en múltiples mensajes consecutivos. Si ves un corte extraño (a mitad de frase), repórtalo; el splitter es por párrafos.

"La cuota se agotó" pero apenas he usado el bot

• La cuota es del dueño del bot, no del usuario final. Si varias webs apuntan a tu bot, todas comparten el contador.
• Revisa /usage → "Por bot" para ver dónde se está yendo el volumen.
• Si sospechas abuso, configura allowlist de dominio o sube a Pro para subir el límite.

Las citas apuntan a páginas viejas

El re-crawl ocurre cada 7 días. Fuerza uno desde /documents → Re-ingest now.

No recibo el email de confirmación

Caja de spam → busca noreply@rag.art. Si está en cuarentena, añade el dominio rag.art a tu safe sender list.

DNS — email inbound

Si tu bot conecta por email a tuempresa@inbox.rag.art pero los replies parecen venir de rag.art (no de tu dominio), añade estos registros DKIM en tu DNS (los genera Resend en /bots/<id>/channels/email):

• TXT @ v=spf1 include:_spf.rag.art ~all (o tu SPF existente + rag.art)
• TXT resend._domainkey <clave>
• TXT _dmarc v=DMARC1; p=none; rua=mailto:<tu_email> (si no existe)

Pagar falla

• Pruebas con Stripe Test Mode: usa 4242 4242 4242 4242, cualquier fecha futura, cualquier CVV.
• Producción: confirma que tu banco no está bloqueando cargos internacionales. rag.art factura desde España, pero el adquirente Stripe opera en Irlanda.
• Si Stripe devuelve 3DS challenge: completa el challenge; el redirect te devuelve a /settings?tab=billing.

Sigue sin funcionar

• Consulta /status para ver si hay incidencia de plataforma.
• Abre ticket en support@rag.art incluyendo:
• ID del bot (/bots/<id> — el UUID en la URL).
• Captura del error (si hay).
• Qué esperabas vs. qué viste.
• Tiempo de respuesta: Starter <48h hábiles; Growth <24h; Pro <4h en horario comercial ES.