Conectá tu Claude

Wafle usa Claude (de Anthropic) como motor del agente que opera tu tienda. Tenés tres formas de pagar el uso del modelo, y podés combinarlas. Esta página explica cuál te conviene, cómo conectarla y qué hacer si algo no funciona.

Spoiler
Si ya tenés Claude Pro o Claude Max personal, conectá esa cuenta. Es lo más barato y simple.

Las tres opciones

Opción A — Login con Anthropic (Pro/Max)

Si tenés cuenta paga en claude.ai, podés autenticar Wafle con OAuth y usar tu suscripción para todo lo que el agente haga adentro de tu tienda. No hay costo extra, el límite es el de tu plan Anthropic.

  • Pro (US$20/mes): suficiente para una tienda con <100 órdenes/día.
  • Max 5x (US$100/mes): para tiendas medianas con varios flows automatizados.
  • Max 20x (US$200/mes): tiendas grandes, multi-staff, múltiples agentes.

Si todavía no tenés cuenta, podés crearla con descuento desde este link (US$10 para vos, US$10 para Wafle).

Cómo conectarla:

  1. Andá a /admin/onboarding/connect-claude (o desde una tienda existente: /admin/stores/<slug>/integrations/anthropic).
  2. Tocá Login with Anthropic. Te redirige a Anthropic para autorizar.
  3. Confirmás el scope (lectura de uso, ejecución de mensajes). Volvés a Wafle.
  4. Listo. El badge cambia a verde y los flows quedan habilitados.

Opción B — BYOK (Bring Your Own Key)

Si tenés saldo prepago en console.anthropic.com, podés pegar una API key directa. Te conviene si:

  • Ya estás usando esa key para otras cosas y querés contabilidad unificada.
  • Necesitás un modelo específico (ej. Opus exclusivamente).
  • Tu equipo de finanzas prefiere prepago a suscripción.
/admin/stores/<slug>/integrations/anthropictext
Anthropic API key  →  sk-ant-api03-•••••••••••••••
Default model      →  claude-opus-4 (recomendado para ops)
                       claude-sonnet-4 (más barato, OK para emails)
                       claude-haiku-4 (background tasks)
Heads up
La key se guarda cifrada con la master key del container del tenant. Solo el agente de esa tienda puede leerla. Aun así, recomendamos usar una key dedicada para Wafle, no la que usás para experimentos personales.

Opción C — Créditos Wafle

Cada plan incluye una bolsa de créditos AI por mes:

  • Free: 500 créditos/mes. Alcanza para cargar un catálogo chico, contestar consultas básicas y mandar emails baseline.
  • Starter: 5.000 créditos/mes.
  • Pro: 50.000 créditos/mes.
  • Scale: 500.000 créditos/mes + descuento por uso.

Si te quedás corto, comprás packs adicionales por el dashboard: /admin/account → Créditos AI. Un crédito Wafle equivale aproximadamente a 1.000 tokens de Claude Sonnet (es una abstracción para no exponerte al pricing cambiante de Anthropic).

¿Cuál uso?

  • Estoy probando → Créditos Wafle del plan Free. Cero setup.
  • Tengo Pro/Max personal y la tienda es mía → Login con Anthropic. Es lo más barato.
  • Tienda mediana en producción → Login con Anthropic Max 5x, fallback a créditos Wafle si te pasás del límite.
  • Empresa con compliance estricto → BYOK con su propia API key enterprise.

Múltiples keys / fallback

Podés cargar más de una credencial. El agente usa la prioridad que vos definas (drag-drop en la UI). Si la primera tira 429 o 401, salta a la siguiente. Útil cuando combinás Pro/Max + BYOK + créditos.

Troubleshooting

“Refresh token not found” / 401 después de un tiempo

El OAuth de Claude expira. Volvé a /admin/stores/<slug>/integrations/anthropic y tocá Reconectar. No vas a perder ningún flow.

“429 rate limit”

Pasaste el límite de tu plan Anthropic. Si tenés multi-key, el agente ya saltó al siguiente. Si no, esperá unos minutos o sumá créditos Wafle como backup.

“Sin créditos AI” en el dashboard

Te quedaste sin la bolsa mensual. Andá a /admin/account → Créditos AI y comprá un pack, o conectá tu propia cuenta Anthropic con login/BYOK para no depender de los créditos Wafle.

El agente no aparece en mi Claude Desktop

Eso es MCP Server — son dos cosas distintas. La opción que configurás acá es el agente dentro del dashboard. Si querés operar tu tienda desde Claude Desktop o Claude Code, mirá la doc de MCP.

Siguientes