Llamar a tu CRM desde tu propio código
La API de Builder es HTTPS simple y JSON en mcp.workspace369.com/v1, autenticada con un token de acceso personal. POST /v1/tools/{name} ejecuta cualquier herramienta MCP que permitan los ámbitos de su token, y los atajos REST cubren clientes, propuestas, facturas, contratos, proyectos, tareas, solicitudes y eventos del calendario. Su especificación OpenAPI es pública en /v1/openapi.json. Los webhooks envían 27 eventos a su endpoint, firmados con HMAC-SHA256. Ambos vienen con cada plan desde Cadet; una prueba obtiene acceso una vez que se guarda una tarjeta.
Prueba gratuita de 14 días. Se requiere tarjeta. Después de la prueba: desde $29/mes. Se renueva automáticamente cada mes hasta que canceles. Cancela en cualquier momento en Configuración → Facturación.
Solicitar una demostraciónCada plan a partir de Cadet; una prueba obtiene acceso una vez que se guarda una tarjeta.
- 01
- 8 recursos con 32 operaciones, más POST /v1/tools/{name} para cualquier herramienta MCP que tus ámbitos de token permitan.
- 02
- Enviar una factura, propuesta, contrato o mensaje devuelve 202 y espera la aprobación en la aplicación.
- 03
- 27 eventos de webhook firmados, con hasta 6 intentos de entrega.
¿Qué es una API de CRM?
Una API de CRM permite que tu propio código lea y actualice registros de CRM a través de Internet en lugar de a través de la aplicación. La API Builder de Workspace369 es HTTPS y JSON simple en mcp.workspace369.com/v1, autenticada con un token de acceso personal. POST /v1/tools/{name} ejecuta cualquier herramienta MCP que tus ámbitos de token permitan, y los atajos REST cubren clientes, propuestas, facturas, contratos, proyectos, tareas, solicitudes y eventos de calendario. El envío de una factura, propuesta, contrato o mensaje devuelve un 202 y espera la aprobación en la aplicación Workspace369, a menos que la opción Enviar sin preguntar del token esté activada. Los webhooks firmados envían 27 eventos a tu endpoint cuando el trabajo cambia.
Revisado el 4 de noviembre de 2026 por el Equipo de Producto de Workspace369. La disponibilidad puede variar según el plan, la región y la configuración del espacio de trabajo.
Leer la documentación de la API de BuilderHTTP simple, respuestas reales, negativas claras.
Cada herramienta es una llamada HTTP: POST /v1/tools/{name} ejecuta cualquier herramienta MCP que los alcances de tu token permitan, y los atajos REST cubren clientes, propuestas, facturas, contratos, proyectos, tareas, solicitudes y eventos de calendario. Elige una llamada para ver qué regresa.
- Autenticar con un token de acceso personal: Authorization: Bearer mcp_pat_…
- 8 recursos con 32 operaciones, más POST /v1/tools/{name} para cualquier herramienta MCP que tus ámbitos de token permitan
- Una forma de error para cada rechazo, con un código sobre el que tu código puede ramificarse
Abrir la especificación OpenAPI Lee la guía de la API del Constructor
Solicitud
GET /v1/clients?query=acme&limit=5
Authorization: Bearer mcp_pat_••••
Respuesta
200 OK
{
"clients": [
{ "id": "cl_93Fa", "name": "Acme Co",
"email": "billing@acme.test", "lifecycle_stage": "client" }
]
}Las lecturas vuelven directamente. Página de resultados con un cursor.
Una forma de error, códigos sobre los que puedes ramificar.
Cada rechazo devuelve { "error": { "code", "message", "details" } } con un estado sobre el que tu código puede actuar.
| Código | Estado | Lo que significa |
|---|---|---|
| unauthorized | 401 | El token de acceso personal falta o es inválido. |
| usage_exhausted | 402 | El espacio de trabajo ha agotado su uso mensual de IA. Recarga e inténtalo de nuevo. |
| plan_required | 403 | El espacio de trabajo aún no tiene un plan. La respuesta contiene un enlace de actualización. |
| insufficient_scope | 403 | Al token le falta un alcance. details.required_scope lo nombra. |
| payload_too_large | 413 | El cuerpo de la solicitud tiene más de 1 MB. |
| rate_limited | 429 | Fuera del límite. Espere la cabecera Retry-After, luego reintente. |
Elige los eventos. Verifica cada entrega.
En Configuración, bajo Datos, elige Webhooks y Nuevo webhook, selecciona de 27 eventos y copia el secreto de firma una vez. Cada entrega es un POST JSON firmado.
- Firmado
- X-Webhook-Signature es un HMAC-SHA256 del cuerpo sin procesar más X-Webhook-Timestamp, hecho con tu secreto de firma. Rota el secreto en cualquier momento.
- Reintentado
- Responde con un 2xx en 10 segundos. De lo contrario, la entrega se reintentará hasta 5 veces más, 6 intentos en total, con el mismo X-Webhook-Id. Las entregas se registran durante 30 días.
- Seguro para repetir
- Las entregas pueden llegar en orden incorrecto o más de una vez, así que omite cualquier X-Webhook-Id que ya hayas manejado. Las entregas de Webhook no consumen uso de IA.
Lo que recibe tu endpoint
Selecciona los eventos que necesitas.
27 eventos en 8 familias. Suscríbete a los que necesites, hasta 50 webhooks por espacio de trabajo. La gestión de webhooks requiere el permiso Gestionar webhooks.
| Familia | Eventos |
|---|---|
| Registros de tiempo | time_entry.created, time_entry.updated, time_entry.deleted |
| Hojas de tiempo | timesheet.submitted, timesheet.approved, timesheet.rejected |
| Facturas | invoice.created, invoice.paid, invoice.status_changed |
| Propuestas | proposal.sent, proposal.accepted, proposal.declined |
| Contratos | contract.sent, contract.recipient_completed, contract.completed, contract.declined, contract.voided, contract.expired |
| Reservas | booking.created, booking.rescheduled, booking.cancelled, booking.no_show |
| Solicitudes | lead.created, lead.converted, lead.archived |
| Clientes | client.created, client.stage_changed |
Envía correos electrónicos desde código y conecta tus herramientas de automatización.
La API de correo electrónico es un punto final solo de envío con su propia clave de espacio de trabajo. La aplicación Workspace369 para Zapier (beta; únete con el enlace de invitación en la página de Zapier) inicia Zaps desde ellos, y Make y n8n escuchan los mismos webhooks firmados.
- API de correo electrónicoPOST /v1/email/messages envía correo transaccional con una clave de espacio de trabajo, separada de tus tokens de acceso personal.
- Zapier, Make y n8nÚnete a la aplicación Workspace369 para Zapier (beta) con el enlace de invitación, o inicia automatizaciones de Zapier, Make y n8n desde los webhooks firmados anteriores y llama a la API del Constructor desde sus pasos HTTP.
- Llamar desde tu servidorUn recorrido por la llamada a Workspace369 desde tu propio servidor y la redacción de facturas.
Tokens con límites que tú eliges, y nada oculto.
Una vez que un administrador activa las conexiones de IA, puedes crear un token de acceso personal en Configuración, en IA. Lleva solo los ámbitos y la fecha de caducidad que elijan, y el espacio de trabajo puede verlo y detenerlo.
- Nunca más que su creador
- Cada llamada se verifica en vivo contra el rol del miembro, por lo que un token no puede hacer lo que su creador no puede.
- Cada llamada se registra
- El registro de llamadas registra la aplicación, el miembro, la herramienta, el alcance, el resultado y el uso de IA. Mantiene los nombres de los campos, nunca los valores.
- Los administradores pueden revocar cualquier token
- Los administradores del espacio de trabajo ven los tokens de cada miembro. Un token revocado deja de funcionar inmediatamente.
- Un ritmo constante
- Hasta 120 llamadas por minuto por token y 600 por espacio de trabajo, compartidas con MCP, con un cuerpo de solicitud de 1 MB. Por encima del límite, obtienes un 429 con Retry-After.
La API y los webhooks en todos los planes, desde Cadet.
La API de Builder en mcp.workspace369.com/v1 y los webhooks firmados vienen con cada plan desde Cadet. Una prueba obtiene acceso una vez que se guarda una tarjeta. Cada llamada exitosa utiliza el mismo uso de IA que la llamada MCP correspondiente.
Comparar planes- herramientas en el servidor
- 127
- eventos webhook
- 27
- llamadas por minuto por token
- 120
| Planes | Cadet$29/mes | Voyager$74/mes | Specialist$149/mes | Commander$299/mes | Enterprise$699/mes | |
|---|---|---|---|---|---|---|
| API del Constructor | Cada plan | Incluido | Incluido | Incluido | Incluido | Incluido |
| Webhooks | Cada plan | Incluido | Incluido | Incluido | Incluido | Incluido |
| Conexiones de IA (MCP) | Cada plan | Incluido | Incluido | Incluido | Incluido | Incluido |
Las llamadas fallidas o rechazadas no utilizan IA.
Preguntas sobre la API del Constructor y Webhooks
¿Qué planes incluyen la API del creador?
Cada plan a partir de Cadet, y una prueba gratuita obtiene acceso una vez que se guarda una tarjeta en Facturación. Un propietario o administrador debe haber activado Permitir conexiones de IA en Configuración, en IA. Los webhooks también vienen con cada plan a partir de Cadet.#
¿La prueba gratuita incluye la API?
Sí, una vez que se guarda una tarjeta. La prueba de 14 días tiene entonces la API Builder y webhooks como cualquier plan.#
¿Cómo me autentico?
Crea un token de acceso personal en Configuración, en IA, con Crear token. Elige sus permisos y caducidad (30 días, 90 días, 1 año o ninguno), cópialo una vez y envíalo como Authorization: Bearer mcp_pat_... en cada solicitud. Cada llamada se verifica contra los permisos activos del miembro que la crea, así como los alcances del token.#
¿Dónde está la especificación OpenAPI?
Es público, sin necesidad de token, en /v1/openapi.json en el mismo host. Está construido a partir del registro de herramientas en vivo, por lo que coincide con lo que el servidor acepta.#
¿Cómo verifico un webhook?
Cada entrega lleva X-Webhook-Signature, X-Webhook-Timestamp y X-Webhook-Id. La firma es un HMAC-SHA256 hexadecimal del cuerpo de la solicitud sin procesar seguido de la marca de tiempo, realizado con tu secreto de firma. Responde con un 2xx en 10 segundos; las entregas fallidas se reintentan hasta 5 veces más, y X-Webhook-Id permanece igual en cada reintento.#
¿Las llamadas API consumen uso de IA?
Sí. Cada llamada exitosa utiliza el mismo uso de IA que la llamada MCP correspondiente, de la asignación mensual del plan. Las llamadas fallidas o rechazadas no consumen nada, y las entregas de webhooks no consumen nada.#
¿Debo usar la API o MCP?
Usa la API del Constructor cuando tu propio código o un script realice las llamadas. Usa el servidor MCP cuando una aplicación de IA como Claude o ChatGPT las realice. Ambos ejecutan las mismas herramientas con los mismos permisos, aprobaciones, límites de tasa y registro de auditoría.#
Apunta tu código a un espacio de trabajo donde los envíos esperan un sí por defecto.
Inicia una prueba, guarda una tarjeta, crea un token de acceso personal en Configuración y haz tu primera llamada.
Prueba gratuita de 14 días. Se requiere tarjeta. Después de la prueba: desde $29/mes. Se renueva automáticamente cada mes hasta que canceles. Cancela en cualquier momento en Configuración → Facturación.
Ver precios14 días gratis · se requiere tarjeta · luego $29/mes · cancela cuando quieras