API y desarrolladores
Tus sistemas, leyendo y escribiendo en Kanesh.
API REST con esquema OpenAPI, un servidor MCP para tus propias herramientas de IA y webhooks firmados, todo con claves de API con permisos y revocables. Disponible en proyectos aprobados, no en autoservicio.
Beta Disponible en proyectos aprobados, no en autoservicio.
Habla con nosotros sobre el acceso a la API# Lista contactos con una clave de sólo lecturacurl https://app.kanesh.example/api/v1/contacts \ -H "Authorization: Bearer kn_live_••••"Demo ilustrativa · datos sintéticos
API REST
Claves que sólo hacen lo que permites.
API REST con esquema OpenAPI y claves con permisos. Da a cada integración su propia clave, sólo con los permisos que necesita.
- Un esquema OpenAPI, para generar un cliente en el lenguaje que uses.
- Claves con permisos: leer, escribir o enviar, recurso a recurso.
- Las claves se guardan como hash y puedes revocarlas cuando quieras.
- Envíos de plantilla idempotentes, para que un reintento no escriba dos veces al mismo cliente.
- Documentación de referencia dentro de la app cuando se aprueba tu proyecto.
Ilustración de la creación de una clave de API: recibe un nombre y sólo los permisos que necesita, la clave se muestra una vez y después se revoca, de modo que las peticiones con ella se rechazan.
Demo ilustrativa · datos sintéticos
Permisos
Lo que puede hacer una clave.
Cada clave recibe sólo los permisos que marques. Éstos son los recursos disponibles hoy.
Lectura
- contacts
- conversations
- messages
- orders
- team
- labels
- usage
- analytics
- attribution
- automations
- campaigns
- clicks
- segments
Escritura
- contacts
- conversations
- labels
- segments
Envío
- templates:send
Los identificadores exactos de cada permiso están en la documentación de referencia para proyectos aprobados.
Servidor MCP
Que tus propias herramientas de IA trabajen con Kanesh.
Un servidor MCP para que tus herramientas de IA lean y actúen sobre tus datos con una clave con permisos.
- Se conecta por HTTP en streaming y se autentica con una clave de API tipo bearer.
- Funciona con clientes MCP que te dejan poner esa clave. No es un conector de un clic para apps de IA de consumo.
Leer
- Contactos
- Conversaciones
- Mensajes
- Pedidos
- Campañas
- Segmentos y miembros
- Automatizaciones
- Métricas
- Atribuciones
Actuar
- Enviar una plantilla de WhatsApp
- Añadir una nota
- Asignar una conversación
- Gestionar etiquetas
- Crear o actualizar un contacto
También en proyectos aprobados
Eventos que salen, mensajes que entran.
Dos piezas más para equipos que necesitan que Kanesh hable con sus propios sistemas.
Webhooks firmados
BetaWebhooks firmados para los eventos clave, para que tu servidor compruebe que cada uno viene de Kanesh. La lista de eventos se comparte con los proyectos aprobados.
Canal propio por API
BetaTrae a la bandeja compartida, a través de la API, las conversaciones de un canal que gestionas tú.
Cómo se accede
Cuatro pasos, sin alta en autoservicio.
- 1
Cuéntanos el proyecto
Qué quieres conectar y qué datos necesita.
- 2
Lo aprobamos
Si encaja, activamos el acceso a la API en tu espacio.
- 3
Claves con permisos
Una clave por integración, sólo con los permisos que necesita.
- 4
Construye y revoca
Trabaja con el esquema OpenAPI. Revoca una clave cuando quieras.
Preguntas de desarrollo
¿Puedo tener una clave de API ya?
¿Hay un SDK?
¿Puedo conectar ChatGPT o Claude?
¿Qué eventos tienen los webhooks?
¿Qué pasa si se filtra una clave?
Diagnóstico gratuito
Cuéntanos qué quieres construir.
El acceso a la API se concede por proyecto. Empieza por el diagnóstico de conversaciones, cuéntanos qué quieres conectar y te diremos con franqueza si encaja.