Todo lo que hace el panel también lo puede hacer tu código. La API del Agente expone el mismo motor que responde en WhatsApp e Instagram — la misma base de conocimiento, la misma memoria por cliente, las mismas herramientas de calendario y catálogo — como una API REST que llamas desde tu producto.

La referencia completa y la gestión de claves están en el portal de desarrolladores.

Cuándo usarla

Ya tienes una app o un sitio y quieres que Waslo responda ahí dentro, no en un canal.
Eres una agencia y quieres operar el agente para tus clientes bajo tu propia marca.
Quieres la clasificación, la memoria o la recuperación de la base de conocimiento por separado, sin la capa de mensajería.

Si solo quieres un agente en WhatsApp o Instagram, no necesitas esto — conecta el canal desde Integraciones.

Una sola llamada

Envía un mensaje y un id de usuario; recibe una respuesta con la memoria, las citas de la base de conocimiento y las acciones de herramientas ya aplicadas.

curl https://api.waslo.io/v1/agent/reply \
  -H "Authorization: Bearer wsk_live_..." \
  -d '{
    "message": "Do you have a morning slot Thursday?",
    "userId": "customer_8842",
    "tools": ["calendar"]
  }'

El userId lo eliges tú: es lo que permite al agente recordar a una persona entre llamadas. Reutilízalo y la conversación continúa; cámbialo y empieza una nueva.

Qué más cubre la API

Área	Qué puedes hacer
Respuestas	Texto, medios (imagen, audio, video, PDF) y salida de voz
Clasificación	Puntuar un mensaje como HOT / WARM / COLD por separado
Memoria	Leer o borrar lo que el agente recuerda de un usuario
Base de conocimiento	Subir, listar y borrar documentos — compartida con el panel
Catálogo	CRUD completo sobre productos — compartido con el panel
Calendario	Conectar Google Calendar o Cal.com sin abrir el panel
Configuración	Definir el prompt y el comportamiento por petición o de forma persistente
Uso	Créditos consumidos, saldo actual, límite de gasto

Todo lo que subes por la API aparece en el panel, y todo lo que añades en el panel es visible para la API. Es un único espacio de trabajo, no dos.

Claves de API

Las claves se crean en el portal de desarrolladores y se muestran una sola vez — se guardan hasheadas, así que no podemos recuperarlas por ti. Cada clave lleva permisos (agent, memory, kb, catalog, config, usage) y solo puede hacer lo que estos permiten. Puedes mantener hasta 10 claves activas por organización y revocar cualquiera cuando quieras.

Trata una clave como una contraseña: solo en el servidor, nunca en un bundle del navegador ni en una app móvil.

Créditos y límites de tasa

La API siempre cobra créditos, en todos los planes — es un producto distinto de tu suscripción de canales, así que una suscripción Growth no hace gratis las llamadas. Las tarifas son más altas que las respuestas de canal porque cada llamada implica más trabajo:

Evento	Créditos
Respuesta de texto	2
Respuesta que usó una herramienta	3
Respuesta que leyó medios	5
Salida de voz	+2
Clasificación	1

Los planes de desarrollador fijan tu límite de tasa y conceden una asignación mensual de créditos además de lo que compres. Sin plan, vuelves a los límites por minuto y por día por defecto. También puedes fijar un límite de gasto mensual para que un bucle descontrolado no vacíe tu saldo — las peticiones se rechazan con spend_cap_reached al alcanzarlo.

Errores

Todos los errores llegan en el mismo sobre, con un request_id que conviene citar si contactas con soporte.

Código	Significado
400	El cuerpo de la petición no pasó la validación
401	Clave de API ausente o inválida
402	Créditos insuficientes, o límite de gasto alcanzado
403	Los permisos de la clave no cubren este endpoint
413	Carga demasiado grande
429	Límite de tasa — reintenta tras el intervalo de la cabecera

Envía la cabecera Idempotency-Key en las respuestas y una llamada repetida en 24 horas devuelve la respuesta original en vez de cobrar dos veces.

Tus usuarios de API no entran en la bandeja del operador

Las conversaciones creadas por la API pertenecen a los usuarios de tu app, no a quien vigila la bandeja de Waslo — por eso están ocultas por defecto en Clientes y Bandeja. Añade ?includeApi=true cuando quieras verlas.

Marca blanca

En el plan White-label una clave maestra puede crear espacios de trabajo aislados por cliente, cada uno con su clave, su base de conocimiento y su catálogo. La cuenta matriz paga todo el uso y obtiene un medidor por inquilino para refacturar; el inquilino nunca ve el saldo de la matriz. Los inquilinos no tienen acceso al panel por diseño — la API es toda su superficie, incluido conectar un calendario.

Siguientes pasos

Portal de desarrolladores — crea una clave, lee la referencia completa, elige plan
Base de conocimiento — lo que el agente lee antes de responder
Catálogo de productos — de dónde puede vender
Por qué esta respuesta — el rastro de razonamiento tras cada respuesta

API del Agente