Saltar al contenido

API y desarrolladores

Tus sistemas, leyendo y escribiendo en Kanesh.

API REST, servidor MCP y webhooks firmados, con claves revocables y con permisos. En proyectos aprobados, no en autoservicio.

Beta Disponible en proyectos aprobados, no en autoservicio.

# Lista contactos con una clave de sólo lecturacurl https://app.kanesh.example/api/v1/contacts \  -H "Authorization: Bearer kn_live_••••"

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.

Tus sistemas también necesitan hablar con tus clientes.

  1. Datos atrapados

    Contactos, conversaciones y pedidos que tu ERP o tu BI no pueden leer.

  2. Avisos que no salen

    Tu sistema sabe que algo pasó, pero no puede enviar la plantilla de WhatsApp adecuada.

  3. Integraciones frágiles

    Scripts sin autenticación ni límites que se rompen en cuanto algo cambia.

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.

Opera Kanesh desde tu IA.

Pide a tu IA que cree informes, configure flujos, prepare campañas y landing pages y gestione clientes a través del MCP, con tus permisos.

Beta
  • 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

  • Crear informes y paneles
  • Configurar pautas y conocimiento de la IA
  • Construir flujos y campañas
  • Crear y publicar landing pages
  • Gestionar CRM, catálogo y pedidos

Eventos que salen, mensajes que entran.

Dos piezas más para equipos que necesitan que Kanesh hable con sus propios sistemas.

  • Webhooks firmados

    Beta

    Webhooks 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

    Beta

    Trae a la bandeja compartida, a través de la API, las conversaciones de un canal que gestionas tú.

Cuatro pasos, sin alta en autoservicio.

  1. 01

    Cuéntanos el proyecto

    Qué quieres conectar y qué datos necesita.

  2. 02

    Lo aprobamos

    Si encaja, activamos el acceso a la API en tu espacio.

  3. 03

    Claves con permisos

    Una clave por integración, sólo con los permisos que necesita.

  4. 04

    Construye y revoca

    Trabaja con el esquema OpenAPI. Revoca una clave cuando quieras.

Preguntas de desarrollo

¿Puedo tener una clave de API ya?
Todavía no. El acceso a la API está disponible en proyectos aprobados: cuéntanos qué quieres construir y, una vez aprobado, tendrás claves con los permisos que necesite.
¿Hay un SDK?
No. Publicamos un esquema OpenAPI para que generes un cliente en el lenguaje que uses.
¿Puedo conectar ChatGPT o Claude?
El servidor MCP funciona con clientes MCP que te dejan poner una clave de API tipo bearer. Los conectores de un clic que necesitan iniciar sesión no están disponibles.
¿Qué eventos tienen los webhooks?
Los webhooks van firmados y cubren los eventos clave. La lista de eventos se comparte con los proyectos aprobados en lugar de publicarse aquí, porque aún puede cambiar.
¿Qué pasa si se filtra una clave?
Revócala. Las peticiones con una clave revocada se rechazan. Las claves se guardan como hash, así que Kanesh tampoco puede volver a enseñarte la clave completa.

Cuéntanos qué quieres construir.

El acceso se concede por proyecto. Cuéntanos en el diagnóstico qué quieres conectar y te diremos con franqueza si encaja.