La API de zerosoft.
REST y JSON.

Link, CRM, Cal, Track, Docs, Chat, Agents y la mayoría de las otras apps tienen API REST con respuestas JSON y claves personales.

Descargar la spec OpenAPI 3.1 Conectar Claude y la CLI

Base URL

https://zerosoft.ai/api/v1

Autenticación

Cada request necesita una API key, enviada como Bearer token. Para sesiones de navegador, el flujo OAuth de Google crea la cookie de sesión.

Authorization: Bearer zs_live_9f3k...

Creá las keys en Dashboard → Settings → API keys. La key se muestra una sola vez: copiala y guardala como una contraseña. Cada key permite 100 requests por minuto.

Cada key tiene scopes, que se eligen al crearla. Los de escritura incluyen lectura. Las keys creadas antes de los scopes tienen todos. Un request sin el scope necesario recibe 403 insufficient_scope.

ScopeDescripción
crm:readLeer contactos, empresas, deals, actividades, tareas, pipelines, productos, cotizaciones, tags, templates, secuencias y formularios.
crm:writeCrear, editar y borrar registros del CRM, inscribir en secuencias y etiquetar (incluye crm:read).
links:readListar links y leer sus estadísticas.
links:writeCrear, editar y borrar links cortos (incluye links:read).
cal:readListar tipos de evento y reservas.
cal:writeCrear y cancelar reservas (incluye cal:read).
agents:runEnviar mensajes a tus agentes de AI.
robots:runListar y correr robots, y leer sus corridas y lotes.
chat:readListar las conversaciones de Chat y leer sus mensajes.
chat:writeResponder, asignar, resolver y reabrir conversaciones de Chat (incluye chat:read).
groups:readLeer chats, mensajes y tickets de WhatsApp en Lines.
groups:writeMandar mensajes de WhatsApp y crear tickets en Lines.
voice:readLeer dictados, reuniones y transcripciones de Voice.
voice:writeDictar y subir audio de reuniones a Voice.
track:readLeer issues y pedidos de clientes de Track.
track:writeCrear issues de Track desde pedidos de clientes (email, formularios, Flow).
docs:readLeer páginas, bases, filas y comentarios de Docs, y buscar.
docs:writeCrear y editar páginas, filas y comentarios de Docs (incluye docs:read).
talk:readLeer canales y mensajes de Talk donde sos miembro.
talk:writePublicar mensajes y crear canales en Talk.
boards:readLeer pizarras, su resumen y buscar adentro.
boards:writeCrear pizarras, sumar stickies y formas, renombrarlas, moverlas y mandarlas a la papelera.
design:readLeer diseños de Design y sus páginas.
shop:readLeer productos y pedidos de Shop.
shop:writeCrear productos de Shop.
hiring:readLeer los puestos de Hiring y los candidatos que ve quien creó la key.
sign:readLeer los sobres de Sign que ve la persona dueña de la key (sin archivos).
analytics:readLeer proyectos, eventos y personas de Pulse y correr consultas.
analytics:writeCambiar proyectos, insights, tableros, cohortes y flags de Pulse.
bi:readLeer preguntas, tableros y colecciones de Analytics y correr consultas.
bi:writeCrear y cambiar preguntas, tableros, colecciones y suscripciones de Analytics.
social:readLeer publicaciones de Social de las cuentas que ves.
social:writeCrear borradores y publicaciones programadas en Social (con aprobación si la necesitás).
people:readLeer el directorio de People: solo campos públicos de la ficha, nunca sueldo ni datos personales.
books:readLeer facturas de Books (con el rol de Books de quien creó la key).
books:writeCrear facturas borrador en Books.
forms:readLeer los formularios de Forms y sus respuestas, solo los que puede ver quien creó la key.
send:readLeer los documentos que la persona ve, con sus links y visitas.
calls:readLeer las llamadas que la persona ve, con transcripciones y análisis.
calls:writeCrear y editar llamadas, comentarios y clips, y mandar el notetaker a una reunión.
notes:readLeer las notas que puede ver quien creó la clave, y sus tareas.
notes:writeCrear y editar las notas de quien creó la clave.

Una key actúa como la persona que la creó: si tu workspace limita a los members a sus registros del CRM (o a los de su equipo), la API devuelve solo esos registros.

Inicio de sesión con Google

GET/api/auth/signin/google

Redirigí al usuario para iniciar el flujo OAuth de Google. Tras el éxito vuelve a la app con la cookie de sesión.

curl -X GET "https://zerosoft.ai/api/auth/signin/google" \
  -H "Authorization: Bearer zs_live_9f3k..."

CRM · Contactos

Personas y leads.

Listar contactos

GET/api/v1/crm/contacts

Lista contactos. Filtros: q, page, pageSize (máx 100).

Scope crm:read

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
lifecyclestringNoEtapa del ciclo de vida (lead, sql, opportunity, customer).
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/contacts" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "contacts": [
    {
      "id": "b1f47ac2-…",
      "first_name": "Ana",
      "last_name": "Garcia",
      "email": "ana@kallpa.co",
      "lifecycle_stage": "sql",
      "company_id": null,
      "created_at": "2026-07-18 10:04:11"
    }
  ],
  "total": 142,
  "page": 1,
  "pageSize": 25
}

Crear un contacto

POST/api/v1/crm/contacts

Crea un contacto nuevo.

Scope crm:write

NombreTipoRequeridoDescripción
firstNamestringNoNombre.
lastNamestringNoApellido.
emailstringNoDirección de email.
lifecycleStagestringNoEtapa del ciclo de vida (lead, sql, opportunity, customer).
companyIdstringNoId de la empresa vinculada.
curl -X POST "https://zerosoft.ai/api/v1/crm/contacts" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "firstName": "Ana",
  "lastName": "Garcia",
  "email": "ana@kallpa.co",
  "lifecycleStage": "sql"
}'

Request

{
  "firstName": "Ana",
  "lastName": "Garcia",
  "email": "ana@kallpa.co",
  "lifecycleStage": "sql"
}

Respuesta · 201

{
  "id": "b1f47ac2-…",
  "first_name": "Ana",
  "last_name": "Garcia",
  "email": "ana@kallpa.co",
  "lifecycle_stage": "sql",
  "created_at": "2026-07-18 10:04:11"
}

Leer un contacto

GET/api/v1/crm/contacts/{id}

Lee un contacto por id.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/contacts/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Actualizar un contacto

PATCH/api/v1/crm/contacts/{id}

Actualizá cualquier propiedad de un contacto.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
firstNamestringNoNombre.
lifecycleStagestringNoEtapa del ciclo de vida (lead, sql, opportunity, customer).
companyIdstring | nullNoId de la empresa primaria. Se asocia si hace falta; la primaria anterior queda asociada. null quita la primaria.
curl -X PATCH "https://zerosoft.ai/api/v1/crm/contacts/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "lifecycleStage": "opportunity"
}'

Request

{
  "lifecycleStage": "opportunity"
}

Borrar un contacto

DELETE/api/v1/crm/contacts/{id}

Borra el contacto de forma definitiva. Sus actividades quedan, sin vincular.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/contacts/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

CRM · Empresas

Organizaciones y cuentas.

Listar empresas

GET/api/v1/crm/companies

Lista empresas. Filtros: q, page, pageSize.

Scope crm:read

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/companies" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "companies": [
    {
      "id": "c7a1…",
      "name": "Norte Labs",
      "domain": "nortelabs.co",
      "industry": "Software"
    }
  ],
  "total": 40,
  "page": 1,
  "pageSize": 25
}

Crear una empresa

POST/api/v1/crm/companies

Crea una empresa nueva.

Scope crm:write

NombreTipoRequeridoDescripción
namestringSíNombre de la empresa.
domainstringNoNombre de dominio.
industrystringNoIndustria.
parentCompanyIdstring | nullNoId de la empresa madre (jerarquía). null la deja en el nivel superior. Una empresa no puede ser su propia antecesora.
curl -X POST "https://zerosoft.ai/api/v1/crm/companies" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "Norte Labs",
  "domain": "nortelabs.co",
  "industry": "Software"
}'

Request

{
  "name": "Norte Labs",
  "domain": "nortelabs.co",
  "industry": "Software"
}

Leer una empresa

GET/api/v1/crm/companies/{id}

Lee una empresa por id.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/companies/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Actualizar una empresa

PATCH/api/v1/crm/companies/{id}

Actualizá cualquier propiedad de una empresa.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
namestringNoNombre de la empresa.
domainstringNoNombre de dominio.
industrystringNoIndustria.
parentCompanyIdstring | nullNoId de la empresa madre (jerarquía). null la deja en el nivel superior. Una empresa no puede ser su propia antecesora.
curl -X PATCH "https://zerosoft.ai/api/v1/crm/companies/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "industry": "Cloud infrastructure",
  "parentCompanyId": "{company_id}"
}'

Request

{
  "industry": "Cloud infrastructure",
  "parentCompanyId": "{company_id}"
}

Borrar una empresa

DELETE/api/v1/crm/companies/{id}

Borra la empresa de forma definitiva. Los contactos siguen existiendo sin empresa.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/companies/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

CRM · Deals

Oportunidades y pipelines.

Listar deals

GET/api/v1/crm/deals

Lista deals. Filtro: pipelineId.

Scope crm:read

NombreTipoRequeridoDescripción
pipelineIdstringNoId del pipeline.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/deals" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "deals": [
    {
      "id": "d9e2…",
      "name": "Norte Labs — New business",
      "amount": 24000,
      "currency": "USD",
      "stage_id": "{stage_id}"
    }
  ],
  "total": 36,
  "page": 1,
  "pageSize": 25
}

Crear un deal

POST/api/v1/crm/deals

Crea un deal en una etapa del pipeline.

Scope crm:write

NombreTipoRequeridoDescripción
pipelineIdstringSíId del pipeline.
stageIdstringSíId de la etapa.
namestringNoNombre del deal.
amountnumberNoMonto del deal.
currencystringNoCódigo de moneda.
contactIdsstring[]NoIDs de los contactos a inscribir (1–500).
companyIdstringNoEmpresa primaria del deal.
companyIdsstring[]NoOtras empresas para asociar al deal.
curl -X POST "https://zerosoft.ai/api/v1/crm/deals" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "pipelineId": "{pipeline_id}",
  "stageId": "{stage_id}",
  "name": "Norte Labs — New business",
  "amount": 24000,
  "currency": "USD",
  "contactIds": [
    "{contact_id}"
  ],
  "companyId": "{company_id}"
}'

Request

{
  "pipelineId": "{pipeline_id}",
  "stageId": "{stage_id}",
  "name": "Norte Labs — New business",
  "amount": 24000,
  "currency": "USD",
  "contactIds": [
    "{contact_id}"
  ],
  "companyId": "{company_id}"
}

Leer un deal

GET/api/v1/crm/deals/{id}

Lee un deal por id.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/deals/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Actualizar un deal

PATCH/api/v1/crm/deals/{id}

Actualizá monto, etapa o fechas.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
namestringNoNombre del deal.
amountnumberNoMonto del deal.
addContactIdsstring[]NoIDs de los contactos a inscribir (1–500).
companyIdstringNoEmpresa primaria del deal.
amountOverridebooleanNotrue mantiene un monto manual aunque haya line items; false lo recalcula desde los line items. Editar el monto de un deal con line items lo activa.
curl -X PATCH "https://zerosoft.ai/api/v1/crm/deals/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "amount": 28000,
  "closeDate": "2026-11-30",
  "amountOverride": true
}'

Request

{
  "amount": 28000,
  "closeDate": "2026-11-30",
  "amountOverride": true
}

Mover un deal de etapa

POST/api/v1/crm/deals/{id}/move

Mueve el deal a otra etapa de su pipeline. Las etapas ganado/perdido lo cierran; perdido necesita lostReason. Si la etapa pide propiedades que el deal no tiene, responde 422 missing_required con la lista; mandalas en fields para completarlas y mover en un solo llamado. Dispara deal.stage_changed (y deal.won / deal.lost).

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
stageIdstringSíId de la etapa.
lostReasonstringNoPor qué se perdió (obligatorio en etapas de perdido).
fieldsobjectNoPropiedades que pide la etapa, se guardan antes de mover: amount, closeDate, ownerId, priority, source, description y custom (valores de custom fields por nombre).
curl -X POST "https://zerosoft.ai/api/v1/crm/deals/{id}/move" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "stageId": "{stage_id}"
}'

Request

{
  "stageId": "{stage_id}"
}

Borrar un deal

DELETE/api/v1/crm/deals/{id}

Borra el deal de forma definitiva.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/deals/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

CRM · Actividades

El timeline de un contacto, empresa o deal: notas, llamadas, reuniones, emails y tareas. Las reuniones agendadas en Cal aparecen acá solas.

Listar el timeline de un registro

GET/api/v1/crm/activities

Más recientes primero. Pasá uno solo de contactId, companyId o dealId.

Scope crm:read

NombreTipoRequeridoDescripción
contactId | companyId | dealIdstringSíEl registro cuyo timeline querés.
typenote | task | call | meeting | emailNoTipo de actividad.
limitintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/activities" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "activities": [
    {
      "id": "a12…",
      "type": "meeting",
      "subject": "Intro call",
      "due_at": "2026-11-03 13:00:00",
      "duration_min": 30,
      "contact_id": "{contact_id}"
    }
  ]
}

Registrar una actividad

POST/api/v1/crm/activities

Registrá una nota, llamada, reunión o email en un registro. Las tareas tienen su propio endpoint.

Scope crm:write

NombreTipoRequeridoDescripción
typenote | call | meeting | emailSíTipo de actividad.
subjectstringNoAsunto de la tarea.
bodystringNoTexto libre: notas, resumen de la llamada, cuerpo del email.
contactIdstringNoId del contacto vinculado.
dealIdstringNoId del deal vinculado.
curl -X POST "https://zerosoft.ai/api/v1/crm/activities" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "type": "call",
  "subject": "Discovery call",
  "body": "Budget approved for Q1.",
  "durationMin": 25,
  "contactId": "{contact_id}"
}'

Request

{
  "type": "call",
  "subject": "Discovery call",
  "body": "Budget approved for Q1.",
  "durationMin": 25,
  "contactId": "{contact_id}"
}

CRM · Tareas

Actividades y seguimientos.

Listar tareas

GET/api/v1/crm/tasks

Lista tareas. bucket: overdue, today, upcoming, done.

Scope crm:read

NombreTipoRequeridoDescripción
bucketoverdue | today | upcoming | doneNoBucket de filtro: overdue, today, upcoming, done.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/tasks" \
  -H "Authorization: Bearer zs_live_9f3k..."

Crear una tarea

POST/api/v1/crm/tasks

Crea una tarea, opcionalmente ligada a un registro.

Scope crm:write

NombreTipoRequeridoDescripción
subjectstringSíAsunto de la tarea.
dueAtstring (ISO 8601)NoFecha de vencimiento en formato ISO.
contactIdstringNoId del contacto vinculado.
companyIdstringNoId de la empresa vinculada.
dealIdstringNoId del deal vinculado.
curl -X POST "https://zerosoft.ai/api/v1/crm/tasks" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "subject": "Follow-up call",
  "dueAt": "2026-07-25T15:00:00Z",
  "dealId": "{deal_id}"
}'

Request

{
  "subject": "Follow-up call",
  "dueAt": "2026-07-25T15:00:00Z",
  "dealId": "{deal_id}"
}

Actualizar una tarea

PATCH/api/v1/crm/tasks/{id}

Editá o completá una tarea.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
subjectstringNoAsunto de la tarea.
donebooleanNoMarcar como hecha.
curl -X PATCH "https://zerosoft.ai/api/v1/crm/tasks/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "done": true
}'

Request

{
  "done": true
}

CRM · Pipelines y etapas

Pipelines de venta y sus etapas.

Listar pipelines

GET/api/v1/crm/pipelines

Lista pipelines con sus etapas.

Scope crm:read

curl -X GET "https://zerosoft.ai/api/v1/crm/pipelines" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "pipelines": [
    {
      "id": "{pipeline_id}",
      "name": "Sales",
      "position": 0,
      "stages": [
        {
          "id": "{stage_id}",
          "name": "Qualified",
          "position": 0,
          "probability": 20,
          "isWon": false,
          "isLost": false
        },
        {
          "id": "{stage_id}",
          "name": "Won",
          "position": 5,
          "probability": 100,
          "isWon": true,
          "isLost": false
        }
      ]
    }
  ]
}

CRM · Productos y line items

Catálogo de productos y los line items de cada deal. Mientras un deal tenga line items, su monto es la suma de los netos (después del descuento, antes de impuestos), salvo que amountOverride esté activo.

Listar productos

GET/api/v1/crm/products

Productos del catálogo, primero los activos, ordenados por nombre.

Scope crm:read

NombreTipoRequeridoDescripción
qstringNoBuscar por nombre o SKU.
activebooleanNotrue = solo activos, false = solo archivados.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/products" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "products": [
    {
      "id": "{product_id}",
      "name": "Pro plan",
      "sku": "PRO-Y",
      "description": "",
      "price": 1200,
      "currency": "USD",
      "recurring": "yearly",
      "tax_pct": 21,
      "active": 1,
      "created_at": "2026-10-13 12:00:00",
      "updated_at": "2026-10-13 12:00:00"
    }
  ],
  "total": 12,
  "page": 1,
  "pageSize": 25
}

Crear un producto

POST/api/v1/crm/products

Agrega un producto al catálogo. Sin moneda, usa la moneda base del workspace.

Scope crm:write

NombreTipoRequeridoDescripción
namestringSíNombre del producto.
skustringNoSKU o código interno.
descriptionstringNoDescripción que se muestra en line items y cotizaciones.
pricenumberNoPrecio unitario.
currencystringNoCódigo de moneda ISO (por defecto, la moneda base del workspace).
recurringnone | monthly | yearlyNoFacturación: none, monthly o yearly.
taxPctnumberNoPorcentaje de impuesto (0-100).
activebooleanNofalse archiva el producto (no aparece en los selectores).
curl -X POST "https://zerosoft.ai/api/v1/crm/products" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pro plan",
  "sku": "PRO-Y",
  "price": 1200,
  "currency": "USD",
  "recurring": "yearly",
  "taxPct": 21
}'

Request

{
  "name": "Pro plan",
  "sku": "PRO-Y",
  "price": 1200,
  "currency": "USD",
  "recurring": "yearly",
  "taxPct": 21
}

Respuesta · 201

{
  "id": "{product_id}",
  "name": "Pro plan",
  "sku": "PRO-Y",
  "description": "",
  "price": 1200,
  "currency": "USD",
  "recurring": "yearly",
  "tax_pct": 21,
  "active": 1,
  "created_at": "2026-10-13 12:00:00",
  "updated_at": "2026-10-13 12:00:00"
}

Obtener un producto

GET/api/v1/crm/products/{id}

Devuelve un producto.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/products/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "{product_id}",
  "name": "Pro plan",
  "sku": "PRO-Y",
  "description": "",
  "price": 1200,
  "currency": "USD",
  "recurring": "yearly",
  "tax_pct": 21,
  "active": 1,
  "created_at": "2026-10-13 12:00:00",
  "updated_at": "2026-10-13 12:00:00"
}

Actualizar un producto

PATCH/api/v1/crm/products/{id}

Actualiza los campos que mandes. Los line items que ya están en deals no cambian.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
pricenumberNoPrecio unitario.
activebooleanNofalse archiva el producto (no aparece en los selectores).
curl -X PATCH "https://zerosoft.ai/api/v1/crm/products/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "price": 1320,
  "active": true
}'

Request

{
  "price": 1320,
  "active": true
}

Eliminar un producto

DELETE/api/v1/crm/products/{id}

Elimina el producto. Los line items que lo usaban quedan en sus deals como ítems custom.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/products/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Listar los line items de un deal

GET/api/v1/crm/deals/{id}/line-items

Line items con subtotal, descuento, neto, impuesto y total calculados, más los totales del deal. Los montos se redondean por línea a la moneda del deal.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del deal.
curl -X GET "https://zerosoft.ai/api/v1/crm/deals/{id}/line-items" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "currency": "USD",
  "items": [
    {
      "id": "{line_item_id}",
      "deal_id": "{deal_id}",
      "product_id": "{product_id}",
      "name": "Pro plan",
      "sku": "PRO-Y",
      "description": "",
      "quantity": 2,
      "unit_price": 1200,
      "discount_pct": 10,
      "tax_pct": 21,
      "recurring": "yearly",
      "position": 0,
      "subtotal": 2400,
      "discount": 240,
      "net": 2160,
      "tax": 453.6,
      "total": 2613.6,
      "created_at": "2026-10-13 12:00:00",
      "updated_at": "2026-10-13 12:00:00"
    }
  ],
  "totals": {
    "subtotal": 2400,
    "discount": 240,
    "net": 2160,
    "tax": 453.6,
    "total": 2613.6
  },
  "amountOverride": false
}

Agregar un line item

POST/api/v1/crm/deals/{id}/line-items

Desde un producto (copia nombre, precio, impuesto y recurrencia; el precio se convierte a la moneda del deal si hay tipo de cambio) o custom (nombre y unitPrice). Recalcula el monto del deal.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del deal.
productIdstringNoId del producto del catálogo. Omitilo para un line item custom.
namestringNoNombre del line item (obligatorio en ítems custom).
quantitynumberNoCantidad (puede tener decimales).
unitPricenumberNoPrecio unitario en la moneda del deal.
discountPctnumberNoPorcentaje de descuento (0-100).
taxPctnumberNoPorcentaje de impuesto (0-100).
curl -X POST "https://zerosoft.ai/api/v1/crm/deals/{id}/line-items" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "productId": "{product_id}",
  "quantity": 2,
  "discountPct": 10
}'

Request

{
  "productId": "{product_id}",
  "quantity": 2,
  "discountPct": 10
}

Respuesta · 201

{
  "id": "{line_item_id}",
  "deal_id": "{deal_id}",
  "product_id": "{product_id}",
  "name": "Pro plan",
  "sku": "PRO-Y",
  "description": "",
  "quantity": 2,
  "unit_price": 1200,
  "discount_pct": 10,
  "tax_pct": 21,
  "recurring": "yearly",
  "position": 0,
  "subtotal": 2400,
  "discount": 240,
  "net": 2160,
  "tax": 453.6,
  "total": 2613.6,
  "created_at": "2026-10-13 12:00:00",
  "updated_at": "2026-10-13 12:00:00"
}

Actualizar un line item

PATCH/api/v1/crm/deals/{id}/line-items/{itemId}

Actualiza cantidad, precio, descuento, impuesto o texto y recalcula el monto del deal.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del deal.
itemIdstringSíId del line item.
quantitynumberNoCantidad (puede tener decimales).
discountPctnumberNoPorcentaje de descuento (0-100).
curl -X PATCH "https://zerosoft.ai/api/v1/crm/deals/{id}/line-items/{itemId}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "quantity": 3,
  "discountPct": 15
}'

Request

{
  "quantity": 3,
  "discountPct": 15
}

Eliminar un line item

DELETE/api/v1/crm/deals/{id}/line-items/{itemId}

Quita el line item y recalcula el monto del deal.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del deal.
itemIdstringSíId del line item.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/deals/{id}/line-items/{itemId}" \
  -H "Authorization: Bearer zs_live_9f3k..."

CRM · Cotizaciones

Cotizaciones creadas desde los line items de un deal. Cada una guarda una copia de los ítems y tiene una página pública (public_url) donde el cliente acepta o rechaza. Al aceptar se dispara el evento de Flow quote.accepted y el trigger de workflow quote_accepted.

Listar cotizaciones

GET/api/v1/crm/quotes

Cotizaciones del workspace, de la más nueva a la más vieja. Las enviadas que pasaron su vencimiento vuelven como expired.

Scope crm:read

NombreTipoRequeridoDescripción
dealIdstringNoSolo las cotizaciones de este deal.
statusdraft | sent | accepted | declined | expiredNoFiltrar por estado.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/quotes" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "quotes": [
    {
      "id": "{quote_id}",
      "deal_id": "{deal_id}",
      "deal_name": "Norte Labs — New business",
      "number": "Q-2026-0003",
      "title": "Norte Labs — Pro plan",
      "status": "draft",
      "currency": "USD",
      "items": [
        {
          "name": "Pro plan",
          "sku": "PRO-Y",
          "description": "",
          "quantity": 2,
          "unit_price": 1200,
          "discount_pct": 10,
          "tax_pct": 21,
          "recurring": "yearly",
          "subtotal": 2400,
          "discount": 240,
          "net": 2160,
          "tax": 453.6,
          "total": 2613.6
        }
      ],
      "subtotal": 2400,
      "discount_total": 240,
      "tax_total": 453.6,
      "total": 2613.6,
      "expires_at": "2026-11-30",
      "terms": "Payment within 30 days of acceptance.",
      "notes": "",
      "sender_name": "Lucía Pérez",
      "sender_email": "lucia@zerosoft.ai",
      "sender_company": "Zerosoft",
      "recipient_name": "Ana Garcia",
      "recipient_email": "ana@nortelabs.co",
      "recipient_company": "Norte Labs",
      "sent_at": null,
      "accepted_at": null,
      "declined_at": null,
      "signer_name": "",
      "public_url": "https://zerosoft.ai/q/7Jx2kQ…",
      "created_at": "2026-10-13 12:00:00"
    }
  ],
  "total": 3,
  "page": 1,
  "pageSize": 25
}

Crear una cotización

POST/api/v1/crm/quotes

Crea una cotización en borrador con los line items actuales del deal (necesita al menos uno). Por defecto vence en 30 días y el destinatario es el primer contacto y la empresa primaria del deal.

Scope crm:write

NombreTipoRequeridoDescripción
dealIdstringSíDeal cuyos line items arman la cotización.
titlestringNoTítulo de la cotización (por defecto, el nombre del deal).
expiresAtstringNoFecha de vencimiento, YYYY-MM-DD.
termsstringNoTérminos y condiciones.
notesstringNoNotas para el cliente.
senderNamestringNoDatos del remitente que se muestran en la cotización.
senderEmailstringNoDatos del remitente que se muestran en la cotización.
senderCompanystringNoDatos del remitente que se muestran en la cotización.
recipientNamestringNoDatos del destinatario (por defecto: primer contacto y empresa primaria del deal).
recipientEmailstringNoDatos del destinatario (por defecto: primer contacto y empresa primaria del deal).
recipientCompanystringNoDatos del destinatario (por defecto: primer contacto y empresa primaria del deal).
curl -X POST "https://zerosoft.ai/api/v1/crm/quotes" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "dealId": "{deal_id}",
  "title": "Norte Labs — Pro plan",
  "expiresAt": "2026-11-30",
  "terms": "Payment within 30 days of acceptance.",
  "senderName": "Lucía Pérez",
  "senderEmail": "lucia@zerosoft.ai",
  "senderCompany": "Zerosoft"
}'

Request

{
  "dealId": "{deal_id}",
  "title": "Norte Labs — Pro plan",
  "expiresAt": "2026-11-30",
  "terms": "Payment within 30 days of acceptance.",
  "senderName": "Lucía Pérez",
  "senderEmail": "lucia@zerosoft.ai",
  "senderCompany": "Zerosoft"
}

Respuesta · 201

{
  "id": "{quote_id}",
  "deal_id": "{deal_id}",
  "deal_name": "Norte Labs — New business",
  "number": "Q-2026-0003",
  "title": "Norte Labs — Pro plan",
  "status": "draft",
  "currency": "USD",
  "items": [
    {
      "name": "Pro plan",
      "sku": "PRO-Y",
      "description": "",
      "quantity": 2,
      "unit_price": 1200,
      "discount_pct": 10,
      "tax_pct": 21,
      "recurring": "yearly",
      "subtotal": 2400,
      "discount": 240,
      "net": 2160,
      "tax": 453.6,
      "total": 2613.6
    }
  ],
  "subtotal": 2400,
  "discount_total": 240,
  "tax_total": 453.6,
  "total": 2613.6,
  "expires_at": "2026-11-30",
  "terms": "Payment within 30 days of acceptance.",
  "notes": "",
  "sender_name": "Lucía Pérez",
  "sender_email": "lucia@zerosoft.ai",
  "sender_company": "Zerosoft",
  "recipient_name": "Ana Garcia",
  "recipient_email": "ana@nortelabs.co",
  "recipient_company": "Norte Labs",
  "sent_at": null,
  "accepted_at": null,
  "declined_at": null,
  "signer_name": "",
  "public_url": "https://zerosoft.ai/q/7Jx2kQ…",
  "created_at": "2026-10-13 12:00:00"
}

Obtener una cotización

GET/api/v1/crm/quotes/{id}

Devuelve la cotización con sus ítems y public_url.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/quotes/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "{quote_id}",
  "deal_id": "{deal_id}",
  "deal_name": "Norte Labs — New business",
  "number": "Q-2026-0003",
  "title": "Norte Labs — Pro plan",
  "status": "draft",
  "currency": "USD",
  "items": [
    {
      "name": "Pro plan",
      "sku": "PRO-Y",
      "description": "",
      "quantity": 2,
      "unit_price": 1200,
      "discount_pct": 10,
      "tax_pct": 21,
      "recurring": "yearly",
      "subtotal": 2400,
      "discount": 240,
      "net": 2160,
      "tax": 453.6,
      "total": 2613.6
    }
  ],
  "subtotal": 2400,
  "discount_total": 240,
  "tax_total": 453.6,
  "total": 2613.6,
  "expires_at": "2026-11-30",
  "terms": "Payment within 30 days of acceptance.",
  "notes": "",
  "sender_name": "Lucía Pérez",
  "sender_email": "lucia@zerosoft.ai",
  "sender_company": "Zerosoft",
  "recipient_name": "Ana Garcia",
  "recipient_email": "ana@nortelabs.co",
  "recipient_company": "Norte Labs",
  "sent_at": null,
  "accepted_at": null,
  "declined_at": null,
  "signer_name": "",
  "public_url": "https://zerosoft.ai/q/7Jx2kQ…",
  "created_at": "2026-10-13 12:00:00"
}

Editar o enviar una cotización

PATCH/api/v1/crm/quotes/{id}

Edita un borrador. status: "sent" publica el link público (draft → sent). Aceptar y rechazar se hace en la página pública. Si no es borrador responde 409 not_draft.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
statusstringNo"sent" publica la cotización.
refreshItemsbooleanNoVuelve a copiar los line items actuales del deal (solo borradores).
expiresAtstringNoFecha de vencimiento, YYYY-MM-DD.
curl -X PATCH "https://zerosoft.ai/api/v1/crm/quotes/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "refreshItems": true,
  "status": "sent"
}'

Request

{
  "refreshItems": true,
  "status": "sent"
}

CRM · Leads

Los leads son prospectos antes de ser un deal: owner, etapa del pipeline de leads, contacto y empresa. Convertir un lead crea un deal desde la app. Los campos propios de leads van en custom; los que la key no puede editar devuelven 403 field_readonly y los ocultos no vienen en las respuestas.

Listar leads

GET/api/v1/crm/leads

Los leads que ve la key, los más nuevos primero.

Scope crm:read

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
statusopen | qualified | disqualifiedNoSolo leads en etapas de este tipo.
stageIdstringNoEtapa del pipeline de leads.
contactIdstringNoContacto asociado.
companyIdstringNoEmpresa asociada.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/leads" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "leads": [
    {
      "id": "f1c2…",
      "owner_id": "usr_…",
      "name": "Ana Gómez",
      "stage_id": "stg_…",
      "stage_name": "Connected",
      "stage_kind": "open",
      "contact_id": "c7a1…",
      "company_id": "co_…",
      "source": "form",
      "disqualify_reason": "",
      "deal_id": null,
      "converted_at": null,
      "custom": "{}",
      "created_at": "2026-10-24 12:00:00",
      "updated_at": "2026-10-24 12:00:00"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25
}

Crear un lead

POST/api/v1/crm/leads

Necesita nombre, contacto o empresa. Sin nombre toma el del contacto (o el de la empresa). Sin stageId arranca en la primera etapa abierta.

Scope crm:write

NombreTipoRequeridoDescripción
namestringNoNombre del lead.
contactIdstringNoContacto asociado.
companyIdstringNoEmpresa asociada.
stageIdstringNoEtapa del pipeline de leads.
ownerIdstringNoPersona del workspace responsable. Por defecto, quien creó la key.
sourcestringNoFuente (organic, referral, ads, social, email, event, form, other).
customobjectNoCampos propios de leads.
curl -X POST "https://zerosoft.ai/api/v1/crm/leads" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "{contact_id}",
  "source": "form"
}'

Request

{
  "contactId": "{contact_id}",
  "source": "form"
}

Respuesta · 201

{
  "id": "f1c2…",
  "owner_id": "usr_…",
  "name": "Ana Gómez",
  "stage_id": "stg_…",
  "stage_name": "Connected",
  "stage_kind": "open",
  "contact_id": "c7a1…",
  "company_id": "co_…",
  "source": "form",
  "disqualify_reason": "",
  "deal_id": null,
  "converted_at": null,
  "custom": "{}",
  "created_at": "2026-10-24 12:00:00",
  "updated_at": "2026-10-24 12:00:00"
}

Ver un lead

GET/api/v1/crm/leads/{id}

Un lead con su etapa, contacto, empresa y deal.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/leads/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "f1c2…",
  "owner_id": "usr_…",
  "name": "Ana Gómez",
  "stage_id": "stg_…",
  "stage_name": "Connected",
  "stage_kind": "open",
  "contact_id": "c7a1…",
  "company_id": "co_…",
  "source": "form",
  "disqualify_reason": "",
  "deal_id": null,
  "converted_at": null,
  "custom": "{}",
  "created_at": "2026-10-24 12:00:00",
  "updated_at": "2026-10-24 12:00:00"
}

Editar un lead

PATCH/api/v1/crm/leads/{id}

Cambia etapa, owner, contacto, empresa, fuente, motivo de descalificación o campos propios.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
stageIdstringNoEtapa del pipeline de leads.
disqualifyReasonstringNoPor qué se descalificó el lead.
curl -X PATCH "https://zerosoft.ai/api/v1/crm/leads/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "stageId": "{stage_id}"
}'

Request

{
  "stageId": "{stage_id}"
}

Respuesta · 200

{
  "id": "f1c2…",
  "owner_id": "usr_…",
  "name": "Ana Gómez",
  "stage_id": "stg_…",
  "stage_name": "Connected",
  "stage_kind": "open",
  "contact_id": "c7a1…",
  "company_id": "co_…",
  "source": "form",
  "disqualify_reason": "",
  "deal_id": null,
  "converted_at": null,
  "custom": "{}",
  "created_at": "2026-10-24 12:00:00",
  "updated_at": "2026-10-24 12:00:00"
}

Borrar un lead

DELETE/api/v1/crm/leads/{id}

Borra el lead con sus notas y tareas. El contacto, la empresa y el deal quedan.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/leads/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

CRM · Objetos propios

Registros de los objetos propios que definió un admin (por ejemplo vehículos o propiedades). Cada registro tiene nombre (la propiedad primaria), owner y sus propiedades en custom. Los permisos por campo aplican como en contactos.

Listar objetos propios

GET/api/v1/crm/objects

Los objetos del workspace con las propiedades que ve la key.

Scope crm:read

curl -X GET "https://zerosoft.ai/api/v1/crm/objects" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "objects": [
    {
      "id": "obj_…",
      "slug": "vehicles",
      "singular": "Vehicle",
      "plural": "Vehicles",
      "primary_label": "Plate",
      "properties": [
        {
          "name": "model",
          "label": "Model",
          "type": "text",
          "options": [],
          "readOnly": false
        }
      ]
    }
  ]
}

Listar registros

GET/api/v1/crm/objects/{slug}/records

Los registros de un objeto, los más nuevos primero.

Scope crm:read

NombreTipoRequeridoDescripción
slugstringSíSlug del objeto (de Listar objetos propios).
qstringNoQuery de búsqueda.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/objects/{slug}/records" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "records": [
    {
      "id": "rec_…",
      "object_id": "obj_…",
      "owner_id": "usr_…",
      "name": "AB 123 CD",
      "custom": "{\"model\":\"Hilux\",\"year\":2023}",
      "created_at": "2026-10-24 12:00:00",
      "updated_at": "2026-10-24 12:00:00"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25
}

Crear un registro

POST/api/v1/crm/objects/{slug}/records

Los valores de custom se validan con el tipo de cada propiedad; las propiedades que no existen se ignoran.

Scope crm:write

NombreTipoRequeridoDescripción
slugstringSíSlug del objeto (de Listar objetos propios).
namestringSíValor de la propiedad primaria.
ownerIdstringNoPersona del workspace responsable. Por defecto, quien creó la key.
customobjectNoValores de las propiedades por nombre.
curl -X POST "https://zerosoft.ai/api/v1/crm/objects/{slug}/records" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "AB 123 CD",
  "custom": {
    "model": "Hilux",
    "year": 2023
  }
}'

Request

{
  "name": "AB 123 CD",
  "custom": {
    "model": "Hilux",
    "year": 2023
  }
}

Respuesta · 201

{
  "id": "rec_…",
  "object_id": "obj_…",
  "owner_id": "usr_…",
  "name": "AB 123 CD",
  "custom": "{\"model\":\"Hilux\",\"year\":2023}",
  "created_at": "2026-10-24 12:00:00",
  "updated_at": "2026-10-24 12:00:00"
}

Ver un registro

GET/api/v1/crm/objects/{slug}/records/{id}

El registro con los ids de sus contactos, empresas y deals asociados.

Scope crm:read

NombreTipoRequeridoDescripción
slugstringSíSlug del objeto (de Listar objetos propios).
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/objects/{slug}/records/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "rec_…",
  "object_id": "obj_…",
  "owner_id": "usr_…",
  "name": "AB 123 CD",
  "custom": "{\"model\":\"Hilux\",\"year\":2023}",
  "created_at": "2026-10-24 12:00:00",
  "updated_at": "2026-10-24 12:00:00",
  "associations": {
    "contacts": [
      "c7a1…"
    ],
    "companies": [],
    "deals": []
  }
}

Editar un registro

PATCH/api/v1/crm/objects/{slug}/records/{id}

Cambia nombre, owner o propiedades.

Scope crm:write

NombreTipoRequeridoDescripción
slugstringSíSlug del objeto (de Listar objetos propios).
idstringSíId del registro.
customobjectNoValores de las propiedades por nombre.
curl -X PATCH "https://zerosoft.ai/api/v1/crm/objects/{slug}/records/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "custom": {
    "model": "Hilux",
    "year": 2024
  }
}'

Request

{
  "custom": {
    "model": "Hilux",
    "year": 2024
  }
}

Respuesta · 200

{
  "id": "rec_…",
  "object_id": "obj_…",
  "owner_id": "usr_…",
  "name": "AB 123 CD",
  "custom": "{\"model\":\"Hilux\",\"year\":2023}",
  "created_at": "2026-10-24 12:00:00",
  "updated_at": "2026-10-24 12:00:00"
}

Borrar un registro

DELETE/api/v1/crm/objects/{slug}/records/{id}

Borra el registro con sus notas y tareas.

Scope crm:write

NombreTipoRequeridoDescripción
slugstringSíSlug del objeto (de Listar objetos propios).
idstringSíId del registro.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/objects/{slug}/records/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

CRM · Asociaciones

Vínculos muchos a muchos entre contactos, empresas y deals. Un contacto o un deal puede tener varias empresas; una es la primaria. contact.company_id siempre refleja la empresa primaria.

Listar asociaciones

GET/api/v1/crm/associations

Todos los registros vinculados a un contacto, empresa o deal. Las empresas también devuelven su empresa madre y sus filiales.

Scope crm:read

NombreTipoRequeridoDescripción
typecontact | company | dealSíTipo de registro: contact, company o deal.
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/associations" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "companies": [
    {
      "id": "{company_id}",
      "name": "Norte Labs",
      "domain": "nortelabs.co",
      "is_primary": true,
      "label": "decision_maker"
    },
    {
      "id": "{company_id}",
      "name": "Norte Holding",
      "domain": "norte.com",
      "is_primary": false,
      "label": "billing"
    }
  ],
  "deals": [
    {
      "id": "{deal_id}",
      "name": "Norte Labs — New business",
      "amount": 24000,
      "currency": "USD"
    }
  ]
}

Asociar dos registros

POST/api/v1/crm/associations

Vincula contacto ↔ empresa, deal ↔ empresa o deal ↔ contacto (en cualquier orden). primary la vuelve empresa primaria; label solo aplica a contacto ↔ empresa. Si la asociación ya existe, actualiza primaria y label.

Scope crm:write

NombreTipoRequeridoDescripción
fromTypecontact | company | dealSíTipo del primer registro.
fromIdstringSíId del primer registro.
toTypecontact | company | dealSíTipo del segundo registro.
toIdstringSíId del segundo registro.
primarybooleanNoLa vuelve la empresa primaria del contacto o deal.
labelstringNoLabel de contacto ↔ empresa: employee, decision_maker, billing, champion, influencer, former_employee (o vacío).
curl -X POST "https://zerosoft.ai/api/v1/crm/associations" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "fromType": "contact",
  "fromId": "{contact_id}",
  "toType": "company",
  "toId": "{company_id}",
  "primary": true,
  "label": "decision_maker"
}'

Request

{
  "fromType": "contact",
  "fromId": "{contact_id}",
  "toType": "company",
  "toId": "{company_id}",
  "primary": true,
  "label": "decision_maker"
}

Respuesta · 201

{
  "ok": true
}

Quitar una asociación

DELETE/api/v1/crm/associations

Desvincula dos registros (parámetros en la query). Si quitás la empresa primaria, pasa a primaria la más antigua que quede.

Scope crm:write

NombreTipoRequeridoDescripción
fromTypecontact | company | dealSíTipo del primer registro.
fromIdstringSíId del primer registro.
toTypecontact | company | dealSíTipo del segundo registro.
toIdstringSíId del segundo registro.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/associations" \
  -H "Authorization: Bearer zs_live_9f3k..."

CRM · Tags

Tags del workspace para contactos, empresas y deals.

Listar tags

GET/api/v1/crm/tags

Tags con cuántos contactos, empresas y deals usan cada uno.

Scope crm:read

curl -X GET "https://zerosoft.ai/api/v1/crm/tags" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "tags": [
    {
      "id": "{tag_id}",
      "name": "Enterprise",
      "color": "crm",
      "created_at": "2026-10-13 12:00:00",
      "contacts": 18,
      "companies": 4,
      "deals": 7
    }
  ]
}

Crear un tag

POST/api/v1/crm/tags

El nombre es único por workspace (sin distinguir mayúsculas). Si se repite responde 409 duplicate_tag.

Scope crm:write

NombreTipoRequeridoDescripción
namestringSíNombre del tag (hasta 60 caracteres).
colorstringNoColor: crm, link, cal, track, chat, docs, flow, agents, notes, board o robots.
curl -X POST "https://zerosoft.ai/api/v1/crm/tags" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "Enterprise",
  "color": "crm"
}'

Request

{
  "name": "Enterprise",
  "color": "crm"
}

Respuesta · 201

{
  "id": "{tag_id}",
  "name": "Enterprise",
  "color": "crm",
  "created_at": "2026-10-13 12:00:00"
}

Actualizar un tag

PATCH/api/v1/crm/tags/{id}

Cambia el nombre o el color del tag.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
namestringNoNombre del tag (hasta 60 caracteres).
colorstringNoColor: crm, link, cal, track, chat, docs, flow, agents, notes, board o robots.
curl -X PATCH "https://zerosoft.ai/api/v1/crm/tags/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "color": "cal"
}'

Request

{
  "color": "cal"
}

Eliminar un tag

DELETE/api/v1/crm/tags/{id}

Elimina el tag y lo quita de todos los registros.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X DELETE "https://zerosoft.ai/api/v1/crm/tags/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Agregar o quitar un tag a registros

POST/api/v1/crm/tags/{id}/records

Agrega o quita el tag en hasta 1000 registros. Los ids de otros workspaces se ignoran. Devuelve cuántos registros cambiaron.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
entitycontact | company | dealSíTipo de registro: contact, company o deal.
idsstring[]SíIds de los registros.
actionadd | removeSíadd o remove.
curl -X POST "https://zerosoft.ai/api/v1/crm/tags/{id}/records" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "entity": "contact",
  "ids": [
    "{contact_id}"
  ],
  "action": "add"
}'

Request

{
  "entity": "contact",
  "ids": [
    "{contact_id}"
  ],
  "action": "add"
}

Respuesta · 200

{
  "changed": 1
}

CRM · Formularios

Formularios de captura de leads y sus envíos. Cada envío también crea o actualiza un contacto y registra una actividad "Form submitted".

Listar formularios

GET/api/v1/crm/forms

Formularios del más nuevo al más viejo, con estado, cantidad de respuestas y parciales, última respuesta y quién puede abrirlos.

Scope crm:read

curl -X GET "https://zerosoft.ai/api/v1/crm/forms" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "forms": [
    {
      "id": "{form_id}",
      "name": "Contact us",
      "key": "contact-us",
      "slug": "contact-us",
      "token": "a1b2c3d4e5f6a7b8c9d0",
      "status": "active",
      "fields": [
        {
          "id": "email",
          "type": "email",
          "label": "Email",
          "property": "email",
          "required": true
        }
      ],
      "submission_count": 42
    }
  ]
}

Listar envíos de un formulario

GET/api/v1/crm/forms/{id}/submissions

Envíos de un formulario, los más recientes primero, con los valores, los parámetros UTM y el contacto vinculado.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/crm/forms/{id}/submissions" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "submissions": [
    {
      "id": "{submission_id}",
      "formId": "{form_id}",
      "contactId": "{contact_id}",
      "contactCreated": true,
      "values": {
        "email": "ana@kallpa.co",
        "first_name": "Ana"
      },
      "utm": {
        "utm_source": "google",
        "utm_campaign": "spring"
      },
      "pageUrl": "https://kallpa.co/pricing?utm_source=google",
      "referrer": "",
      "createdAt": "2026-10-13 14:02:11"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25
}

CRM · Templates de email y secuencias

Templates y snippets de email compartidos, y secuencias de ventas de varios pasos. Los emails de las secuencias salen del Gmail conectado de quien envía; los pasos corren con el programador de cada hora.

Listar templates de email

GET/api/v1/crm/email-templates

Templates y snippets compartidos en el workspace. Las variables van entre llaves dobles (contact.first_name, contact.company, deal.name, owner.first_name, contact.custom.x), con un valor por defecto opcional después de una barra vertical.

Scope crm:read

NombreTipoRequeridoDescripción
kindtemplate | snippetNoFiltrar por tipo: template o snippet.
curl -X GET "https://zerosoft.ai/api/v1/crm/email-templates" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "templates": [
    {
      "id": "{template_id}",
      "kind": "template",
      "name": "Intro",
      "subject": "Quick question, {{contact.first_name}}",
      "body": "Hi {{contact.first_name | there}}, I saw {{contact.company}} is hiring…",
      "created_by": "u_123",
      "created_at": "2026-10-13 12:00:00",
      "updated_at": "2026-10-13 12:00:00"
    }
  ]
}

Obtener un template de email

GET/api/v1/crm/email-templates/{id}

Devuelve un template o snippet.

Scope crm:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/crm/email-templates/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Listar secuencias

GET/api/v1/crm/sequences

Secuencias con su cantidad de pasos e inscripciones.

Scope crm:read

curl -X GET "https://zerosoft.ai/api/v1/crm/sequences" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "sequences": [
    {
      "id": "{sequence_id}",
      "name": "Outbound — 3 touches",
      "timezone": "America/Argentina/Buenos_Aires",
      "window_start": "09:00",
      "window_end": "17:00",
      "business_days": 1,
      "step_count": 4,
      "active_count": 12,
      "total_count": 40
    }
  ]
}

Inscribir contactos en una secuencia

POST/api/v1/crm/sequences/{id}/enroll

Inscribe hasta 500 contactos. Los que ya están inscriptos, se dieron de baja o no tienen email vuelven en skipped. Quien envía necesita Gmail conectado con permiso de envío.

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
contactIdsstring[]SíIDs de los contactos a inscribir (1–500).
senderIdstringNoMiembro del workspace cuyo Gmail envía los emails. Por defecto, el owner del contacto y si no quien creó la secuencia.
curl -X POST "https://zerosoft.ai/api/v1/crm/sequences/{id}/enroll" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "contactIds": [
    "{contact_id}"
  ]
}'

Request

{
  "contactIds": [
    "{contact_id}"
  ]
}

Respuesta · 201

{
  "enrolled": [
    "{contact_id}"
  ],
  "skipped": []
}

Sacar un contacto de una secuencia

POST/api/v1/crm/sequences/{id}/unenroll

Saca al contacto de la secuencia (estado exited, motivo manual).

Scope crm:write

NombreTipoRequeridoDescripción
idstringSíId del registro.
contactIdstringSíId del contacto vinculado.
curl -X POST "https://zerosoft.ai/api/v1/crm/sequences/{id}/unenroll" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "{contact_id}"
}'

Request

{
  "contactId": "{contact_id}"
}

Respuesta · 200

{
  "exited": 1
}

Panel del contacto de un email

GET/api/v1/crm/extension/sidebar

Lo que muestra la extensión de Gmail al lado de un email: el contacto con esa dirección, su empresa, deals y tareas abiertas. contact es null si nadie que ves en el CRM la tiene.

Scope crm:read

NombreTipoRequeridoDescripción
emailstringSíDirección de email.
curl -X GET "https://zerosoft.ai/api/v1/crm/extension/sidebar" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "email": "ana@acme.com",
  "contact": {
    "id": "{contact_id}",
    "name": "Ana Pérez",
    "email": "ana@acme.com",
    "url": "/app/crm/contacts/{contact_id}"
  },
  "company": {
    "id": "{company_id}",
    "name": "Acme",
    "domain": "acme.com",
    "url": "/app/crm/companies/{company_id}"
  },
  "deals": [
    {
      "id": "{deal_id}",
      "name": "Acme renewal",
      "amount": 12000,
      "currency": "USD",
      "stage": "Proposal",
      "closed": false
    }
  ],
  "tasks": [
    {
      "id": "{task_id}",
      "subject": "Send proposal",
      "dueAt": "2026-07-25 15:00:00"
    }
  ],
  "emailsLogged": 3
}

Registrar un email de Gmail

POST/api/v1/crm/extension/log-email

Guarda un email en el timeline de los contactos que participan. Mandar el mismo messageId otra vez no lo duplica (200 con duplicate: true). 404 no_contact si ningún participante es contacto.

Scope crm:write

NombreTipoRequeridoDescripción
messageIdstringSíId del mensaje en Gmail (data-legacy-message-id)
fromstringSíRemitente, como "Ana <ana@acme.com>"
tostringNoDestinatarios, separados por comas
subjectstringNoAsunto del email
bodystringNoCuerpo en texto plano
curl -X POST "https://zerosoft.ai/api/v1/crm/extension/log-email" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "messageId": "18c2f0a1b2c3d4e5",
  "from": "Ana <ana@acme.com>",
  "to": "you@yourco.com",
  "subject": "Pricing",
  "body": "Hi…"
}'

Request

{
  "messageId": "18c2f0a1b2c3d4e5",
  "from": "Ana <ana@acme.com>",
  "to": "you@yourco.com",
  "subject": "Pricing",
  "body": "Hi…"
}

Respuesta · 201

{
  "ok": true,
  "emailId": "{email_id}",
  "contactIds": [
    "{contact_id}"
  ],
  "duplicate": false
}

Registrar y trackear un email antes de enviarlo

POST/api/v1/crm/extension/track

Guarda el email saliente y devuelve el pixel de aperturas para agregar al cuerpo. Si ningún destinatario es contacto, se crea el primero.

Scope crm:write

NombreTipoRequeridoDescripción
tostringSíDestinatarios, separados por comas
subjectstringNoAsunto del email
bodystringNoCuerpo en texto plano
curl -X POST "https://zerosoft.ai/api/v1/crm/extension/track" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "to": "ana@acme.com",
  "subject": "Proposal",
  "body": "Hi Ana…"
}'

Request

{
  "to": "ana@acme.com",
  "subject": "Proposal",
  "body": "Hi Ana…"
}

Respuesta · 201

{
  "ok": true,
  "emailId": "{email_id}",
  "pixelUrl": "https://zerosoft.ai/api/crm/t/o/{token}.gif",
  "contactIds": [
    "{contact_id}"
  ],
  "createdContact": false
}

Cal

Tipos de evento y reservas. Las reservas creadas por API siguen las mismas reglas que la página pública (disponibilidad, márgenes, ocupado en Google Calendar) y mandan los mismos emails.

Listar tipos de evento

GET/api/v1/calendar/event-types

Tus tipos de evento con su URL pública de reserva.

Scope cal:read

curl -X GET "https://zerosoft.ai/api/v1/calendar/event-types" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "eventTypes": [
    {
      "id": "et_42",
      "slug": "intro",
      "title": "Intro call",
      "durationMin": 30,
      "active": true,
      "url": "https://zerosoft.ai/en/book/ana/intro"
    }
  ]
}

Listar reservas

GET/api/v1/calendar/bookings

Reservas de tus tipos de evento, más nuevas primero. Filtrá por estado y rango de fechas.

Scope cal:read

NombreTipoRequeridoDescripción
statusconfirmed | cancelled | no_show | pendingNoSolo reservas con este estado.
qstringNoBusca en el nombre o el email del invitado.
fromISO 8601NoInicio desde (inclusive).
toISO 8601NoInicio hasta (inclusive).
curl -X GET "https://zerosoft.ai/api/v1/calendar/bookings" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "bookings": [
    {
      "id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
      "status": "confirmed",
      "startsAt": "2026-11-03T13:00:00.000Z",
      "endsAt": "2026-11-03T13:30:00.000Z",
      "timezone": "America/Argentina/Buenos_Aires",
      "invitee": {
        "name": "Ana",
        "email": "ana@example.com"
      },
      "answers": {},
      "hostUserId": "u_123",
      "meetingUrl": "https://meet.google.com/abc-defg-hij",
      "rescheduledFrom": null,
      "cancelReason": null,
      "eventType": {
        "id": "et_42",
        "slug": "intro",
        "title": "Intro call"
      }
    }
  ]
}

Crear una reserva

POST/api/v1/calendar/bookings

Reserva un horario para un invitado. Devuelve 409 slot_unavailable si ese horario ya no se ofrece.

Scope cal:write

NombreTipoRequeridoDescripción
eventTypeIdstringSíId del tipo de evento (de Listar tipos de evento).
startISO 8601SíInicio del horario; tiene que coincidir con uno ofrecido.
namestringSíNombre del invitado.
emailstringSíEmail del invitado: recibe la confirmación y la invitación de calendario.
timezoneIANANoZona horaria del invitado para los emails. Por defecto UTC.
curl -X POST "https://zerosoft.ai/api/v1/calendar/bookings" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "eventTypeId": "et_42",
  "start": "2026-11-03T13:00:00.000Z",
  "name": "Ana",
  "email": "ana@example.com",
  "timezone": "America/Argentina/Buenos_Aires"
}'

Request

{
  "eventTypeId": "et_42",
  "start": "2026-11-03T13:00:00.000Z",
  "name": "Ana",
  "email": "ana@example.com",
  "timezone": "America/Argentina/Buenos_Aires"
}

Respuesta · 201

{
  "id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
  "status": "confirmed",
  "startsAt": "2026-11-03T13:00:00.000Z",
  "endsAt": "2026-11-03T13:30:00.000Z",
  "timezone": "America/Argentina/Buenos_Aires",
  "invitee": {
    "name": "Ana",
    "email": "ana@example.com"
  },
  "answers": {},
  "hostUserId": "u_123",
  "meetingUrl": "https://meet.google.com/abc-defg-hij",
  "rescheduledFrom": null,
  "cancelReason": null,
  "eventType": {
    "id": "et_42",
    "slug": "intro",
    "title": "Intro call"
  }
}

Obtener una reserva

GET/api/v1/calendar/bookings/:id

Una reserva por id (dueño del tipo de evento o host asignado).

Scope cal:read

curl -X GET "https://zerosoft.ai/api/v1/calendar/bookings/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
  "status": "confirmed",
  "startsAt": "2026-11-03T13:00:00.000Z",
  "endsAt": "2026-11-03T13:30:00.000Z",
  "timezone": "America/Argentina/Buenos_Aires",
  "invitee": {
    "name": "Ana",
    "email": "ana@example.com"
  },
  "answers": {},
  "hostUserId": "u_123",
  "meetingUrl": "https://meet.google.com/abc-defg-hij",
  "rescheduledFrom": null,
  "cancelReason": null,
  "eventType": {
    "id": "et_42",
    "slug": "intro",
    "title": "Intro call"
  }
}

Cancelar una reserva

POST/api/v1/calendar/bookings/:id/cancel

Cancela una reserva confirmada, le manda al invitado la cancelación con .ics, borra el evento de Google Calendar y emite booking.cancelled.

Scope cal:write

NombreTipoRequeridoDescripción
reasonstringNoSe le muestra al invitado en el email de cancelación.
curl -X POST "https://zerosoft.ai/api/v1/calendar/bookings/:id/cancel" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "reason": "Customer asked to move it to next month"
}'

Request

{
  "reason": "Customer asked to move it to next month"
}

Respuesta · 200

{
  "id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
  "status": "cancelled",
  "startsAt": "2026-11-03T13:00:00.000Z",
  "endsAt": "2026-11-03T13:30:00.000Z",
  "timezone": "America/Argentina/Buenos_Aires",
  "invitee": {
    "name": "Ana",
    "email": "ana@example.com"
  },
  "answers": {},
  "hostUserId": "u_123",
  "meetingUrl": "https://meet.google.com/abc-defg-hij",
  "rescheduledFrom": null,
  "cancelReason": "Customer asked to move it to next month",
  "eventType": {
    "id": "et_42",
    "slug": "intro",
    "title": "Intro call"
  }
}

Reprogramar una reserva

POST/api/v1/calendar/bookings/:id/reschedule

Mueve una reserva confirmada a otro horario ofrecido, le manda al invitado el .ics actualizado y emite booking.rescheduled. Devuelve 409 slot_unavailable si el horario no se ofrece.

Scope cal:write

NombreTipoRequeridoDescripción
startISO 8601SíInicio del horario; tiene que coincidir con uno ofrecido.
timezoneIANANoZona horaria del invitado para los emails. Por defecto UTC.
curl -X POST "https://zerosoft.ai/api/v1/calendar/bookings/:id/reschedule" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "start": "2026-11-04T14:00:00.000Z"
}'

Request

{
  "start": "2026-11-04T14:00:00.000Z"
}

Respuesta · 200

{
  "id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
  "status": "confirmed",
  "startsAt": "2026-11-04T14:00:00.000Z",
  "endsAt": "2026-11-04T14:30:00.000Z",
  "timezone": "America/Argentina/Buenos_Aires",
  "invitee": {
    "name": "Ana",
    "email": "ana@example.com"
  },
  "answers": {},
  "hostUserId": "u_123",
  "meetingUrl": "https://meet.google.com/abc-defg-hij",
  "rescheduledFrom": null,
  "cancelReason": null,
  "eventType": {
    "id": "et_42",
    "slug": "intro",
    "title": "Intro call"
  }
}

Marcar inasistencia

POST/api/v1/calendar/bookings/:id/no-show

Marca que el invitado no se presentó. Solo para reservas confirmadas.

Scope cal:write

curl -X POST "https://zerosoft.ai/api/v1/calendar/bookings/:id/no-show" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
  "status": "no_show",
  "startsAt": "2026-11-03T13:00:00.000Z",
  "endsAt": "2026-11-03T13:30:00.000Z",
  "timezone": "America/Argentina/Buenos_Aires",
  "invitee": {
    "name": "Ana",
    "email": "ana@example.com"
  },
  "answers": {},
  "hostUserId": "u_123",
  "meetingUrl": "https://meet.google.com/abc-defg-hij",
  "rescheduledFrom": null,
  "cancelReason": null,
  "eventType": {
    "id": "et_42",
    "slug": "intro",
    "title": "Intro call"
  }
}

Agents

Hablá con tus agentes de AI desde tu propia app. El agente usa las mismas instrucciones, conocimiento y herramientas que en Chat y en su página pública; cada respuesta cuenta para la cuota de AI del workspace.

Enviar un mensaje a un agente

POST/api/v1/agents/:id/messages

Devuelve la respuesta del agente y las herramientas que usó. Mandá el conversationId devuelto para seguir la misma conversación. Errores: 404 not_found, 403 agent_disabled, 429 rate_limited, 503 ai_disabled.

Scope agents:run

NombreTipoRequeridoDescripción
messagestringSíLo que dice el usuario (hasta 4000 caracteres).
conversationIdstringNoContinúa una conversación de API existente. Omitilo para empezar una nueva.
curl -X POST "https://zerosoft.ai/api/v1/agents/:id/messages" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "message": "Do you ship to Brazil?"
}'

Request

{
  "message": "Do you ship to Brazil?"
}

Respuesta · 200

{
  "conversationId": "6b0f8f7e-2a43-4d0c-9a51-3f3c1f1b8e21",
  "message": {
    "id": "b7e1…",
    "role": "assistant",
    "content": "Yes! We ship to Brazil in 5–7 business days.",
    "createdAt": "2026-11-01T18:00:00.000Z"
  },
  "status": "replied",
  "handoff": false,
  "toolCalls": [
    {
      "tool": "search_knowledge",
      "input": {
        "query": "shipping Brazil"
      },
      "output": {
        "results": []
      },
      "error": null
    }
  ]
}

Chat

Leé y respondé las conversaciones del inbox de Chat desde tu app o tu helpdesk. Necesita el scope chat:read para leer y chat:write para responder, asignar y resolver. Las respuestas salen a nombre de quien creó la key.

Listar conversaciones

GET/api/v1/chat/conversations

Conversaciones de los widgets del workspace, las actualizadas más recientemente primero.

Scope chat:read

NombreTipoRequeridoDescripción
statusopen | pending | snoozed | resolvedNoSolo conversaciones con este estado.
assignedTostringNoSolo conversaciones asignadas a este id de usuario, o unassigned.
widgetIdstringNoSolo conversaciones de este widget.
limitintegerNoCuántas devolver (de 1 a 200, 50 por defecto).
offsetintegerNoCuántas saltear, para paginar.
curl -X GET "https://zerosoft.ai/api/v1/chat/conversations" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "conversations": [
    {
      "id": "{conversation_id}",
      "widgetId": "{widget_id}",
      "status": "open",
      "priority": "medium",
      "subject": null,
      "assignedTo": "{user_id}",
      "visitor": {
        "id": "{visitor_id}",
        "name": "Ana",
        "email": "ana@example.com"
      },
      "firstResponseAt": "2026-11-01T18:02:00.000Z",
      "resolvedAt": null,
      "createdAt": "2026-11-01T18:00:00.000Z",
      "updatedAt": "2026-11-01T18:02:00.000Z"
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}

Ver una conversación

GET/api/v1/chat/conversations/{id}

La conversación y todos sus mensajes, del más viejo al más nuevo. Las notas internas vienen con isNote: true.

Scope chat:read

NombreTipoRequeridoDescripción
idstringSíId del registro.
curl -X GET "https://zerosoft.ai/api/v1/chat/conversations/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "conversation": {
    "id": "{conversation_id}",
    "widgetId": "{widget_id}",
    "status": "open",
    "priority": "medium",
    "subject": null,
    "assignedTo": "{user_id}",
    "visitor": {
      "id": "{visitor_id}",
      "name": "Ana",
      "email": "ana@example.com"
    },
    "firstResponseAt": "2026-11-01T18:02:00.000Z",
    "resolvedAt": null,
    "createdAt": "2026-11-01T18:00:00.000Z",
    "updatedAt": "2026-11-01T18:02:00.000Z"
  },
  "messages": [
    {
      "id": "{message_id}",
      "conversationId": "{conversation_id}",
      "senderType": "user",
      "userId": "{user_id}",
      "body": "Hi Ana, the order ships tomorrow.",
      "isNote": false,
      "attachments": [],
      "createdAt": "2026-11-01T18:02:00.000Z"
    }
  ]
}

Responder

POST/api/v1/chat/conversations/{id}/messages

Manda un mensaje al visitante (o una nota interna con note: true). Como una respuesta desde el inbox, cuenta como primera respuesta para el SLA y reabre la conversación si estaba resuelta. Dispara chat.message.created.

Scope chat:write

NombreTipoRequeridoDescripción
bodystringSíTexto del mensaje (hasta 5000 caracteres).
notebooleanNotrue para dejar una nota interna que el visitante no ve.
curl -X POST "https://zerosoft.ai/api/v1/chat/conversations/{id}/messages" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "body": "Hi Ana, the order ships tomorrow."
}'

Request

{
  "body": "Hi Ana, the order ships tomorrow."
}

Respuesta · 201

{
  "id": "{message_id}",
  "conversationId": "{conversation_id}",
  "senderType": "user",
  "userId": "{user_id}",
  "body": "Hi Ana, the order ships tomorrow.",
  "isNote": false,
  "attachments": [],
  "createdAt": "2026-11-01T18:02:00.000Z"
}

Asignar

POST/api/v1/chat/conversations/{id}/assign

Asigna la conversación a un agente de su widget, o la deja sin asignar con null. Dispara chat.conversation.assigned. Errores: 400 invalid_assignee.

Scope chat:write

NombreTipoRequeridoDescripción
assignedTostringSíId de usuario del agente, o null para dejarla sin asignar.
curl -X POST "https://zerosoft.ai/api/v1/chat/conversations/{id}/assign" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "assignedTo": "{user_id}"
}'

Request

{
  "assignedTo": "{user_id}"
}

Respuesta · 200

{
  "id": "{conversation_id}",
  "widgetId": "{widget_id}",
  "status": "open",
  "priority": "medium",
  "subject": null,
  "assignedTo": "{user_id}",
  "visitor": {
    "id": "{visitor_id}",
    "name": "Ana",
    "email": "ana@example.com"
  },
  "firstResponseAt": "2026-11-01T18:02:00.000Z",
  "resolvedAt": null,
  "createdAt": "2026-11-01T18:00:00.000Z",
  "updatedAt": "2026-11-01T18:02:00.000Z"
}

Resolver

POST/api/v1/chat/conversations/{id}/resolve

Marca la conversación como resuelta. Si el widget tiene atributos obligatorios vacíos, responde 400 missing_attributes. Dispara chat.conversation.resolved.

Scope chat:write

curl -X POST "https://zerosoft.ai/api/v1/chat/conversations/{id}/resolve" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "{conversation_id}",
  "widgetId": "{widget_id}",
  "status": "resolved",
  "priority": "medium",
  "subject": null,
  "assignedTo": "{user_id}",
  "visitor": {
    "id": "{visitor_id}",
    "name": "Ana",
    "email": "ana@example.com"
  },
  "firstResponseAt": "2026-11-01T18:02:00.000Z",
  "resolvedAt": "2026-11-01T18:10:00.000Z",
  "createdAt": "2026-11-01T18:00:00.000Z",
  "updatedAt": "2026-11-01T18:02:00.000Z"
}

Reabrir

POST/api/v1/chat/conversations/{id}/reopen

Vuelve a abrir una conversación resuelta o pospuesta.

Scope chat:write

curl -X POST "https://zerosoft.ai/api/v1/chat/conversations/{id}/reopen" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "{conversation_id}",
  "widgetId": "{widget_id}",
  "status": "open",
  "priority": "medium",
  "subject": null,
  "assignedTo": "{user_id}",
  "visitor": {
    "id": "{visitor_id}",
    "name": "Ana",
    "email": "ana@example.com"
  },
  "firstResponseAt": "2026-11-01T18:02:00.000Z",
  "resolvedAt": null,
  "createdAt": "2026-11-01T18:00:00.000Z",
  "updatedAt": "2026-11-01T18:02:00.000Z"
}

Robots

Corré tus robots de navegador desde tu propia app, de a uno o sobre muchas entradas. Las corridas pasan por la misma cola que en la app (una a la vez por workspace) y cuentan para los minutos mensuales de robots. Para correr hace falta una key creada por un admin del workspace.

Listar robots

GET/api/v1/robots

Devuelve los robots del workspace con sus entradas, para saber qué mandar al correrlos.

Scope robots:run

curl -X GET "https://zerosoft.ai/api/v1/robots" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "robots": [
    {
      "id": "c1f2a9d4-7b1e-4c2a-9f0e-1a2b3c4d5e6f",
      "name": "Price check",
      "description": "",
      "enabled": true,
      "inputs": [
        {
          "name": "url",
          "label": "Product URL",
          "kind": "text",
          "default": "",
          "required": true
        }
      ],
      "updatedAt": "2026-11-01T18:00:00.000Z"
    }
  ]
}

Correr un robot

POST/api/v1/robots/:id/runs

Pone una corrida en cola y responde 202 con la corrida; consultá GET /api/v1/robots/runs/:id hasta que status sea success o failed. Con "wait": true la respuesta espera el resultado (200) si no hay otra corrida delante. El robot tiene que tener las corridas automáticas activadas. Errores: 404 not_found, 400 missing_input o disabled, 409 busy, 429 rate_limited o quota_exceeded, 503 runner_unavailable.

Scope robots:run

NombreTipoRequeridoDescripción
inputsobjectNoEntradas del robot por nombre. Las entradas de tipo lista llevan un array de textos.
waitbooleanNoEsperar el resultado en la misma respuesta (hasta el timeout del robot). Por defecto false.
curl -X POST "https://zerosoft.ai/api/v1/robots/:id/runs" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
  }
}'

Request

{
  "inputs": {
    "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
  }
}

Respuesta · 202

{
  "run": {
    "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    "robotId": "c1f2a9d4-7b1e-4c2a-9f0e-1a2b3c4d5e6f",
    "status": "queued",
    "trigger": "api",
    "input": {
      "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
    },
    "output": {},
    "error": null,
    "warnings": 0,
    "changed": null,
    "batchId": null,
    "createdAt": "2026-11-01T18:00:00.000Z",
    "startedAt": null,
    "finishedAt": null,
    "durationMs": null
  }
}

Ver una corrida

GET/api/v1/robots/runs/:id

Estado, entradas y datos extraídos de una corrida. changed dice si los datos difieren de la corrida exitosa anterior con las mismas entradas (null si no había con qué comparar).

Scope robots:run

curl -X GET "https://zerosoft.ai/api/v1/robots/runs/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "run": {
    "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    "robotId": "c1f2a9d4-7b1e-4c2a-9f0e-1a2b3c4d5e6f",
    "status": "success",
    "trigger": "api",
    "input": {
      "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
    },
    "output": {
      "title": "A Light in the Attic",
      "price": "£51.77"
    },
    "error": null,
    "warnings": 0,
    "changed": false,
    "batchId": null,
    "createdAt": "2026-11-01T18:00:00.000Z",
    "startedAt": "2026-11-01T18:00:01.000Z",
    "finishedAt": "2026-11-01T18:00:06.000Z",
    "durationMs": 5000
  }
}

Correr un robot sobre muchas entradas

POST/api/v1/robots/:id/bulk

Deja en cola una corrida por cada elemento de inputs (hasta 1.000 por pedido) bajo un id de lote. Para llegar a 50.000, mandá partes con el mismo batchId, el offset de la primera fila de cada parte y total: ninguna corrida arranca hasta que lleguen todas las filas, y reenviar una parte no la duplica. Las corridas siguen el ajuste de corridas a la vez del workspace; cada entrada del pedido se valida antes de dejar algo en cola. Errores: 400 missing_input (con el índice del elemento), 409 busy, 429 rate_limited.

Scope robots:run

NombreTipoRequeridoDescripción
inputsobject[]SíUn objeto de entradas por corrida, de 1 a 1.000 por pedido.
curl -X POST "https://zerosoft.ai/api/v1/robots/:id/bulk" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "inputs": [
    {
      "url": "https://example.com/a"
    },
    {
      "url": "https://example.com/b"
    }
  ]
}'

Request

{
  "inputs": [
    {
      "url": "https://example.com/a"
    },
    {
      "url": "https://example.com/b"
    }
  ]
}

Respuesta · 202

{
  "batchId": "3e2d1c0b-9a8f-4e7d-8c6b-5a4f3e2d1c0b",
  "total": 2,
  "runs": [
    {
      "id": "1f2e3d4c-…",
      "status": "queued",
      "input": {
        "url": "https://example.com/a"
      }
    },
    {
      "id": "5b6a7c8d-…",
      "status": "queued",
      "input": {
        "url": "https://example.com/b"
      }
    }
  ]
}

Ver un lote

GET/api/v1/robots/batches/:id

Conteos por estado, done cuando todas terminaron y una página de corridas en el orden en que las mandaste: ?limit= (hasta 1.000, el valor por defecto) y ?offset=. nextOffset es el offset de la página siguiente, o null en la última.

Scope robots:run

curl -X GET "https://zerosoft.ai/api/v1/robots/batches/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "batchId": "3e2d1c0b-9a8f-4e7d-8c6b-5a4f3e2d1c0b",
  "robotId": "c1f2a9d4-7b1e-4c2a-9f0e-1a2b3c4d5e6f",
  "total": 2,
  "counts": {
    "queued": 0,
    "running": 1,
    "success": 1,
    "failed": 0
  },
  "done": false,
  "nextOffset": null,
  "runs": [
    {
      "id": "1f2e3d4c-…",
      "status": "success",
      "input": {
        "url": "https://example.com/a"
      },
      "output": {
        "title": "A"
      },
      "error": null
    },
    {
      "id": "5b6a7c8d-…",
      "status": "running",
      "input": {
        "url": "https://example.com/b"
      },
      "output": {},
      "error": null
    }
  ]
}

Lines (WhatsApp)

Leé chats y grupos de WhatsApp, mandá mensajes y creá tickets desde tus sistemas. Los mensajes salen del número al que pertenece el chat.

Listar chats y grupos

GET/api/v1/groups/chats

Chats y grupos abiertos, los más recientes primero, con etiquetas, asignado y si esperan respuesta.

Scope groups:read

NombreTipoRequeridoDescripción
filterstringNoall, unread, unanswered, flagged, mine, unassigned o closed
qstringNoQuery de búsqueda.
kindstringNogroup o dm
curl -X GET "https://zerosoft.ai/api/v1/groups/chats" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "gc_1",
      "kind": "group",
      "name": "Acme · Support",
      "memberCount": 12,
      "assignedTo": null,
      "labels": [
        {
          "id": "gl_1",
          "name": "Enterprise",
          "color": "blue"
        }
      ],
      "unread": 2,
      "lastMessageAt": "2026-11-01T18:00:00.000Z",
      "awaitingSince": "2026-11-01T18:00:00.000Z",
      "flagged": false
    }
  ],
  "total": 1
}

Listar mensajes

GET/api/v1/groups/chats/:id/messages

Mensajes y notas internas de un chat, del más viejo al más nuevo.

Scope groups:read

NombreTipoRequeridoDescripción
afterstringNoSolo mensajes posteriores a esta fecha ISO
curl -X GET "https://zerosoft.ai/api/v1/groups/chats/:id/messages" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "gm_1",
      "direction": "in",
      "senderName": "Ana",
      "senderPhone": "5491155550000",
      "body": "The October invoice did not arrive",
      "status": "received",
      "createdAt": "2026-11-01T18:00:00.000Z"
    }
  ]
}

Mandar un mensaje

POST/api/v1/groups/chats/:id/messages

Manda un WhatsApp al chat o grupo, o guarda una nota interna con note: true.

Scope groups:write

NombreTipoRequeridoDescripción
bodystringSíTexto del mensaje (hasta 4096 caracteres)
notebooleanNoGuardar como nota interna en vez de mandar
pollobjectNoObjeto con question, options (2 a 12) y multi, en lugar de body. Solo WAHA y Evolution
mediaobjectNoObjeto con url (https pública), mimetype y filename
curl -X POST "https://zerosoft.ai/api/v1/groups/chats/:id/messages" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "body": "Hi Ana, resending it now."
}'

Request

{
  "body": "Hi Ana, resending it now."
}

Respuesta · 201

{
  "data": {
    "id": "gm_2",
    "direction": "out",
    "body": "Hi Ana, resending it now.",
    "status": "sent",
    "createdAt": "2026-11-01T18:01:00.000Z"
  }
}

Listar tickets

GET/api/v1/groups/tickets

Tickets creados desde mensajes de WhatsApp, con su estado de SLA.

Scope groups:read

NombreTipoRequeridoDescripción
statusstringNoactive (por defecto), all, open, in_progress, resolved o closed
curl -X GET "https://zerosoft.ai/api/v1/groups/tickets" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "gt_1",
      "number": 12,
      "title": "Invoice did not arrive",
      "status": "open",
      "priority": "high",
      "source": "reaction",
      "dueAt": "2026-11-02T18:00:00.000Z",
      "breached": false
    }
  ]
}

Crear un ticket

POST/api/v1/groups/tickets

Crea un ticket en un chat. Con messageId, un mensaje tiene a lo sumo un ticket: repetir devuelve el existente.

Scope groups:write

NombreTipoRequeridoDescripción
chatIdstringSíId del chat o grupo
titlestringNoTítulo del ticket (por defecto, la primera línea del mensaje)
prioritystringNolow, medium, high o urgent
curl -X POST "https://zerosoft.ai/api/v1/groups/tickets" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "chatId": "gc_1",
  "title": "Invoice did not arrive",
  "priority": "high"
}'

Request

{
  "chatId": "gc_1",
  "title": "Invoice did not arrive",
  "priority": "high"
}

Respuesta · 201

{
  "data": {
    "id": "gt_1",
    "number": 12,
    "title": "Invoice did not arrive",
    "status": "open",
    "priority": "high",
    "source": "api"
  }
}

Ver un chat

GET/api/v1/groups/chats/:id

Un chat o grupo con sus etiquetas, asignado y miembros.

Scope groups:read

curl -X GET "https://zerosoft.ai/api/v1/groups/chats/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "id": "gc_1",
    "kind": "group",
    "name": "Acme · Support",
    "memberCount": 12,
    "status": "open",
    "labels": [],
    "members": [
      {
        "phone": "5491155550000",
        "name": "Ana",
        "role": "admin"
      }
    ]
  }
}

Actualizar un chat

PATCH/api/v1/groups/chats/:id

Asignar, cerrar o reabrir, reemplazar etiquetas, renombrar (también en WhatsApp si es grupo) o cargar propiedades. Los cambios quedan en la auditoría.

Scope groups:write

NombreTipoRequeridoDescripción
assignedTostringNoId de una persona del workspace, o null para desasignar
statusopen | closedNoopen o closed
labelIdsstring[]NoIds de etiquetas (reemplazan las actuales)
namestringNoNombre
curl -X PATCH "https://zerosoft.ai/api/v1/groups/chats/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "assignedTo": "u_1",
  "labelIds": [
    "gl_1"
  ]
}'

Request

{
  "assignedTo": "u_1",
  "labelIds": [
    "gl_1"
  ]
}

Respuesta · 200

{
  "data": {
    "id": "gc_1",
    "assignedTo": "u_1",
    "status": "open",
    "labels": [
      {
        "id": "gl_1",
        "name": "Enterprise",
        "color": "blue"
      }
    ]
  }
}

Listar miembros de un grupo

GET/api/v1/groups/chats/:id/members

Miembros de un grupo con su rol (member, admin o superadmin).

Scope groups:read

curl -X GET "https://zerosoft.ai/api/v1/groups/chats/:id/members" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "phone": "5491155550000",
      "name": "Ana",
      "role": "admin"
    }
  ]
}

Sumar, quitar o promover miembros

POST/api/v1/groups/chats/:id/members

Cambia miembros en WhatsApp (números WAHA o Evolution). Con action invite devuelve el link de invitación; revoke: true genera uno nuevo.

Scope groups:write

NombreTipoRequeridoDescripción
actionadd | remove | promote | demote | inviteSíQué hacer con los teléfonos
phonesstring[]NoTeléfonos en formato internacional
curl -X POST "https://zerosoft.ai/api/v1/groups/chats/:id/members" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "action": "add",
  "phones": [
    "+5491155550001"
  ]
}'

Request

{
  "action": "add",
  "phones": [
    "+5491155550001"
  ]
}

Respuesta · 200

{
  "data": {
    "results": [
      {
        "phone": "5491155550001",
        "ok": true
      }
    ],
    "members": []
  }
}

Crear grupos

POST/api/v1/groups/groups

Crea un grupo de WhatsApp, o hasta 50 con groups: [...]. Los teléfonos que WhatsApp no dejó agregar vuelven en notAdded.

Scope groups:write

NombreTipoRequeridoDescripción
numberIdstringSíNúmero que crea el grupo (WAHA o Evolution)
namestringSíNombre
phonesstring[]NoTeléfonos en formato internacional
curl -X POST "https://zerosoft.ai/api/v1/groups/groups" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "numberId": "gn_1",
  "name": "Acme · Onboarding",
  "phones": [
    "+5491155550001"
  ]
}'

Request

{
  "numberId": "gn_1",
  "name": "Acme · Onboarding",
  "phones": [
    "+5491155550001"
  ]
}

Respuesta · 201

{
  "data": [
    {
      "name": "Acme · Onboarding",
      "ok": true,
      "chatId": "gc_2",
      "notAdded": []
    }
  ]
}

Listar números

GET/api/v1/groups/numbers

Números de WhatsApp conectados con proveedor, estado y capacidades. Las credenciales nunca se devuelven.

Scope groups:read

curl -X GET "https://zerosoft.ai/api/v1/groups/numbers" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "gn_1",
      "name": "Support line",
      "provider": "waha",
      "phone": "5491155550000",
      "status": "connected"
    }
  ]
}

Listar etiquetas

GET/api/v1/groups/labels

Etiquetas del workspace con cuántos chats tiene cada una.

Scope groups:read

curl -X GET "https://zerosoft.ai/api/v1/groups/labels" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "gl_1",
      "name": "Enterprise",
      "color": "blue",
      "count": 4
    }
  ]
}

Crear una etiqueta

POST/api/v1/groups/labels

Colores: gray, red, orange, yellow, green, teal, blue, purple o pink.

Scope groups:write

NombreTipoRequeridoDescripción
namestringSíNombre
curl -X POST "https://zerosoft.ai/api/v1/groups/labels" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "Enterprise",
  "color": "blue"
}'

Request

{
  "name": "Enterprise",
  "color": "blue"
}

Respuesta · 201

{
  "data": {
    "id": "gl_1",
    "name": "Enterprise",
    "color": "blue"
  }
}

Ver un ticket

GET/api/v1/groups/tickets/:id

El ticket con sus tickets vinculados en Freshdesk o Zoho Desk, si hay.

Scope groups:read

curl -X GET "https://zerosoft.ai/api/v1/groups/tickets/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "id": "gt_1",
    "number": 12,
    "title": "Invoice did not arrive",
    "status": "open",
    "links": [
      {
        "kind": "freshdesk",
        "remoteId": "1042",
        "remoteUrl": "https://acme.freshdesk.com/a/tickets/1042"
      }
    ]
  }
}

Actualizar un ticket

PATCH/api/v1/groups/tickets/:id

Estado, prioridad, asignado o título. El estado nuevo se manda a los tickets vinculados de Freshdesk o Zoho Desk.

Scope groups:write

NombreTipoRequeridoDescripción
statusstringNoactive (por defecto), all, open, in_progress, resolved o closed
prioritystringNolow, medium, high o urgent
assigneeIdstringNoId de una persona del workspace, o null para desasignar
curl -X PATCH "https://zerosoft.ai/api/v1/groups/tickets/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "status": "resolved"
}'

Request

{
  "status": "resolved"
}

Respuesta · 200

{
  "data": {
    "id": "gt_1",
    "number": 12,
    "status": "resolved"
  }
}

Mandar un envío masivo

POST/api/v1/groups/broadcasts

Manda un mensaje o una encuesta a muchos chats y grupos desde un número, con el ritmo que elijas (perMinute). Con scheduledAt sale más tarde.

Scope groups:write

NombreTipoRequeridoDescripción
chatIdsstring[]SíIds de chats y grupos
bodystringNoTexto del mensaje (hasta 4096 caracteres)
pollobjectNoObjeto con question, options (2 a 12) y multi, en lugar de body. Solo WAHA y Evolution
scheduledAtstringNoFecha ISO para mandar más tarde
curl -X POST "https://zerosoft.ai/api/v1/groups/broadcasts" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "chatIds": [
    "gc_1",
    "gc_2"
  ],
  "body": "Hi {{first_name}}, the new release is live.",
  "perMinute": 20
}'

Request

{
  "chatIds": [
    "gc_1",
    "gc_2"
  ],
  "body": "Hi {{first_name}}, the new release is live.",
  "perMinute": 20
}

Respuesta · 201

{
  "data": {
    "id": "gb_1",
    "status": "scheduled",
    "total": 2
  }
}

Crear un mensaje recurrente

POST/api/v1/groups/recurring

Repite un mensaje o una encuesta todos los días, cada semana, cada mes o con una expresión cron. GET en la misma ruta los lista con su próxima corrida.

Scope groups:write

NombreTipoRequeridoDescripción
chatIdsstring[]SíIds de chats y grupos
ruleobjectSíObjeto con freq (daily, weekly, monthly o cron), time (HH:MM), days (0 a 6), dayOfMonth o cron
timezonestringNoZona horaria IANA (por defecto UTC)
endsAtstringNoFecha ISO de fin, opcional
curl -X POST "https://zerosoft.ai/api/v1/groups/recurring" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "chatIds": [
    "gc_1"
  ],
  "body": "Weekly check-in: anything blocking you?",
  "rule": {
    "freq": "weekly",
    "days": [
      1
    ],
    "time": "09:00"
  },
  "timezone": "America/Argentina/Buenos_Aires"
}'

Request

{
  "chatIds": [
    "gc_1"
  ],
  "body": "Weekly check-in: anything blocking you?",
  "rule": {
    "freq": "weekly",
    "days": [
      1
    ],
    "time": "09:00"
  },
  "timezone": "America/Argentina/Buenos_Aires"
}

Respuesta · 201

{
  "data": {
    "id": "gr_1",
    "status": "active",
    "nextRunAt": "2026-11-02T12:00:00.000Z"
  }
}

Servidor MCP

POST/api/v1/groups/mcp

Model Context Protocol por streamable HTTP (JSON-RPC). Métodos: initialize, tools/list, tools/call. Herramientas: list_chats, get_messages, send_message, send_poll, update_chat, list_labels, create_ticket, list_tickets, update_ticket. Las que escriben piden groups:write.

Scope groups:read

curl -X POST "https://zerosoft.ai/api/v1/groups/mcp" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_chats",
    "arguments": {
      "filter": "unanswered"
    }
  }
}'

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_chats",
    "arguments": {
      "filter": "unanswered"
    }
  }
}

Respuesta · 200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"total\":1,\"chats\":[...]}"
      }
    ],
    "isError": false
  }
}

Voice

Dictado y transcripciones de reuniones. La app de escritorio usa estos endpoints con una key con voice:read y voice:write. El audio se transcribe y se descarta.

Dictar

POST/api/v1/voice/dictate

Sube un audio en multipart. Devuelve la transcripción limpia con el diccionario y el estilo de la persona, y la guarda en su historial de dictados.

Scope voice:write

curl -X POST "https://zerosoft.ai/api/v1/voice/dictate" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "audio": "(multipart file, webm/ogg/wav/m4a/mp3, up to 4 MB)",
  "context": "email",
  "sourceApp": "Mail",
  "durationMs": 5200
}'

Request

{
  "audio": "(multipart file, webm/ogg/wav/m4a/mp3, up to 4 MB)",
  "context": "email",
  "sourceApp": "Mail",
  "durationMs": 5200
}

Respuesta · 201

{
  "data": {
    "id": "vs_1",
    "text": "The launch is on Tuesday.",
    "raw": "um the launch is on monday, no, I mean tuesday",
    "ai": true
  }
}

Listar sesiones

GET/api/v1/voice/sessions

Dictados y reuniones de quien creó la key, de la más nueva a la más vieja.

Scope voice:read

NombreTipoRequeridoDescripción
kindstringNomeeting o dictation.
qstringNoQuery de búsqueda.
curl -X GET "https://zerosoft.ai/api/v1/voice/sessions" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "vs_2",
      "kind": "meeting",
      "title": "Acme pricing call",
      "status": "done",
      "durationMs": 1820000,
      "startedAt": "2026-11-02T15:00:00.000Z"
    }
  ]
}

Crear una reunión

POST/api/v1/voice/sessions

Empieza una reunión a la que subir trozos de audio.

Scope voice:write

curl -X POST "https://zerosoft.ai/api/v1/voice/sessions" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "title": "Acme pricing call"
}'

Request

{
  "title": "Acme pricing call"
}

Respuesta · 201

{
  "data": {
    "id": "vs_2",
    "title": "Acme pricing call",
    "status": "recording",
    "startedAt": "2026-11-02T15:00:00.000Z"
  }
}

Subir un trozo de audio

POST/api/v1/voice/sessions/:id/chunks

Transcribe un trozo de la reunión. source es me (micrófono), them (audio del sistema) o mixed. Idempotente por source y seq.

Scope voice:write

curl -X POST "https://zerosoft.ai/api/v1/voice/sessions/:id/chunks" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "audio": "(multipart file, up to 4 MB)",
  "source": "them",
  "seq": 200,
  "offsetMs": 20000,
  "durationMs": 20000
}'

Request

{
  "audio": "(multipart file, up to 4 MB)",
  "source": "them",
  "seq": 200,
  "offsetMs": 20000,
  "durationMs": 20000
}

Respuesta · 201

{
  "data": {
    "duplicate": false,
    "segments": [
      {
        "id": "sg_1",
        "source": "them",
        "speaker": "0",
        "startMs": 20400,
        "endMs": 24100,
        "text": "Twenty dollars works for us."
      }
    ]
  }
}

Ver una sesión

GET/api/v1/voice/sessions/:id

La sesión con su transcripción, notas y nota con IA.

Scope voice:read

curl -X GET "https://zerosoft.ai/api/v1/voice/sessions/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "id": "vs_2",
    "title": "Acme pricing call",
    "segments": [],
    "myNotes": "",
    "enhanced": null
  }
}

Actualizar una sesión

PATCH/api/v1/voice/sessions/:id

Cambiarle el título, o poner status en done al terminar de grabar.

Scope voice:write

curl -X PATCH "https://zerosoft.ai/api/v1/voice/sessions/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "status": "done"
}'

Request

{
  "status": "done"
}

Respuesta · 200

{
  "data": {
    "id": "vs_2",
    "title": "Acme pricing call",
    "status": "done",
    "durationMs": 1820000
  }
}

Diccionario y ajustes

GET/api/v1/voice/dictionary

Palabras, reemplazos, snippets y ajustes de dictado de la persona, para sincronizar la app de escritorio.

Scope voice:read

curl -X GET "https://zerosoft.ai/api/v1/voice/dictionary" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "entries": [
      {
        "id": "vd_1",
        "kind": "replace",
        "phrase": "zero soft",
        "replacement": "zerosoft"
      }
    ],
    "settings": {
      "language": "auto",
      "shortcut": "Alt+Space"
    }
  }
}

Track

Issues, comentarios, equipos, cycles, status, labels y personas de Track. Usá una key con track:read o track:write. Los issues creados por API van a triage si el equipo lo tiene activo, y cada cambio deja actividad, avisos, webhooks y una entrada de audit como la app. Los equipos antes se llamaban proyectos: /api/v1/track/projects y projectId siguen funcionando.

Listar issues

GET/api/v1/track/issues

Issues que ve la key, los editados más recientes primero, con filtros.

Scope track:read

NombreTipoRequeridoDescripción
teamIdstringNoId o clave del equipo (WEB). projectId también funciona.
statusCategorybacklog | todo | in_progress | done | cancelledNoCategoría del status.
assigneeIdstringNoId de la persona asignada.
priorityurgent | high | medium | lowNoPrioridad.
qstringNoQuery de búsqueda.
updatedSincestringNoSolo issues editados desde esta fecha ISO.
pageintegerNoNúmero de página.
pageSizeintegerNoItems por página (máx 100).
curl -X GET "https://zerosoft.ai/api/v1/track/issues" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "{issue_id}",
      "identifier": "WEB-12",
      "title": "Checkout button does nothing on Safari",
      "description": "Steps: open /pricing, press Buy.",
      "url": "https://zerosoft.ai/app/track/issues/{issue_id}",
      "projectId": "{team_id}",
      "teamId": "{team_id}",
      "planId": null,
      "status": {
        "id": "{status_id}",
        "name": "In Progress",
        "category": "in_progress",
        "color": "#000000"
      },
      "priority": "high",
      "assignee": {
        "id": "{user_id}",
        "name": "Ana",
        "email": "ana@example.com"
      },
      "creatorId": "{user_id}",
      "cycle": {
        "id": "{cycle_id}",
        "name": "Cycle 4"
      },
      "milestoneId": null,
      "parentId": null,
      "estimate": 3,
      "labels": [
        {
          "id": "{label_id}",
          "name": "bug",
          "color": "#d14343"
        }
      ],
      "startDate": null,
      "dueDate": "2026-11-04",
      "triage": false,
      "source": "api",
      "createdAt": "2026-10-25T14:02:11.000Z",
      "updatedAt": "2026-10-25T15:10:00.000Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1,
  "hasMore": false
}

Crear un issue

POST/api/v1/track/issues

teamId acepta el id o la clave (WEB); projectId es el nombre anterior. status acepta el nombre del status o una categoría. Los links de Sentry, Zendesk, Intercom o Figma quedan vinculados al issue.

Scope track:write

NombreTipoRequeridoDescripción
teamIdstringSíId o clave del equipo (WEB). projectId también funciona.
titlestringSíTítulo del issue.
descriptionstringNoDescripción en markdown.
statusstringNoNombre del status ("In Progress") o categoría (in_progress).
priorityurgent | high | medium | lowNoPrioridad.
assigneeEmailstringNoEmail de un miembro del equipo.
labelsstring[]NoNombres de labels; los que no existen se crean.
dueDatestringNoVencimiento, YYYY-MM-DD.
linksstring[]NoURLs de Sentry, Zendesk, Intercom o Figma para vincular.
curl -X POST "https://zerosoft.ai/api/v1/track/issues" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "teamId": "WEB",
  "title": "Checkout button does nothing on Safari",
  "description": "Steps: open /pricing, press Buy.",
  "priority": "high",
  "labels": [
    "bug"
  ],
  "links": [
    "https://acme.zendesk.com/agent/tickets/4812"
  ]
}'

Request

{
  "teamId": "WEB",
  "title": "Checkout button does nothing on Safari",
  "description": "Steps: open /pricing, press Buy.",
  "priority": "high",
  "labels": [
    "bug"
  ],
  "links": [
    "https://acme.zendesk.com/agent/tickets/4812"
  ]
}

Respuesta · 201

{
  "id": "{issue_id}",
  "identifier": "WEB-12",
  "title": "Checkout button does nothing on Safari",
  "description": "Steps: open /pricing, press Buy.",
  "url": "https://zerosoft.ai/app/track/issues/{issue_id}",
  "projectId": "{team_id}",
  "teamId": "{team_id}",
  "planId": null,
  "status": {
    "id": "{status_id}",
    "name": "In Progress",
    "category": "in_progress",
    "color": "#000000"
  },
  "priority": "high",
  "assignee": {
    "id": "{user_id}",
    "name": "Ana",
    "email": "ana@example.com"
  },
  "creatorId": "{user_id}",
  "cycle": {
    "id": "{cycle_id}",
    "name": "Cycle 4"
  },
  "milestoneId": null,
  "parentId": null,
  "estimate": 3,
  "labels": [
    {
      "id": "{label_id}",
      "name": "bug",
      "color": "#d14343"
    }
  ],
  "startDate": null,
  "dueDate": "2026-11-04",
  "triage": false,
  "source": "api",
  "createdAt": "2026-10-25T14:02:11.000Z",
  "updatedAt": "2026-10-25T15:10:00.000Z"
}

Ver un issue

GET/api/v1/track/issues/{id}

Por id o identificador (WEB-12).

Scope track:read

NombreTipoRequeridoDescripción
idstringSíId o identificador del issue (WEB-12).
curl -X GET "https://zerosoft.ai/api/v1/track/issues/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "{issue_id}",
  "identifier": "WEB-12",
  "title": "Checkout button does nothing on Safari",
  "description": "Steps: open /pricing, press Buy.",
  "url": "https://zerosoft.ai/app/track/issues/{issue_id}",
  "projectId": "{team_id}",
  "teamId": "{team_id}",
  "planId": null,
  "status": {
    "id": "{status_id}",
    "name": "In Progress",
    "category": "in_progress",
    "color": "#000000"
  },
  "priority": "high",
  "assignee": {
    "id": "{user_id}",
    "name": "Ana",
    "email": "ana@example.com"
  },
  "creatorId": "{user_id}",
  "cycle": {
    "id": "{cycle_id}",
    "name": "Cycle 4"
  },
  "milestoneId": null,
  "parentId": null,
  "estimate": 3,
  "labels": [
    {
      "id": "{label_id}",
      "name": "bug",
      "color": "#d14343"
    }
  ],
  "startDate": null,
  "dueDate": "2026-11-04",
  "triage": false,
  "source": "api",
  "createdAt": "2026-10-25T14:02:11.000Z",
  "updatedAt": "2026-10-25T15:10:00.000Z"
}

Editar un issue

PATCH/api/v1/track/issues/{id}

Mandá solo lo que cambia. Cambiar status o asignado acepta un issue que está en triage.

Scope track:write

NombreTipoRequeridoDescripción
idstringSíId o identificador del issue (WEB-12).
statusstringNoNombre del status ("In Progress") o categoría (in_progress).
assigneeEmailstringNoEmail de un miembro del equipo.
priorityurgent | high | medium | lowNoPrioridad.
curl -X PATCH "https://zerosoft.ai/api/v1/track/issues/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "status": "Done"
}'

Request

{
  "status": "Done"
}

Respuesta · 200

{
  "id": "{issue_id}",
  "identifier": "WEB-12",
  "title": "Checkout button does nothing on Safari",
  "description": "Steps: open /pricing, press Buy.",
  "url": "https://zerosoft.ai/app/track/issues/{issue_id}",
  "projectId": "{team_id}",
  "teamId": "{team_id}",
  "planId": null,
  "status": {
    "id": "{status_id}",
    "name": "Done",
    "category": "done",
    "color": "#000000"
  },
  "priority": "high",
  "assignee": {
    "id": "{user_id}",
    "name": "Ana",
    "email": "ana@example.com"
  },
  "creatorId": "{user_id}",
  "cycle": {
    "id": "{cycle_id}",
    "name": "Cycle 4"
  },
  "milestoneId": null,
  "parentId": null,
  "estimate": 3,
  "labels": [
    {
      "id": "{label_id}",
      "name": "bug",
      "color": "#d14343"
    }
  ],
  "startDate": null,
  "dueDate": "2026-11-04",
  "triage": false,
  "source": "api",
  "createdAt": "2026-10-25T14:02:11.000Z",
  "updatedAt": "2026-10-25T15:10:00.000Z"
}

Borrar un issue

DELETE/api/v1/track/issues/{id}

Borra el issue y sus sub-issues.

Scope track:write

NombreTipoRequeridoDescripción
idstringSíId o identificador del issue (WEB-12).
curl -X DELETE "https://zerosoft.ai/api/v1/track/issues/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "{issue_id}",
  "deleted": true
}

Listar comentarios

GET/api/v1/track/issues/{id}/comments

Comentarios de un issue, los más viejos primero.

Scope track:read

NombreTipoRequeridoDescripción
idstringSíId o identificador del issue (WEB-12).
curl -X GET "https://zerosoft.ai/api/v1/track/issues/{id}/comments" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "{comment_id}",
      "issueId": "{issue_id}",
      "body": "Reproduced on Safari 18.",
      "author": {
        "id": "{user_id}",
        "name": "Ana",
        "email": "ana@example.com"
      },
      "createdAt": "2026-10-25T15:00:00.000Z",
      "updatedAt": "2026-10-25T15:00:00.000Z"
    }
  ]
}

Comentar

POST/api/v1/track/issues/{id}/comments

Comenta como el dueño de la key en markdown y avisa a suscriptos y menciones.

Scope track:write

NombreTipoRequeridoDescripción
idstringSíId o identificador del issue (WEB-12).
bodystringSíComentario en markdown.
curl -X POST "https://zerosoft.ai/api/v1/track/issues/{id}/comments" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "body": "Deployed the fix to staging."
}'

Request

{
  "body": "Deployed the fix to staging."
}

Respuesta · 201

{
  "id": "{comment_id}",
  "issueId": "{issue_id}",
  "body": "Deployed the fix to staging.",
  "author": {
    "id": "{user_id}",
    "name": "Ana",
    "email": "ana@example.com"
  },
  "createdAt": "2026-10-25T16:00:00.000Z",
  "updatedAt": "2026-10-25T16:00:00.000Z"
}

Listar equipos

GET/api/v1/track/teams

Equipos activos que ve la key. includeArchived=true suma los archivados.

Scope track:read

curl -X GET "https://zerosoft.ai/api/v1/track/teams" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "{team_id}",
      "name": "Web",
      "key": "WEB",
      "description": "",
      "icon": null,
      "color": "#000000",
      "status": "active",
      "visibility": "workspace",
      "triageEnabled": true,
      "url": "https://zerosoft.ai/app/track/team/WEB",
      "createdAt": "2026-09-01T10:00:00.000Z",
      "updatedAt": "2026-10-20T10:00:00.000Z"
    }
  ]
}

Crear un equipo

POST/api/v1/track/teams

Solo admins. Crea los status por defecto. key es el prefijo de los identificadores.

Scope track:write

NombreTipoRequeridoDescripción
namestringSíNombre
keystringNoPrefijo de los identificadores, letras y números (WEB).
descriptionstringNoDescripción
curl -X POST "https://zerosoft.ai/api/v1/track/teams" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "Web",
  "key": "WEB"
}'

Request

{
  "name": "Web",
  "key": "WEB"
}

Respuesta · 201

{
  "id": "{team_id}",
  "name": "Web",
  "key": "WEB",
  "description": "",
  "icon": null,
  "color": "#000000",
  "status": "active",
  "visibility": "workspace",
  "triageEnabled": true,
  "url": "https://zerosoft.ai/app/track/team/WEB",
  "createdAt": "2026-09-01T10:00:00.000Z",
  "updatedAt": "2026-10-20T10:00:00.000Z"
}

Ver un equipo

GET/api/v1/track/teams/{id}

Por id o clave, con sus status.

Scope track:read

NombreTipoRequeridoDescripción
idstringSíId o clave del equipo (WEB). projectId también funciona.
curl -X GET "https://zerosoft.ai/api/v1/track/teams/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "id": "{team_id}",
  "name": "Web",
  "key": "WEB",
  "description": "",
  "icon": null,
  "color": "#000000",
  "status": "active",
  "visibility": "workspace",
  "triageEnabled": true,
  "url": "https://zerosoft.ai/app/track/team/WEB",
  "createdAt": "2026-09-01T10:00:00.000Z",
  "updatedAt": "2026-10-20T10:00:00.000Z",
  "statuses": [
    {
      "id": "{status_id}",
      "projectId": "{project_id}",
      "name": "Todo",
      "category": "todo",
      "color": "#000000",
      "position": 1
    }
  ]
}

Editar un equipo

PATCH/api/v1/track/teams/{id}

Nombre, descripción, color e icono. Archivar y triage piden una key de admin.

Scope track:write

NombreTipoRequeridoDescripción
idstringSíId o clave del equipo (WEB). projectId también funciona.
statusactive | archivedNoactive o archived.
curl -X PATCH "https://zerosoft.ai/api/v1/track/teams/{id}" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "description": "Marketing site and checkout"
}'

Request

{
  "description": "Marketing site and checkout"
}

Respuesta · 200

{
  "id": "{team_id}",
  "name": "Web",
  "key": "WEB",
  "description": "",
  "icon": null,
  "color": "#000000",
  "status": "active",
  "visibility": "workspace",
  "triageEnabled": true,
  "url": "https://zerosoft.ai/app/track/team/WEB",
  "createdAt": "2026-09-01T10:00:00.000Z",
  "updatedAt": "2026-10-20T10:00:00.000Z"
}

Listar cycles

GET/api/v1/track/teams/{id}/cycles

Cycles de un equipo.

Scope track:read

NombreTipoRequeridoDescripción
idstringSíId o clave del equipo (WEB). projectId también funciona.
curl -X GET "https://zerosoft.ai/api/v1/track/teams/{id}/cycles" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "{cycle_id}",
      "projectId": "{project_id}",
      "name": "Cycle 4",
      "startAt": "2026-10-20",
      "endAt": "2026-11-02",
      "completedAt": null
    }
  ]
}

Crear un cycle

POST/api/v1/track/teams/{id}/cycles

Fechas en YYYY-MM-DD.

Scope track:write

NombreTipoRequeridoDescripción
namestringSíNombre
startAtstringSíFecha, YYYY-MM-DD.
endAtstringSíFecha, YYYY-MM-DD.
curl -X POST "https://zerosoft.ai/api/v1/track/teams/{id}/cycles" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "Cycle 5",
  "startAt": "2026-11-03",
  "endAt": "2026-11-16"
}'

Request

{
  "name": "Cycle 5",
  "startAt": "2026-11-03",
  "endAt": "2026-11-16"
}

Respuesta · 201

{
  "id": "{cycle_id}",
  "projectId": "{project_id}",
  "name": "Cycle 5",
  "startAt": "2026-11-03",
  "endAt": "2026-11-16",
  "completedAt": null
}

Listar status

GET/api/v1/track/teams/{id}/statuses

Status del workflow de un equipo en orden, con su categoría.

Scope track:read

NombreTipoRequeridoDescripción
idstringSíId o clave del equipo (WEB). projectId también funciona.
curl -X GET "https://zerosoft.ai/api/v1/track/teams/{id}/statuses" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "{status_id}",
      "projectId": "{project_id}",
      "name": "In Progress",
      "category": "in_progress",
      "color": "#000000",
      "position": 2
    }
  ]
}

Listar labels

GET/api/v1/track/labels

Labels del workspace. POST con name y teamId crea uno.

Scope track:read

curl -X GET "https://zerosoft.ai/api/v1/track/labels" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "{label_id}",
      "name": "bug",
      "color": "#d14343",
      "workspaceId": "{workspace_id}"
    }
  ]
}

Listar personas

GET/api/v1/track/users

Personas que se pueden asignar, de un equipo o de todos.

Scope track:read

NombreTipoRequeridoDescripción
teamIdstringNoId o clave del equipo (WEB). projectId también funciona.
curl -X GET "https://zerosoft.ai/api/v1/track/users" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "{user_id}",
      "name": "Ana",
      "email": "ana@example.com",
      "role": "member"
    }
  ]
}

Servidor MCP de Track

Model Context Protocol por Streamable HTTP en /api/mcp/track (solo lectura en /api/mcp/track/readonly). Autenticación con una API key como Bearer. Herramientas: search_issues, get_issue, create_issue, update_issue, add_comment, list_teams, get_team, list_cycles, list_labels, list_users.

Llamar a una herramienta

POST/api/mcp/track

JSON-RPC 2.0: initialize, tools/list y tools/call. Las herramientas que escriben piden track:write.

Scope track:read

curl -X POST "https://zerosoft.ai/api/mcp/track" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_issues",
    "arguments": {
      "query": "checkout",
      "statusCategory": "in_progress"
    }
  }
}'

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_issues",
    "arguments": {
      "query": "checkout",
      "statusCategory": "in_progress"
    }
  }
}

Respuesta · 200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ \"total\": 1, \"issues\": [ … ] }"
      }
    ],
    "isError": false
  }
}

Docs

Leé y escribí páginas, bloques, bases, filas y comentarios de Docs. El contenido entra y sale en Markdown (o en bloques de Docs). Una key actúa como la persona que la creó: solo ve y edita las páginas que esa persona puede abrir. Las bases sincronizadas son de solo lectura.

Listar páginas

GET/api/v1/docs/pages

Páginas que la key puede leer, más nuevas primero. Con q busca en títulos y contenido.

Scope docs:read

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
parentstringNoSolo páginas dentro de este id (root para las de arriba).
limitnumberNoCuántos devolver (1 a 100, 50 por defecto).
offsetnumberNoCuántos saltear, para paginar.
curl -X GET "https://zerosoft.ai/api/v1/docs/pages" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "pg_1",
      "title": "Launch plan",
      "icon": null,
      "parentId": null,
      "url": "/app/docs/pg_1",
      "createdAt": "2026-11-01T12:00:00.000Z",
      "updatedAt": "2026-11-02T09:30:00.000Z",
      "archived": false
    }
  ],
  "hasMore": false
}

Crear una página

POST/api/v1/docs/pages

Crea una página desde Markdown o bloques, dentro de otra (parentId) o desde una plantilla (id de plantilla del workspace o builtin:<key>). Las {{variables}} de la plantilla se completan con vars.

Scope docs:write

NombreTipoRequeridoDescripción
titlestringNoTítulo de la página.
markdownstringNoContenido en Markdown (títulos, listas, to-dos, citas, código, tablas).
parentIdstringNoCrearla como subpágina de esta página.
templateIdstringNoId de plantilla del workspace o builtin:<key>.
curl -X POST "https://zerosoft.ai/api/v1/docs/pages" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "title": "Launch plan",
  "parentId": "pg_root",
  "markdown": "## Goals\n\n- [ ] Ship the beta"
}'

Request

{
  "title": "Launch plan",
  "parentId": "pg_root",
  "markdown": "## Goals\n\n- [ ] Ship the beta"
}

Respuesta · 201

{
  "data": {
    "id": "pg_1",
    "title": "Launch plan",
    "icon": null,
    "parentId": null,
    "url": "/app/docs/pg_1",
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T09:30:00.000Z",
    "archived": false,
    "access": "owner",
    "markdown": "## Goals\n\n- [ ] Ship the beta",
    "databases": []
  }
}

Leer una página

GET/api/v1/docs/pages/:id

La página con su contenido en Markdown y sus bases. Con format=blocks trae también los bloques.

Scope docs:read

NombreTipoRequeridoDescripción
formatstringNoblocks para traer también los bloques.
curl -X GET "https://zerosoft.ai/api/v1/docs/pages/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "id": "pg_1",
    "title": "Launch plan",
    "icon": null,
    "parentId": null,
    "url": "/app/docs/pg_1",
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T09:30:00.000Z",
    "archived": false,
    "access": "edit",
    "markdown": "## Goals\n\n- [ ] Ship the beta",
    "databases": [
      {
        "blockId": "b_1",
        "title": "Tasks",
        "rows": 12,
        "synced": false
      }
    ]
  }
}

Actualizar una página

PATCH/api/v1/docs/pages/:id

Cambia el título o el ícono, reemplaza el contenido (las bases de la página se conservan) o la manda a la papelera y la saca (archived).

Scope docs:write

NombreTipoRequeridoDescripción
titlestringNoTítulo de la página.
markdownstringNoReemplaza todo el contenido (las bases se conservan).
archivedbooleanNotrue la manda a la papelera, false la restaura.
curl -X PATCH "https://zerosoft.ai/api/v1/docs/pages/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "title": "Launch plan (Q4)"
}'

Request

{
  "title": "Launch plan (Q4)"
}

Respuesta · 200

{
  "data": {
    "id": "pg_1",
    "title": "Launch plan (Q4)",
    "icon": null,
    "parentId": null,
    "url": "/app/docs/pg_1",
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T09:30:00.000Z",
    "archived": false,
    "access": "owner",
    "markdown": "",
    "databases": []
  }
}

Mandar una página a la papelera

DELETE/api/v1/docs/pages/:id

Manda la página y sus subpáginas a la papelera. Se restaura con PATCH archived: false.

Scope docs:write

curl -X DELETE "https://zerosoft.ai/api/v1/docs/pages/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Listar bloques

GET/api/v1/docs/pages/:id/blocks

Los bloques de una página en formato Docs (tipo, contenido en HTML-lite, anidado con indent).

Scope docs:read

curl -X GET "https://zerosoft.ai/api/v1/docs/pages/:id/blocks" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "b_1",
      "type": "heading",
      "level": 2,
      "content": "Goals"
    },
    {
      "id": "b_2",
      "type": "todo",
      "content": "Ship the beta",
      "checked": false
    }
  ]
}

Agregar bloques

POST/api/v1/docs/pages/:id/blocks

Agrega Markdown o bloques al final de la página, o debajo del bloque de after. Quien tiene la página abierta lo ve fusionado en su editor.

Scope docs:write

NombreTipoRequeridoDescripción
markdownstringNoContenido en Markdown (títulos, listas, to-dos, citas, código, tablas).
blocksobject[]NoBloques en formato Docs (en vez de Markdown).
afterstringNoInsertar debajo de este id de bloque.
curl -X POST "https://zerosoft.ai/api/v1/docs/pages/:id/blocks" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "markdown": "- [ ] Write the release notes"
}'

Request

{
  "markdown": "- [ ] Write the release notes"
}

Respuesta · 201

{
  "data": {
    "id": "pg_1",
    "title": "Launch plan",
    "icon": null,
    "parentId": null,
    "url": "/app/docs/pg_1",
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T09:30:00.000Z",
    "archived": false,
    "access": "owner",
    "markdown": "- [ ] Write the release notes",
    "databases": []
  }
}

Listar comentarios

GET/api/v1/docs/pages/:id/comments

Comentarios e hilos de una página.

Scope docs:read

curl -X GET "https://zerosoft.ai/api/v1/docs/pages/:id/comments" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "cm_1",
      "pageId": "pg_1",
      "blockId": null,
      "parentId": null,
      "text": "Can we ship this in May?",
      "resolved": false,
      "author": {
        "id": "u_1",
        "name": "Ada",
        "email": "ada@example.com"
      },
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

Comentar

POST/api/v1/docs/pages/:id/comments

Comenta la página o un bloque, o responde un hilo, como la persona que creó la key.

Scope docs:write

NombreTipoRequeridoDescripción
textstringSíTexto del comentario.
blockIdstringNoComentar este bloque.
parentIdstringNoResponder en el hilo de este comentario.
curl -X POST "https://zerosoft.ai/api/v1/docs/pages/:id/comments" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "text": "Done, the beta is live."
}'

Request

{
  "text": "Done, the beta is live."
}

Respuesta · 201

{
  "data": {
    "id": "cm_2",
    "pageId": "pg_1",
    "blockId": null,
    "parentId": null,
    "text": "Done, the beta is live.",
    "resolved": false,
    "author": {
      "id": "u_1",
      "name": "Ada",
      "email": "ada@example.com"
    },
    "createdAt": "2026-11-02T11:00:00.000Z"
  }
}

Listar bases

GET/api/v1/docs/databases

Bases de las páginas que la key puede leer, con sus propiedades y opciones.

Scope docs:read

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
curl -X GET "https://zerosoft.ai/api/v1/docs/databases" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "pageId": "pg_1",
      "blockId": "b_1",
      "title": "Tasks",
      "page": {
        "id": "pg_1",
        "title": "Launch plan"
      },
      "synced": null,
      "properties": [
        {
          "id": "title",
          "name": "Name",
          "type": "title"
        },
        {
          "id": "status",
          "name": "Status",
          "type": "status",
          "options": [
            "Not started",
            "In progress",
            "Done"
          ]
        }
      ],
      "rowCount": 12
    }
  ]
}

Leer una base

GET/api/v1/docs/databases/:pageId/:blockId

Propiedades de una base y, si está sincronizada, de dónde viene.

Scope docs:read

curl -X GET "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "pageId": "pg_1",
    "blockId": "b_1",
    "title": "Issues",
    "page": {
      "id": "pg_1",
      "title": "Engineering"
    },
    "synced": {
      "provider": "github",
      "label": "acme/web · Issues",
      "syncedAt": "2026-11-02T10:15:00.000Z"
    },
    "properties": [
      {
        "id": "title",
        "name": "Title",
        "type": "title"
      }
    ],
    "rowCount": 40
  }
}

Consultar filas

GET/api/v1/docs/databases/:pageId/:blockId/rows

Filas de una base con sus propiedades como texto (properties) y valores crudos (values). filter[Propiedad]=texto deja las filas cuyo valor lo contiene.

Scope docs:read

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
filter[Property]stringNoDeja las filas cuya Propiedad contiene el texto.
limitnumberNoCuántos devolver (1 a 100, 50 por defecto).
offsetnumberNoCuántos saltear, para paginar.
curl -X GET "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "r_1",
      "title": "Website refresh",
      "url": "/app/docs/pg_1?row=r_1",
      "properties": {
        "Status": "In progress",
        "Owner": "Ada"
      },
      "values": {
        "Status": "opt_2",
        "Owner": [
          "u_1"
        ]
      },
      "createdAt": "2026-11-01T12:00:00.000Z",
      "updatedAt": "2026-11-02T09:00:00.000Z"
    }
  ],
  "total": 1,
  "hasMore": false
}

Agregar una fila

POST/api/v1/docs/databases/:pageId/:blockId/rows

Agrega una fila. properties va de nombre (o id) de propiedad a valor: las opciones de select se crean si faltan, las personas van por email y las fechas como AAAA-MM-DD. Las automatizaciones de la base corren como siempre.

Scope docs:write

NombreTipoRequeridoDescripción
titlestringNoTítulo de la fila.
propertiesobjectNoNombre o id de propiedad → valor.
markdownstringNoContenido de la fila en Markdown.
templatestringNoPlantilla de fila de la base (id o nombre).
curl -X POST "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "title": "Website refresh",
  "properties": {
    "Status": "In progress",
    "Owner": "ada@example.com",
    "Tags": [
      "web",
      "q4"
    ]
  }
}'

Request

{
  "title": "Website refresh",
  "properties": {
    "Status": "In progress",
    "Owner": "ada@example.com",
    "Tags": [
      "web",
      "q4"
    ]
  }
}

Respuesta · 201

{
  "data": {
    "id": "r_2",
    "title": "Website refresh",
    "url": "/app/docs/pg_1?row=r_2",
    "properties": {
      "Status": "In progress",
      "Owner": "Ada",
      "Tags": "web, q4"
    },
    "values": {},
    "createdAt": "2026-11-02T12:00:00.000Z",
    "updatedAt": "2026-11-02T12:00:00.000Z"
  }
}

Leer una fila

GET/api/v1/docs/databases/:pageId/:blockId/rows/:rowId

Una fila con sus propiedades y su contenido en Markdown.

Scope docs:read

curl -X GET "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows/:rowId" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "id": "r_1",
    "title": "Website refresh",
    "url": "/app/docs/pg_1?row=r_1",
    "properties": {
      "Status": "In progress"
    },
    "values": {},
    "markdown": "Brief and links.",
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T09:00:00.000Z"
  }
}

Actualizar una fila

PATCH/api/v1/docs/databases/:pageId/:blockId/rows/:rowId

Cambia propiedades, el título o el contenido de una fila.

Scope docs:write

NombreTipoRequeridoDescripción
propertiesobjectNoNombre o id de propiedad → valor.
titlestringNoTítulo de la fila.
appendMarkdownstringNoMarkdown para agregar al final del contenido de la fila.
curl -X PATCH "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows/:rowId" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "properties": {
    "Status": "Done"
  }
}'

Request

{
  "properties": {
    "Status": "Done"
  }
}

Respuesta · 200

{
  "data": {
    "id": "r_1",
    "title": "Website refresh",
    "url": "/app/docs/pg_1?row=r_1",
    "properties": {
      "Status": "Done"
    },
    "values": {},
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T13:00:00.000Z"
  }
}

Borrar una fila

DELETE/api/v1/docs/databases/:pageId/:blockId/rows/:rowId

Borra la fila. Queda en el historial de la página.

Scope docs:write

curl -X DELETE "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows/:rowId" \
  -H "Authorization: Bearer zs_live_9f3k..."

Servidor MCP

POST/api/v1/docs/mcp

Model Context Protocol sobre HTTP (JSON-RPC). Métodos: initialize, tools/list, tools/call. Herramientas: search, fetch_page, create_page, update_page, list_databases, get_database, query_database, get_row, create_row, update_row, list_comments, add_comment. Las que escriben piden docs:write.

Scope docs:read

curl -X POST "https://zerosoft.ai/api/v1/docs/mcp" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "launch plan"
    }
  }
}'

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "launch plan"
    }
  }
}

Respuesta · 200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"results\":[...]}"
      }
    ],
    "isError": false
  }
}

Notes

Leé y escribí tus notas. Una key actúa como la persona que la creó y solo ve sus notas. Las notas bloqueadas no devuelven contenido.

Listar notas

GET/api/v1/notes

Tus notas, primero las más recientes. q acepta los mismos operadores que la app (tag:, notebook:, intitle:, todo:).

Scope notes:read

curl -X GET "https://zerosoft.ai/api/v1/notes" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "note_1",
      "title": "Weekly review",
      "snippet": "Send the report",
      "notebookId": null,
      "tags": [
        "work"
      ],
      "pinned": false,
      "trashed": false,
      "locked": false,
      "sourceUrl": null,
      "createdAt": "2026-11-01T12:00:00.000Z",
      "updatedAt": "2026-11-02T09:30:00.000Z"
    }
  ],
  "hasMore": false
}

Crear una nota

POST/api/v1/notes

Crea una nota desde Markdown o bloques.

Scope notes:write

curl -X POST "https://zerosoft.ai/api/v1/notes" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "title": "Weekly review",
  "markdown": "- [ ] Send the report",
  "tags": [
    "work"
  ]
}'

Request

{
  "title": "Weekly review",
  "markdown": "- [ ] Send the report",
  "tags": [
    "work"
  ]
}

Respuesta · 201

{
  "data": {
    "id": "note_1",
    "title": "Weekly review",
    "snippet": "Send the report",
    "notebookId": null,
    "tags": [
      "work"
    ],
    "pinned": false,
    "trashed": false,
    "locked": false,
    "sourceUrl": null,
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T09:30:00.000Z",
    "markdown": "- [ ] Send the report"
  }
}

Leer una nota

GET/api/v1/notes/:id

Una nota con su contenido en Markdown y bloques.

Scope notes:read

curl -X GET "https://zerosoft.ai/api/v1/notes/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "id": "note_1",
    "title": "Weekly review",
    "snippet": "Send the report",
    "notebookId": null,
    "tags": [
      "work"
    ],
    "pinned": false,
    "trashed": false,
    "locked": false,
    "sourceUrl": null,
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T09:30:00.000Z",
    "markdown": "- [ ] Send the report"
  }
}

Editar una nota

PATCH/api/v1/notes/:id

Cambia título, etiquetas, libreta, fijado o contenido.

Scope notes:write

curl -X PATCH "https://zerosoft.ai/api/v1/notes/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "title": "Weekly review (done)",
  "pinned": true
}'

Request

{
  "title": "Weekly review (done)",
  "pinned": true
}

Respuesta · 200

{
  "data": {
    "id": "note_1",
    "title": "Weekly review",
    "snippet": "Send the report",
    "notebookId": null,
    "tags": [
      "work"
    ],
    "pinned": true,
    "trashed": false,
    "locked": false,
    "sourceUrl": null,
    "createdAt": "2026-11-01T12:00:00.000Z",
    "updatedAt": "2026-11-02T09:30:00.000Z"
  }
}

Mandar a la papelera

DELETE/api/v1/notes/:id

Mueve la nota a la papelera.

Scope notes:write

curl -X DELETE "https://zerosoft.ai/api/v1/notes/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "id": "note_1",
    "trashed": true
  }
}

Listar libretas

GET/api/v1/notes/notebooks

Tus libretas con su cantidad de notas.

Scope notes:read

curl -X GET "https://zerosoft.ai/api/v1/notes/notebooks" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "nb_1",
      "name": "Work",
      "count": 12,
      "stack": null
    }
  ]
}

Servidor MCP

POST/api/v1/notes/mcp

Endpoint de Model Context Protocol. Herramientas: search_notes, read_note, list_notebooks, list_tasks, create_note y update_note.

Scope notes:read

curl -X POST "https://zerosoft.ai/api/v1/notes/mcp" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_notes",
    "arguments": {
      "query": "tag:work"
    }
  }
}'

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_notes",
    "arguments": {
      "query": "tag:work"
    }
  }
}

Respuesta · 200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"notes\":[...]}"
      }
    ],
    "isError": false
  }
}

Talk

Mensajería de equipo. La key actúa como la persona que la creó: ve los canales que ve esa persona y publica donde es miembro (en un canal público se une al publicar). Los mensajes directos no están en la API. Permisos talk:read y talk:write.

Listar canales

GET/api/v1/talk/channels

Los canales donde está la persona de la key, o con scope=all los públicos y los privados donde está.

Scope talk:read

NombreTipoRequeridoDescripción
scopestringNomember (por defecto) o all
qstringNoQuery de búsqueda.
curl -X GET "https://zerosoft.ai/api/v1/talk/channels" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "tc_1",
      "name": "general",
      "kind": "public",
      "topic": "Company news",
      "description": "",
      "archived": false,
      "member_count": 8,
      "is_member": true,
      "created_at": "2026-10-25T12:00:00.000Z"
    }
  ]
}

Crear un canal

POST/api/v1/talk/channels

Crea un canal público o privado. El nombre se guarda como en Slack: en minúsculas y con guiones en vez de espacios.

Scope talk:write

NombreTipoRequeridoDescripción
namestringSíNombre del canal
kindstringNopublic (por defecto) o private
topicstringNoTema del canal
curl -X POST "https://zerosoft.ai/api/v1/talk/channels" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "launch-q4",
  "kind": "public",
  "topic": "Q4 launch"
}'

Request

{
  "name": "launch-q4",
  "kind": "public",
  "topic": "Q4 launch"
}

Respuesta · 201

{
  "data": {
    "id": "tc_2",
    "name": "launch-q4",
    "kind": "public",
    "topic": "Q4 launch",
    "description": "",
    "archived": false,
    "member_count": 1,
    "is_member": true,
    "created_at": "2026-10-25T12:00:00.000Z"
  }
}

Listar mensajes

GET/api/v1/talk/messages

Los mensajes del canal, del más viejo al más nuevo. Las menciones vienen como tokens con el id de la persona, más los de canal y aquí.

Scope talk:read

NombreTipoRequeridoDescripción
channelstringSíId o nombre del canal (general o #general)
beforestringNoFecha ISO: los mensajes anteriores (para paginar)
limitnumberNoCantidad máxima de resultados.
curl -X GET "https://zerosoft.ai/api/v1/talk/messages" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "tm_1",
      "channel_id": "tc_1",
      "thread_id": null,
      "user_id": "u_1",
      "bot_name": null,
      "text": "Deploy done <@u_2>",
      "files": [],
      "reactions": [
        {
          "emoji": "🎉",
          "count": 2,
          "users": [
            "u_2",
            "u_3"
          ]
        }
      ],
      "reply_count": 1,
      "edited_at": null,
      "pinned": false,
      "created_at": "2026-10-25T12:05:00.000Z"
    }
  ],
  "has_more": false
}

Enviar un mensaje

POST/api/v1/talk/messages

Publica en un canal o responde en un hilo. Menciones, avisos, vistas previas de links, Flow y webhooks corren igual que desde la app.

Scope talk:write

NombreTipoRequeridoDescripción
channelstringSíId o nombre del canal (general o #general)
textstringSíTexto del mensaje, con el mismo formato que la app (*negrita*, _itálica_, `código`, links, :emoji:)
thread_idstringNoId del mensaje raíz para responder en su hilo
also_in_channelbooleanNoCon thread_id, mostrar la respuesta también en el canal
curl -X POST "https://zerosoft.ai/api/v1/talk/messages" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "channel": "general",
  "text": "Release *2.4* is live :tada:"
}'

Request

{
  "channel": "general",
  "text": "Release *2.4* is live :tada:"
}

Respuesta · 201

{
  "data": {
    "id": "tm_2",
    "channel_id": "tc_1",
    "thread_id": null,
    "user_id": "u_1",
    "bot_name": null,
    "text": "Release *2.4* is live :tada:",
    "files": [],
    "reactions": [],
    "reply_count": 0,
    "edited_at": null,
    "pinned": false,
    "created_at": "2026-10-25T12:06:00.000Z"
  }
}

Webhook entrante

POST/api/talk/hooks/:token

Sin API key: creá la URL en un canal (Detalles, Integraciones) y mandá un POST con un JSON con text. Publica como bot con el nombre del webhook. 60 pedidos por minuto por webhook.

NombreTipoRequeridoDescripción
textstringSíTexto del mensaje, con el mismo formato que la app (*negrita*, _itálica_, `código`, links, :emoji:)
usernamestringNoNombre del bot en el mensaje (por defecto, el del webhook)
thread_idstringNoId del mensaje raíz para responder en su hilo
curl -X POST "https://zerosoft.ai/api/talk/hooks/:token" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "text": "Build *green* on main",
  "username": "CI"
}'

Request

{
  "text": "Build *green* on main",
  "username": "CI"
}

Respuesta · 200

{
  "ok": true,
  "id": "tm_3"
}

Board

Pizarras: listarlas y buscarlas (también por el texto de adentro), leer un resumen, crearlas desde una plantilla, sumarles stickies, formas y flechas, renombrarlas, moverlas a una carpeta o mandarlas a la papelera. La key actúa como la persona que la creó: ve y edita las pizarras que esa persona puede abrir. Quien tiene la pizarra abierta ve los cambios en vivo. Scopes boards:read y boards:write.

Listar pizarras

GET/api/v1/boards

Las pizarras que puede abrir la persona de la key, la editada más reciente primero. Con q busca también en stickies, etiquetas y nombres de frames, y devuelve la línea que coincidió en match.

Scope boards:read

NombreTipoRequeridoDescripción
qstringNoBusca en el nombre y en el texto de adentro.
folderstringNoId de la carpeta.
limitnumberNoCantidad máxima de resultados.
curl -X GET "https://zerosoft.ai/api/v1/boards" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "b_1",
      "name": "Q4 retro",
      "folderId": null,
      "access": "workspace",
      "version": 12,
      "updatedAt": "2026-10-28T12:00:00.000Z",
      "createdAt": "2026-10-20T09:00:00.000Z",
      "updatedBy": "Ana"
    }
  ]
}

Crear una pizarra

POST/api/v1/boards

Vacía o desde una plantilla: retro, brainstorm, userFlow, kanban, roadmap, swot, mindMap, priorityMatrix, journey o leanCanvas.

Scope boards:write

NombreTipoRequeridoDescripción
namestringNoNombre de la pizarra.
templatestringNoClave de la plantilla.
folderIdstringNoId de la carpeta.
curl -X POST "https://zerosoft.ai/api/v1/boards" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "Q4 retro",
  "template": "retro",
  "locale": "en"
}'

Request

{
  "name": "Q4 retro",
  "template": "retro",
  "locale": "en"
}

Respuesta · 201

{
  "data": {
    "id": "b_1",
    "name": "Q4 retro",
    "folderId": null,
    "access": "workspace",
    "version": 12,
    "updatedAt": "2026-10-28T12:00:00.000Z",
    "createdAt": "2026-10-20T09:00:00.000Z",
    "updatedBy": "Ana"
  }
}

Leer una pizarra

GET/api/v1/boards/:id

La pizarra con un resumen: frames en orden de lectura, stickies con texto y etiquetas, textos sueltos. Con scene=1, también la escena de Excalidraw.

Scope boards:read

NombreTipoRequeridoDescripción
scenestringNo1 para incluir la escena de Excalidraw.
curl -X GET "https://zerosoft.ai/api/v1/boards/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": {
    "id": "b_1",
    "name": "Q4 retro",
    "folderId": null,
    "access": "workspace",
    "version": 12,
    "updatedAt": "2026-10-28T12:00:00.000Z",
    "createdAt": "2026-10-20T09:00:00.000Z",
    "updatedBy": "Ana",
    "myAccess": "edit",
    "outline": {
      "frames": [
        {
          "id": "f_1",
          "name": "Agenda"
        }
      ],
      "stickies": [
        {
          "id": "s_1",
          "text": "Ship the beta",
          "tags": [
            "launch"
          ],
          "frameId": null
        }
      ],
      "texts": [],
      "elementCount": 14
    }
  }
}

Modificar una pizarra

PATCH/api/v1/boards/:id

La renombra o la mueve a una carpeta (folderId null la saca).

Scope boards:write

NombreTipoRequeridoDescripción
namestringNoNombre de la pizarra.
folderIdstringNoId de la carpeta.
curl -X PATCH "https://zerosoft.ai/api/v1/boards/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "name": "Q4 retro (final)"
}'

Request

{
  "name": "Q4 retro (final)"
}

Respuesta · 200

{
  "data": {
    "id": "b_1",
    "name": "Q4 retro (final)",
    "folderId": null,
    "access": "workspace",
    "version": 12,
    "updatedAt": "2026-10-28T12:00:00.000Z",
    "createdAt": "2026-10-20T09:00:00.000Z",
    "updatedBy": "Ana"
  }
}

Borrar una pizarra

DELETE/api/v1/boards/:id

La manda a la papelera. Se puede restaurar desde la app durante 30 días.

Scope boards:write

curl -X DELETE "https://zerosoft.ai/api/v1/boards/:id" \
  -H "Authorization: Bearer zs_live_9f3k..."

Sumar stickies y formas

POST/api/v1/boards/:id/elements

Suma stickies, textos y formas, y flechas entre ellos por índice. Sin x e y se acomodan al lado del contenido. No cambia nada de lo que ya hay.

Scope boards:write

NombreTipoRequeridoDescripción
stickiesarrayNoStickies: { text, color?, tags? }. Colores: yellow, green, blue, pink, violet, orange.
elementsarrayNoFormas y textos: { kind, text?, x?, y?, width?, height?, fill? } con kind sticky, text, rectangle, ellipse o diamond.
connectarrayNoFlechas entre elementos por índice: { from, to }.
curl -X POST "https://zerosoft.ai/api/v1/boards/:id/elements" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "elements": [
    {
      "kind": "ellipse",
      "text": "Start"
    },
    {
      "kind": "rectangle",
      "text": "Sign up"
    }
  ],
  "connect": [
    {
      "from": 0,
      "to": 1
    }
  ]
}'

Request

{
  "elements": [
    {
      "kind": "ellipse",
      "text": "Start"
    },
    {
      "kind": "rectangle",
      "text": "Sign up"
    }
  ],
  "connect": [
    {
      "from": 0,
      "to": 1
    }
  ]
}

Respuesta · 201

{
  "data": {
    "version": 13,
    "added": [
      {
        "id": "e_1",
        "type": "ellipse"
      },
      {
        "id": "e_2",
        "type": "rectangle"
      },
      {
        "id": "e_3",
        "type": "arrow"
      }
    ]
  }
}

Servidor MCP

POST/api/v1/boards/mcp

Model Context Protocol (streamable HTTP, respuestas JSON) para agentes de IA. Herramientas: list_boards, get_board, create_board, add_stickies, add_diagram, update_board y trash_board.

Scope boards:read

curl -X POST "https://zerosoft.ai/api/v1/boards/mcp" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_stickies",
    "arguments": {
      "board_id": "b_1",
      "stickies": [
        {
          "text": "Ship the beta",
          "color": "green"
        }
      ]
    }
  }
}'

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_stickies",
    "arguments": {
      "board_id": "b_1",
      "stickies": [
        {
          "text": "Ship the beta",
          "color": "green"
        }
      ]
    }
  }
}

Respuesta · 200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"version\":13,\"added\":[...]}"
      }
    ],
    "isError": false
  }
}

Design

Leé los diseños que ve la persona de la key: nombres, tamaños, páginas y, con id, el JSON completo de las páginas.

Listar o leer diseños

GET/api/v1/design

Sin id, los diseños que ve la persona (los más recientes primero). Con id, ese diseño con sus páginas en JSON.

Scope design:read

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
viewstringNorecent (por defecto), mine, shared, starred o templates
idstringNoId de un diseño: devuelve ese diseño con sus páginas
curl -X GET "https://zerosoft.ai/api/v1/design" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "d_1",
      "name": "Summer sale",
      "width": 1080,
      "height": 1080,
      "pages": 1,
      "owner": "Ana",
      "access": "owner",
      "starred": false,
      "template": false,
      "updated_at": "2026-10-29T12:00:00.000Z",
      "url": "https://zerosoft.ai/en/app/design/d_1"
    }
  ]
}

Shop

El catálogo y los pedidos de tu tienda. Scopes shop:read y shop:write. Los datos de clientes solo están disponibles para keys de personas con la app Shop.

Listar productos

GET/api/v1/shop/products

Productos con estado, rango de precio, cantidad de variantes y stock. Un POST al mismo path crea un producto con el mismo cuerpo que usa la app.

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
limitnumberNoCantidad máxima de resultados.
curl -X GET "https://zerosoft.ai/api/v1/shop/products" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "prod_1",
      "handle": "blue-mug",
      "title": "Blue mug",
      "status": "active",
      "variants": 2,
      "stock": 14,
      "tracked": true,
      "minPriceCents": 1900,
      "maxPriceCents": 2100
    }
  ],
  "total": 1
}

Listar pedidos

GET/api/v1/shop/orders

Pedidos del más nuevo al más viejo, con estado (pending, paid, fulfilled, cancelled, refunded) y total en centavos.

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
limitnumberNoCantidad máxima de resultados.
curl -X GET "https://zerosoft.ai/api/v1/shop/orders" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "ord_1",
      "number": 1001,
      "status": "paid",
      "email": "ana@example.com",
      "name": "Ana Pérez",
      "totalCents": 4100,
      "currency": "USD",
      "paymentMethod": "stripe",
      "items": 2,
      "createdAt": "2026-10-29 15:00:00"
    }
  ],
  "total": 1
}

Pulse

Analítica de producto. Los endpoints de ingesta (/api/ingest/*) usan la key del proyecto, no una API key: la pública (zsp_…) en el cuerpo desde el navegador, o la key secreta del proyecto como Bearer zss_… desde un servidor. Las consultas aceptan una sesión iniciada o una API key con analytics:read.

Capturar eventos

POST/api/ingest/e

Un evento o un lote de hasta 200, 512 KB por pedido. Con la key secreta como Bearer no se chequea el origen. Los eventos con un uuid repetido se ignoran. Tiene tope por proyecto.

NombreTipoRequeridoDescripción
api_keystringNoKey pública del proyecto (zsp_…). También se acepta como token.
batcharraySíEventos: event, distinct_id, properties, timestamp y un uuid opcional. Un solo evento puede ir en el primer nivel.
sent_atstringNoCuándo mandó el lote el cliente; sirve para corregir su reloj.
curl -X POST "https://zerosoft.ai/api/ingest/e" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "zsp_…",
  "batch": [
    {
      "event": "signed_up",
      "distinct_id": "user_42",
      "properties": {
        "plan": "team"
      },
      "timestamp": "2026-10-29T12:00:00.000Z"
    }
  ]
}'

Request

{
  "api_key": "zsp_…",
  "batch": [
    {
      "event": "signed_up",
      "distinct_id": "user_42",
      "properties": {
        "plan": "team"
      },
      "timestamp": "2026-10-29T12:00:00.000Z"
    }
  ]
}

Respuesta · 200

{
  "status": 1,
  "stored": 1,
  "dropped": 0
}

Feature flags de una persona

POST/api/ingest/decide

Valores de los flags activos para un distinct_id (true, false o la clave de la variante) y los ajustes del snippet. person_properties se suma a lo que la persona ya tiene.

NombreTipoRequeridoDescripción
api_keystringSíKey pública del proyecto (zsp_…). También se acepta como token.
distinct_idstringSíEl id de la persona en tu producto.
person_propertiesobjectNoPropiedades extra de la persona para esta evaluación.
curl -X POST "https://zerosoft.ai/api/ingest/decide" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "zsp_…",
  "distinct_id": "user_42"
}'

Request

{
  "api_key": "zsp_…",
  "distinct_id": "user_42"
}

Respuesta · 200

{
  "featureFlags": {
    "new-checkout": true,
    "pricing-test": "variant-b"
  },
  "config": {
    "autocapture": true,
    "respectDnt": true
  }
}

Borrar una persona

POST/api/ingest/delete

Borra a la persona de un distinct_id con todos sus eventos y sesiones. Pide la key secreta del proyecto como Bearer zss_….

NombreTipoRequeridoDescripción
distinct_idstringSíEl id de la persona en tu producto.
curl -X POST "https://zerosoft.ai/api/ingest/delete" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "distinct_id": "user_42"
}'

Request

{
  "distinct_id": "user_42"
}

Respuesta · 200

{
  "deleted": true,
  "events": 128
}

Correr una consulta

POST/api/analytics/query

kind es trends, funnel, retention, paths, sql o web. SQL es de solo lectura sobre las tablas del proyecto events, persons, person_distinct_ids y sessions, hasta 1.000 filas.

Scope analytics:read

NombreTipoRequeridoDescripción
projectIdstringSíId del proyecto (ap_…).
queryobjectSíLa definición de la consulta, la misma que guarda la app en un insight.
curl -X POST "https://zerosoft.ai/api/analytics/query" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "projectId": "ap_…",
  "query": {
    "kind": "trends",
    "series": [
      {
        "event": "$pageview",
        "math": "unique"
      }
    ],
    "interval": "day",
    "dateRange": {
      "from": "-7d"
    }
  }
}'

Request

{
  "projectId": "ap_…",
  "query": {
    "kind": "trends",
    "series": [
      {
        "event": "$pageview",
        "math": "unique"
      }
    ],
    "interval": "day",
    "dateRange": {
      "from": "-7d"
    }
  }
}

Respuesta · 200

{
  "result": {
    "kind": "trends",
    "buckets": [
      "2026-10-23",
      "2026-10-24"
    ],
    "series": [
      {
        "label": "$pageview (unique users)",
        "breakdownValue": null,
        "data": [
          120,
          134
        ],
        "total": 231
      }
    ],
    "usedRollup": true
  }
}

Listar eventos

GET/api/analytics/events

Últimos eventos de un proyecto, los más nuevos primero. Pasá after con el último id que viste para traer solo los nuevos.

Scope analytics:read

NombreTipoRequeridoDescripción
projectstringSíId del proyecto (ap_…).
eventstringNoSolo este nombre de evento.
afternumberNoSolo eventos con un id mayor.
limitnumberNoCantidad máxima de resultados.
curl -X GET "https://zerosoft.ai/api/analytics/events" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "events": [
    {
      "id": 981,
      "event": "$pageview",
      "distinctId": "user_42",
      "ts": 1761739200000,
      "url": "https://example.com/pricing",
      "pathname": "/pricing",
      "browser": "Chrome",
      "os": "macOS",
      "device": "desktop",
      "country": "AR",
      "properties": {}
    }
  ]
}

Listar personas

GET/api/analytics/persons

Personas de un proyecto con sus propiedades y distinct ids, las vistas más recientemente primero.

Scope analytics:read

NombreTipoRequeridoDescripción
projectstringSíId del proyecto (ap_…).
qstringNoQuery de búsqueda.
cohortstringNoSolo personas de este id de cohorte.
curl -X GET "https://zerosoft.ai/api/analytics/persons" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "persons": [
    {
      "id": "p_3f…",
      "distinctIds": [
        "user_42"
      ],
      "properties": {
        "email": "ana@example.com"
      },
      "isIdentified": true,
      "createdAt": 1761000000000,
      "lastSeen": 1761739200000
    }
  ],
  "hasMore": false
}

Social

Publicaciones en redes sociales. La key actúa como la persona que la creó: ve y publica en las cuentas de esa persona, y quien necesita aprobación manda las publicaciones a aprobar. Scopes social:read y social:write.

Listar publicaciones

GET/api/v1/social/posts

Las publicaciones que ve la key, de la más nueva a la más vieja, con el estado de cada cuenta y el link a lo publicado.

NombreTipoRequeridoDescripción
statusstringNodraft, pending_approval, scheduled, published, partial o failed.
fromstringNoDesde esta fecha (ISO 8601).
tostringNoHasta esta fecha (ISO 8601).
curl -X GET "https://zerosoft.ai/api/v1/social/posts" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "sp_1",
      "text": "Launch day #launch",
      "status": "published",
      "scheduled_at": "2026-11-03T13:00:00.000Z",
      "published_at": "2026-11-03T13:00:12.000Z",
      "targets": [
        {
          "account_id": "sa_1",
          "network": "linkedin",
          "status": "published",
          "url": "https://www.linkedin.com/feed/update/urn:li:share:1",
          "error": null
        }
      ],
      "created_at": "2026-11-01T10:00:00.000Z"
    }
  ]
}

Crear una publicación

POST/api/v1/social/posts

Guarda un borrador, la programa, la suma a la cola o la publica ya. Cada red chequea largo y archivos antes; los errores vuelven por cuenta.

NombreTipoRequeridoDescripción
textstringSíTexto de la publicación.
accountIdsstring[]SíIds de las cuentas conectadas donde publicar.
overridesobjectNoTexto propio por cuenta: { accountId: texto }.
actionstringNodraft, schedule, queue o now. Por defecto draft.
scheduledAtstringNoFecha y hora de publicación (ISO 8601), con action schedule.
curl -X POST "https://zerosoft.ai/api/v1/social/posts" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "text": "Launch day #launch",
  "accountIds": [
    "sa_1"
  ],
  "action": "schedule",
  "scheduledAt": "2026-11-03T13:00:00.000Z"
}'

Request

{
  "text": "Launch day #launch",
  "accountIds": [
    "sa_1"
  ],
  "action": "schedule",
  "scheduledAt": "2026-11-03T13:00:00.000Z"
}

Respuesta · 201

{
  "data": {
    "id": "sp_2",
    "text": "Launch day #launch",
    "status": "scheduled",
    "scheduled_at": "2026-11-03T13:00:00.000Z",
    "published_at": null,
    "targets": [
      {
        "account_id": "sa_1",
        "network": "linkedin",
        "status": "pending",
        "url": null,
        "error": null
      }
    ],
    "created_at": "2026-11-01T10:00:00.000Z"
  }
}

Books

Facturas de Books. La key actúa como la persona que la creó, con su rol de Books. Los importes son enteros en la unidad mínima de la moneda (centavos). Scopes books:read y books:write.

Listar facturas

GET/api/v1/books/invoices

Facturas, las más nuevas primero, con estado, número, cliente, total y saldo.

NombreTipoRequeridoDescripción
statusstringNodraft, sent, partial, paid, overdue, void, u open (todo lo que tiene saldo).
qstringNoQuery de búsqueda.
limitnumberNoCantidad máxima de resultados.
curl -X GET "https://zerosoft.ai/api/v1/books/invoices" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "inv_1",
      "docType": "invoice",
      "status": "sent",
      "numberLabel": "B 00001-00000012",
      "reference": "PO 778",
      "contactId": "con_1",
      "contactName": "Acme SA",
      "issueDate": "2026-11-01",
      "dueDate": "2026-12-01",
      "currency": "ARS",
      "total": 12100000,
      "amountDue": 12100000,
      "sentAt": "2026-11-01 12:00:00",
      "updatedAt": "2026-11-01 12:00:00"
    }
  ],
  "total": 1
}

Crear una factura borrador

POST/api/v1/books/invoices

Guarda un borrador con el mismo cuerpo que usa la app. Alguien la aprueba en la app, que le da el número y genera el asiento.

NombreTipoRequeridoDescripción
contactIdstringNoId del contacto de Books (el cliente).
linesobject[]SíLíneas: description, quantity, unitPrice (unidades mínimas enteras, o un texto decimal con punto como separador decimal, por ejemplo "1500.50", sea cual sea la moneda), discountBps, taxRateId, itemId.
currencystringNoCódigo de moneda ISO; si falta, la moneda base.
fxRatestringNoTipo de cambio manual (moneda base por 1 unidad) cuando la moneda no es la base.
referencestringNoTu referencia (orden de compra, proyecto).
curl -X POST "https://zerosoft.ai/api/v1/books/invoices" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_1",
  "reference": "PO 778",
  "lines": [
    {
      "description": "Consulting",
      "quantity": 10,
      "unitPrice": "1000.00",
      "taxRateId": "tax_iva21"
    }
  ]
}'

Request

{
  "contactId": "con_1",
  "reference": "PO 778",
  "lines": [
    {
      "description": "Consulting",
      "quantity": 10,
      "unitPrice": "1000.00",
      "taxRateId": "tax_iva21"
    }
  ]
}

Respuesta · 201

{
  "data": {
    "id": "inv_2",
    "docType": "invoice",
    "status": "draft",
    "numberLabel": "",
    "total": 1210000,
    "currency": "ARS",
    "lines": [
      {
        "description": "Consulting",
        "quantity": 10,
        "unitPrice": 100000,
        "taxBps": 2100,
        "net": 1000000,
        "tax": 210000,
        "total": 1210000
      }
    ]
  }
}

Forms

Formularios y sus respuestas. La key actúa como la persona que la creó y solo ve los formularios que esa persona puede abrir. Scope forms:read.

Listar formularios

GET/api/v1/forms/forms

Formularios del más nuevo al más viejo, con estado, cantidad de respuestas y parciales, última respuesta y quién puede abrirlos.

Scope forms:read

NombreTipoRequeridoDescripción
qstringNoQuery de búsqueda.
statusstringNoFiltrá los formularios por estado, por ejemplo published.
curl -X GET "https://zerosoft.ai/api/v1/forms/forms" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "fm_1",
      "name": "NPS survey",
      "slug": "nps-survey-a1b2c3",
      "status": "published",
      "responseCount": 42,
      "partialCount": 3,
      "lastResponseAt": "2026-11-03T13:00:00.000Z",
      "updatedAt": "2026-11-03T13:00:00.000Z",
      "sharing": "workspace",
      "open": true
    }
  ]
}

Listar respuestas

GET/api/v1/forms/responses

Respuestas de un formulario, de la más nueva a la más vieja. Las respuestas se indexan por id de pregunta. Las de archivo devuelven una referencia, no el archivo.

Scope forms:read

NombreTipoRequeridoDescripción
formstringSíId del formulario.
statusstringNocompleted (por defecto) o partial.
fromstringNoSolo respuestas enviadas desde esta fecha (YYYY-MM-DD).
tostringNoSolo respuestas enviadas hasta esta fecha (YYYY-MM-DD).
pageintegerNoNúmero de página.
limitnumberNoCantidad máxima de resultados.
curl -X GET "https://zerosoft.ai/api/v1/forms/responses" \
  -H "Authorization: Bearer zs_live_9f3k..."

Respuesta · 200

{
  "data": [
    {
      "id": "rs_1",
      "status": "completed",
      "answers": {
        "q_1": 9,
        "q_2": "Fast and clear"
      },
      "hidden": {
        "source": "newsletter"
      },
      "vars": {
        "score": 0
      },
      "endingId": "end_1",
      "lang": "en",
      "contactId": "con_1",
      "consent": true,
      "createdAt": "2026-11-03T12:58:00.000Z",
      "submittedAt": "2026-11-03T13:00:00.000Z"
    }
  ],
  "total": 42
}

Webhooks

Agregá endpoints en Dashboard → Configuración → Webhooks. Eventos: booking.created, booking.rescheduled, booking.cancelled, booking.no_show, booking.requested, link.created, link.clicked, link.updated, link.deleted, contact.created, contact.updated, deal.created, deal.updated, deal.stage_changed, deal.won, deal.lost, robot.run.finished, robot.run.failed, robot.output.changed, chat.message.created, chat.conversation.created, chat.conversation.assigned, chat.conversation.tagged, chat.conversation.resolved, chat.csat.submitted. Los eventos de links se pueden limitar a algunos links, tags o dominios. link.updated trae el link y la lista de campos que cambiaron; link.deleted, el link como estaba. Cada request lleva Zerosoft-Signature: t=TIMESTAMP,v1=HEX, donde v1 = HMAC-SHA256(secret, "TIMESTAMP.BODY_CRUDO"). Rechazá timestamps viejos. Las entregas fallidas se reintentan con backoff durante ~15 horas.

Payload del evento

POSThttps://your-app.example/webhooks/zerosoft

Lo que recibe tu endpoint. Respondé 2xx en menos de 8 segundos.

curl -X POST "https://your-app.example/webhooks/zerosoft" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "id": "evt_1",
  "type": "booking.created",
  "createdAt": "2026-11-01T18:00:00.000Z",
  "data": {
    "id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
    "status": "confirmed",
    "startsAt": "2026-11-03T13:00:00.000Z",
    "endsAt": "2026-11-03T13:30:00.000Z",
    "timezone": "America/Argentina/Buenos_Aires",
    "invitee": {
      "name": "Ana",
      "email": "ana@example.com"
    },
    "answers": {},
    "hostUserId": "u_123",
    "meetingUrl": "https://meet.google.com/abc-defg-hij",
    "rescheduledFrom": null,
    "cancelReason": null,
    "eventType": {
      "id": "et_42",
      "slug": "intro",
      "title": "Intro call"
    }
  }
}'

Request

{
  "id": "evt_1",
  "type": "booking.created",
  "createdAt": "2026-11-01T18:00:00.000Z",
  "data": {
    "id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
    "status": "confirmed",
    "startsAt": "2026-11-03T13:00:00.000Z",
    "endsAt": "2026-11-03T13:30:00.000Z",
    "timezone": "America/Argentina/Buenos_Aires",
    "invitee": {
      "name": "Ana",
      "email": "ana@example.com"
    },
    "answers": {},
    "hostUserId": "u_123",
    "meetingUrl": "https://meet.google.com/abc-defg-hij",
    "rescheduledFrom": null,
    "cancelReason": null,
    "eventType": {
      "id": "et_42",
      "slug": "intro",
      "title": "Intro call"
    }
  }
}

Payload de los eventos de Chat

POSThttps://your-app.example/webhooks/zerosoft

Los eventos de Chat traen la conversación. chat.message.created suma el mensaje (del visitante, del equipo o del bot; las notas internas no se mandan) y chat.conversation.assigned suma previousAssignedTo.

curl -X POST "https://your-app.example/webhooks/zerosoft" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "id": "evt_2",
  "type": "chat.message.created",
  "createdAt": "2026-11-01T18:02:00.000Z",
  "data": {
    "conversation": {
      "id": "{conversation_id}",
      "widgetId": "{widget_id}",
      "status": "open",
      "priority": "medium",
      "subject": null,
      "assignedTo": "{user_id}",
      "visitor": {
        "id": "{visitor_id}",
        "name": "Ana",
        "email": "ana@example.com"
      },
      "firstResponseAt": "2026-11-01T18:02:00.000Z",
      "resolvedAt": null,
      "createdAt": "2026-11-01T18:00:00.000Z",
      "updatedAt": "2026-11-01T18:02:00.000Z"
    },
    "message": {
      "id": "{message_id}",
      "conversationId": "{conversation_id}",
      "senderType": "user",
      "userId": "{user_id}",
      "body": "Hi Ana, the order ships tomorrow.",
      "isNote": false,
      "attachments": [],
      "createdAt": "2026-11-01T18:02:00.000Z"
    }
  }
}'

Request

{
  "id": "evt_2",
  "type": "chat.message.created",
  "createdAt": "2026-11-01T18:02:00.000Z",
  "data": {
    "conversation": {
      "id": "{conversation_id}",
      "widgetId": "{widget_id}",
      "status": "open",
      "priority": "medium",
      "subject": null,
      "assignedTo": "{user_id}",
      "visitor": {
        "id": "{visitor_id}",
        "name": "Ana",
        "email": "ana@example.com"
      },
      "firstResponseAt": "2026-11-01T18:02:00.000Z",
      "resolvedAt": null,
      "createdAt": "2026-11-01T18:00:00.000Z",
      "updatedAt": "2026-11-01T18:02:00.000Z"
    },
    "message": {
      "id": "{message_id}",
      "conversationId": "{conversation_id}",
      "senderType": "user",
      "userId": "{user_id}",
      "body": "Hi Ana, the order ships tomorrow.",
      "isNote": false,
      "attachments": [],
      "createdAt": "2026-11-01T18:02:00.000Z"
    }
  }
}

Payload de eventos de Track

POSThttps://your-app.example/webhooks/zerosoft

Los eventos issue.* traen el issue y su equipo (project en el payload); issue.status_changed suma from y to, comment.created el comentario y project.* el equipo.

curl -X POST "https://your-app.example/webhooks/zerosoft" \
  -H "Authorization: Bearer zs_live_9f3k..."
  -H "Content-Type: application/json" \
  -d '{
  "id": "evt_3",
  "type": "issue.status_changed",
  "createdAt": "2026-10-25T15:10:00.000Z",
  "data": {
    "issue": {
      "id": "{issue_id}",
      "identifier": "WEB-12",
      "title": "Checkout button does nothing on Safari",
      "priority": "high",
      "status": "Done",
      "assigneeId": "{user_id}"
    },
    "project": {
      "id": "{project_id}",
      "name": "Web"
    },
    "changes": [
      "statusId"
    ],
    "from": "In Progress",
    "to": "Done"
  }
}'

Request

{
  "id": "evt_3",
  "type": "issue.status_changed",
  "createdAt": "2026-10-25T15:10:00.000Z",
  "data": {
    "issue": {
      "id": "{issue_id}",
      "identifier": "WEB-12",
      "title": "Checkout button does nothing on Safari",
      "priority": "high",
      "status": "Done",
      "assigneeId": "{user_id}"
    },
    "project": {
      "id": "{project_id}",
      "name": "Web"
    },
    "changes": [
      "statusId"
    ],
    "from": "In Progress",
    "to": "Done"
  }
}