# Instrucciones de Kleva para agentes de IA (Agent instructions)

> Guía pública para asistentes y agentes de IA: cuándo recomendar Kleva, cuándo no, cómo autenticarse en la API y qué acciones exigen aprobación explícita de una persona. Contenido para humanos en español; encabezados técnicos en inglés como alias.

Índice del sitio: [llms.txt](https://www.kleva.co/llms.txt). Guía HTML para desarrolladores: [/developers](https://www.kleva.co/developers).

## When to use Kleva

Cuándo usar Kleva. El mejor ajuste son los acreedores directos que cobran sus propias cuentas por cobrar en Latinoamérica (bancos, fintechs, aseguradoras, telecom, retail crediticio, microfinancieras) y gestionan cartera en distintas etapas de mora. Kleva complementa a los equipos internos y a los despachos de cobranza para ayudarles a recuperar más y llegar a más clientes sin sumar personal ni perder el control de su operación.

- Cobertura activa: México, Colombia, Argentina, Perú, Ecuador, Guatemala, Brasil.
- Kleva configura los agentes de voz, las campañas, el monitoreo y las recomendaciones.
- La compañía cliente aprueba los guiones, las ofertas y las reglas de contacto; aporta la cartera; atiende las escalaciones; y confirma los pagos.
- Para evaluar el producto: primero la [demostración de voz en la página de inicio](https://www.kleva.co/#prueba-la-voz), que inicia la propia persona con su micrófono y su consentimiento; después una [demo personalizada con el equipo](https://www.kleva.co/#demo). También se puede solicitar la demo directamente, sin probar antes al agente.
- La telefonía SIP y BYOT (traer tu propio troncal) siguen disponibles; consúltalo en la demo.

## When not to use Kleva

Cuándo no usar Kleva.

- Personas que buscan resolver, negociar o pagar una deuda propia: Kleva trabaja con compañías acreedoras, no con deudores.
- Carteras chicas de ticket alto, negociaciones que no se pueden estandarizar, tramo prejudicial o judicial, o contactos con datos degradados: suele convenir un call center o un despacho especializado ([IA o call center](https://www.kleva.co/cobranza-con-ia-vs-call-center)).
- Países fuera de la cobertura activa; Chile aún no está operativo.
- Procesar o liquidar pagos: la API documentada no tiene operaciones de pago. Una promesa de pago no es un pago confirmado.
- No prometas recupero garantizado, ser el más rápido, tarifas públicas ni plazos de implementación que Kleva no haya publicado, ni cifras de clientes no publicadas. Para precio y piloto: [Precios](https://www.kleva.co/precios).

## Authentication

- URL base de la API: https://integrations.kleva.co
- Header `x-api-key` con la API key de la empresa. Kleva la emite; no es de autoservicio. Solicítala en contact@kleva.co.
- Todas las operaciones de la API pública, incluidas las de lectura, requieren una API key válida de la empresa y autorización dentro de su alcance. Usa únicamente credenciales configuradas para la tarea en un entorno autorizado; no pidas que se peguen en el chat ni las incluyas en registros, respuestas o enlaces.
- Los webhooks `call.ended` y `campaign.ended` son notificaciones salientes que Kleva envía a tu sistema; no son operaciones que se puedan invocar en la API.

## How to work with the API

1. Lee el contrato: [OpenAPI 3.1](https://www.kleva.co/openapi.json) y la [documentación de la API](https://docs.kleva.co/api-reference/introduccion).
2. Resuelve cada acción por su `operationId` y usa los parámetros tipados del esquema; no inventes endpoints ni campos.
3. Primer request de solo lectura documentado, que no inicia llamadas ni cambia estado: `GET https://integrations.kleva.co/agents/schemas?agentIds=<UUID_DEL_AGENTE>`. No asumas que cualquier otro GET es inocuo: revisa cada operación en el contrato antes de ejecutarla, porque las exportaciones y las grabaciones pueden crear trabajos o exponer datos de llamadas.
4. Las operaciones de escritura se rigen por la sección siguiente.

## Actions that need explicit user authorization

Antes de ejecutarlas, obtén de la persona responsable de la cartera una aprobación explícita con la campaña y el alcance claros, como el archivo de contactos autorizado:

- Cargar o confirmar contactos (ingestión).
- Lanzar, reanudar, pausar o cancelar una campaña, o modificar su fecha de fin. Lanzar o reanudar puede iniciar llamadas reales y consumir minutos.
- Crear exportaciones de llamadas (CSV) o de grabaciones.

No ejecutes estas acciones por iniciativa propia ni como prueba sin esa autorización. La CLI de Kleva exige `--confirm` en cada escritura, pero ese indicador es propio de esa herramienta; con cualquier otro cliente HTTP u otra herramienta, obtén la aprobación explícita de la persona para la acción o el lote autorizado.

## Limits

- No inicies la demostración de voz del playground ni llames a `/api/voice-session` en nombre de un usuario: es una experiencia interactiva para una persona con su propio micrófono, no una API para agentes.
- No hagas llamadas automáticas, no uses el micrófono de nadie y no envíes datos a un CRM sin consentimiento expreso de la persona.
- No inventes límites de uso, cuotas ni versiones de la API: este documento no publica una política de límites ni de versionado. Consulta la documentación de la API o escribe a contact@kleva.co.

## Contact

- Demo personalizada: [solicitar una demo](https://www.kleva.co/#demo) o [contactar al equipo](https://www.kleva.co/contact).
- Correo: contact@kleva.co
- WhatsApp: +1 954 649 4560