Troubleshooting

Lista corta de los errores más frecuentes con el fix concreto. Si tu caso no está acá, chequeá https://status.wafle.click y si todo está OK escribinos a [email protected].

Antes de empezar
El admin tiene una página de Diagnostics en /admin/account → Diagnostics que corre los chequeos de abajo automáticamente y te da un report con un click. Probala primero.

1. 401 Unauthorized en la API

Tu API key expiró, fue revocada o no tiene scope para el tenant.

  • Verificá que la enviás como Authorization: Bearer wpk_…, no como Token.
  • Generá una nueva en /admin/account → API Keys con los scopes correctos.
  • Si tenés multi-tenant, asegurate de que el header X-Wafle-Tenant matchee con el scope de la key.

2. 429 Too Many Requests

Pasaste el rate limit. Cada response 429 viene con header Retry-After: <segundos>.

  • API normal: 20 req/burst, 10 conn. Para batch jobs usá los SDKs (tienen backoff).
  • Si necesitás más, pedí un upgrade de plan o un token con elevated rate (Pro+).
  • Para ingestión masiva de Pixel, usá el endpoint /track que tiene 200 req/burst.

3. MCP no conecta desde Claude Desktop / Code

  • Verificá que WAFLE_MCP_TOKEN esté seteado y empiece con wmcp_ (no wpk_).
  • Actualizá: npm i -g @wafle/mcp-server@latest.
  • Reiniciá Claude Desktop / Code después de editar la config.
  • Logs: ~/Library/Logs/Claude/mcp-server-wafle.log (Mac).
  • Si la network del cliente bloquea SSE, probá la variante stdio: "type": "stdio", "command": "npx", "args": ["-y", "@wafle/mcp-server"].

4. Sync de marketplace feeds fallando

Andá a /admin/stores/<slug>/marketplace, columna last sync. Si tiene error, abrí el detalle. Causas comunes:

  • SKUs duplicados — Mercado Libre y Google Shopping rechazan duplicados.
  • Categorías sin mapping — el wizard te deja completar las que faltan.
  • Imágenes < 500x500px (requirement de ML / Google).
  • Token de OAuth expirado — reconectá el feed.

5. Dominio agregado pero SSL pending > 10 min

  • Chequeá CAA records: dig CAA tutienda.com. Si hay CAA que no permite Let's Encrypt, sacalos o agregá letsencrypt.org.
  • Si usás Cloudflare, asegurate que el CNAME esté en DNS only (gris), no proxied.
  • Si propagaste el DNS recientemente, esperá 30 min y reintentá. Let's Encrypt rate-limita reintentos.
  • Si nada funciona, escribinos. Tenemos override manual para casos puntuales.

6. Emails caen en spam

  • Verificá tu dominio en /admin/stores/<slug>/emails/sender. Sin SPF + DKIM + DMARC alineados, Gmail/Outlook castigan.
  • Mirá la sender reputation en /admin/stores/<slug>/emails/quota. Si está < 80, pausá flows masivos por 48 hs y mandá solo transactional.
  • Los emails con muchas imágenes y poco texto suelen ir a Promotions de Gmail. Es OK, siguen siendo entregados.
  • DMARC p=reject es agresivo. Empezá con p=quarantine y subí después de 30 días limpios.

7. “Sin créditos AI” en el dashboard

  • Andá a /admin/account → Créditos AI y mirá la barra. Si llegaste al límite, comprás un pack o esperás al reset mensual.
  • Conectá tu propia cuenta Anthropic (Pro/Max) en /admin/stores/<slug>/integrations/anthropic para no depender de los créditos Wafle.
  • Si ya conectaste Anthropic y igual te dice sin créditos, probable que tu OAuth haya expirado: tocá Reconectar.

8. Pixel no trackea eventos en mi storefront custom

  • Abrí DevTools → Network y filtrá por cdn.wafle.click. Si no aparece, el script no se está cargando: chequeá CSP / ad-blocker / errores de JS arriba.
  • Si el script carga pero no se mandan eventos: revisá que la public key sea wpub_…, no wpk_….
  • Verificá que tu origin (tutienda.com) esté en la allowlist de la public key (/admin/stores/<slug>/integrations → Pixel keys).
  • En SPAs, asegurate de llamar wafle('page_view') manualmente en cada navegación si tu router no dispara History API.

9. Orden creada pero el pago no aparece

Las órdenes pueden quedar en pending si el webhook del gateway no llegó:

  • Mercado Pago: chequeá en MP que https://wafle.click/wp-json/waffle/v1/integrations/mp/webhook esté como notification URL y no haya 4xx en los últimos 7 días.
  • Stripe: en Dashboard → Webhooks, verificá checkout.session.completed enabled.
  • Reintentá manualmente desde /admin/stores/<slug>/payments → Reconciliar.

10. El agente del dashboard no responde / tarda mucho

  • Si conectaste Anthropic Pro, podés estar saturando tu límite de mensajes/hora. Esperá o conectá BYOK como fallback.
  • Las routines pesadas (briefing diario, optimización ads) corren en background — vas a ver el resultado en la inbox, no en el chat.
  • Si el chat tira tool_error: timeout, el endpoint que estaba llamando (ej: un feed externo) tardó más de 60s. Reintentá; si sigue, escribinos.

Status y soporte

Estado en vivo en https://status.wafle.click. Si algo no anda y el status dice OK, escribinos a [email protected] con:

  • Tu tenant slug.
  • Timestamp aproximado del problema (en hora AR).
  • Request ID si lo tenés (header X-Wafle-Request-Id).
  • Steps to reproduce.

Logs propios

bashbash
# Audit log de tu tenant (últimas 100 acciones)
curl "https://wafle.click/wp-json/waffle/v1/audit?per_page=100" \
  -H "Authorization: Bearer wpk_••••"

# Logs de routines (cron de Claude)
curl "https://wafle.click/wp-json/waffle/v1/automation/runs?per_page=20" \
  -H "Authorization: Bearer wpk_••••"

Siguientes