Empezar
Crear una clave y hacer la primera llamada en cinco minutos.
La API de Koonni deja que tu sistema —tu CRM, tu formulario, tu sistema de envíos— lea y escriba en tu cuenta: consultar conversaciones y clientes, abrir casos, recibir leads y mandar mensajes de WhatsApp.
1. Crea una clave
En Koonni, ve a Configuración › Para desarrolladores › Claves de API y pulsa «Crear una clave». Ponle el nombre del sistema que la va a usar y marca solo lo que necesita. La clave se enseña una sola vez: guárdala como variable de entorno, nunca en el código.
2. Haz la primera llamada
Todas las direcciones cuelgan de https://app.koonni.com/api/v1, y cada petición lleva la clave en la cabecera Authorization.
curl "https://app.koonni.com/api/v1/conversations?limit=10" \
-H "Authorization: Bearer kn_live_TU_CLAVE"La respuesta es JSON, con los datos en data y, si hay más, un nextCursor para la página siguiente.
3. Lo que conviene saber antes de seguir
- Una clave por sistema. Así, revocar una no deja sin servicio a los demás.
- Una clave no ve el recorte por equipo. Alcanza todo lo que sus permisos dejan, aunque tu empresa limite qué ve cada asesor.
- Ramifica por el código del error, nunca por el texto: el texto es para una persona y puede cambiar.