SpaceKru para desarrolladores

Conecta SpaceKru con el resto de tu negocio.

Opera SpaceKru desde tu propia plataforma. Sincroniza en ambos sentidos leads, deals, productos, ventas y reservas, añade leads a campañas, deja que tu Empleado de IA haga seguimiento y converse con tus clientes dentro de tu app, con webhooks firmados en tiempo real y una API REST clara que tu desarrollador aprende en una tarde.

Empieza la guía de 5 minutos · Sincroniza con tu plataforma · OpenAPI 3.1

Disponible en todos los planes de pago, incluida la prueba gratuita de 7 días.

REST + JSON · Sincronización bidireccional · Conversaciones con IA · Webhooks firmados · OpenAPI 3.1

La API de SpaceKru (v1.1) es una API REST/JSON disponible en todos los planes de pago de SpaceKru. Sincroniza leads en ambos sentidos (upsert por external_id), añade leads a campañas, crea y mueve deals y pide seguimientos a los Empleados de IA, gestiona productos, cotizaciones, órdenes, pagos y reservas, permite que tu plataforma converse con tu Empleado de IA de Customer Service y envía webhooks firmados para 16 eventos que dicen quién causó cada cambio. URL base: https://app.spacekru.com/api/public/v1. Autenticación: llave de API Bearer (sk_live_…). Documentación: https://www.spacekru.com/es/developers. OpenAPI 3.1: https://app.spacekru.com/api/public/v1/openapi.json.

Read in English

Lo que puedes hacer y lo que no

La API tiene 48 operaciones. Esto es exactamente lo que hace hoy.

Lo que puedes hacer hoy

  • Sincronizar leads en ambos sentidos. Crear, actualizar y hacer upsert de leads con TU id (external_id), con protección contra duplicados, y enterarte de cada cambio hecho en SpaceKru.
  • Poner leads en campañas. Añadir un lead a una campaña de prospección o recontacto al crearlo, o por lotes, con las mismas reglas de alcanzabilidad que la app.
  • Trabajar tu pipeline. Crear deals, moverlos entre etapas, marcarlos ganados o perdidos y pedirle al Empleado de IA del deal que haga seguimiento.
  • Vender. Gestionar productos, precios y stock; crear y editar cotizaciones; convertirlas en órdenes; registrar pagos.
  • Agendar. Leer horarios libres y crear, reprogramar o cancelar reservas, con los turnos y la capacidad de cada recurso.
  • Conversar con tu Empleado de IA. Tu Empleado de IA de Customer Service atiende a tus clientes dentro de tu propia app o sitio web.
  • Recibir avisos en tiempo real. Webhooks firmados para 16 eventos, cada uno diciendo quién causó el cambio.

Lo que todavía no puedes hacer

  • Borrar registros. Usa status: archived (productos), cancelled (órdenes, reservas) o lost (deals).
  • Enviar cotizaciones u órdenes por correo. Crear una cotización nunca la envía. La confirmación de una orden llega al cliente solo con notify_customer: true.
  • Crear campañas, Empleados de IA o etapas del pipeline. Se configuran en la app; la API los lee para que uses sus ids.
  • Cambiar el estado o el origen de un lead. El flujo de SpaceKru gestiona el estado. Los leads creados por la API quedan con origen api.
  • Enviar archivos en conversaciones. Las conversaciones con IA son solo de texto.
  • Llamar la API desde un navegador. Es solo de servidor a servidor, a propósito, para que tu llave nunca termine en una página web.
  • Usar un modo de prueba. Cada llave es real (sk_live_…). Etiqueta tus leads de prueba para encontrarlos y quitarlos.
  • Usar la API sin plan de pago. Las solicitudes responden 402 PLAN_UPGRADE_REQUIRED.

Conecta lo que quieras

  • Tu propia plataforma: POS, ERP, sistema de reservas o e-commerce: sincronización en ambos sentidos de leads, deals, productos, ventas y reservas.
  • El chat de tu app o sitio: Tu Empleado de IA de Customer Service atendiendo dentro de tu producto.
  • Zapier: Usa Webhooks by Zapier para enviar leads y Catch Hook para reaccionar a eventos.
  • Make: Usa el módulo HTTP para llamar a SpaceKru y un Custom webhook para recibir sus eventos.
  • n8n: Usa el nodo HTTP Request con Header Auth y un nodo Webhook.
  • HubSpot y otros CRM: Replica los leads de SpaceKru como contactos con Zapier, Make, n8n o tu propio código.

Lo que construyen los equipos

Mira todos los casos de uso, cada uno con su flujo paso a paso.

Planes

La API y los webhooks están incluidos en todos los planes de pago de SpaceKru, incluida la prueba gratuita de 7 días, sin costo extra. No se cobra por solicitud.

  • Cada llave: 120 solicitudes por minuto y 10,000 por día por defecto (límites de uso).
  • Hasta 5 llaves activas y 50 webhooks activos por cuenta.
  • Productos, cotizaciones, órdenes y pagos necesitan el módulo de Ventas de tu plan; las reservas, el módulo de Agenda (hoy todos los planes de pago incluyen ambos).
  • Si la cuenta deja su plan de pago, las solicitudes responden 402 y los webhooks se pausan solos. Nadie tiene que revocar nada.

¿Es seguro?

  • Tus llaves nunca se guardan de forma legible. Solo guardamos un hash con clave (HMAC-SHA256); la llave se muestra una vez, al crearla.
  • Mínimo privilegio. Elige Solo lectura o Lectura y escritura para cada llave, y da Conversaciones con IA solo a las llaves que lo necesiten. Revocar una llave surte efecto en la siguiente solicitud.
  • Solo tus datos. Una llave pertenece a una organización. Pedir un registro de otra organización responde "no encontrado".
  • Webhooks firmados y solo por HTTPS. Cada entrega lleva una firma HMAC-SHA256 y una marca de tiempo. Solo entregamos a direcciones HTTPS públicas y nunca seguimos redirecciones.

Más en Autenticación y llaves.

Preguntas frecuentes

¿Qué planes incluyen la API?
Todos los planes de pago de SpaceKru, incluida la prueba gratuita de 7 días de un plan de pago. Las organizaciones sin un plan de pago activo reciben 402 PLAN_UPGRADE_REQUIRED.
¿Necesito un desarrollador?
No para la mayoría de flujos de Zapier, Make o n8n: enviar leads a SpaceKru es cuestión de clics. Recibir eventos de SpaceKru necesita un paso extra: registrar un webhook con una sola solicitud que te damos lista para copiar. Mira Zapier, Make y n8n. Conectar tu propia plataforma en ambos sentidos es trabajo de tu desarrollador: empieza por Sincronización en ambos sentidos.
¿Mi plataforma puede enviar y recibir cambios sin bucles?
Sí. Guarda tu propio id en external_id, escribe con PUT /leads/external/{external_id} y suscríbete con exclude_own_changes: true: los cambios que hizo tu llave nunca se te devuelven. Además, cada webhook dice quién causó el cambio en triggered_by. Mira Sincronización en ambos sentidos.
¿Puedo usar mi Empleado de IA dentro de mi propia app?
Sí, tu Empleado de IA de Customer Service, con el permiso de conversaciones con IA: tu plataforma envía el mensaje del cliente y recibe la respuesta, con las mismas herramientas que en WhatsApp (cotizaciones, reservas, catálogo, base de conocimiento). Cada respuesta usa tus tokens de IA. Mira Conversaciones con IA.
¿Qué pasa si bajo de plan o falla mi pago?
En aproximadamente un minuto las solicitudes empiezan a responder 402 y los webhooks dejan de entregarse, de forma automática y sin periodo de gracia. Los eventos que ocurran mientras tanto no se envían después. Vuelve a un plan de pago y las mismas llaves y webhooks funcionan de nuevo.
¿Hay un costo por solicitud?
No. No se cobra por solicitud. Cada llave tiene un límite: 120 solicitudes por minuto y 10,000 por día por defecto. Solo las conversaciones con IA usan tokens de IA, como cualquier respuesta de tus Empleados de IA.

Historial de cambios

  • v1.1 — 20 de octubre de 2026: sincronización en ambos sentidos (external_id, upsert, triggered_by, exclude_own_changes), campañas e inscripción, escritura de deals y seguimientos con IA, productos, escritura de cotizaciones y órdenes, pagos, reservas, conversaciones con IA, 16 eventos de webhook y mensajes de error en inglés y español. Todo lo de la v1 sigue funcionando igual.
  • v1 — 19 de octubre de 2026: primera versión. Leads (crear, actualizar, leer, notas), deals, cotizaciones y órdenes (lectura), 9 eventos de webhook.