Introducción

Bienvenido a la API de Syncro. Integra tu CRM con sitios web, formularios, automatizaciones (n8n, Make, Zapier), ERPs y tus propios sistemas — crea y actualiza leads, mueve negocios en el embudo, gestiona tareas, envía mensajes de WhatsApp y recibe eventos en tiempo real mediante webhooks.

Base URLhttps://app.syncro.chat/api/v1AuthX-API-Key: crm_SUA_CHAVE_AQUI

Lo que puedes hacer

Leads y embudo

Crea, actualiza, busca, mueve de etapa, marca como ganado o perdido, aplica tags e inscribe en secuencias.

Tareas

Crea, lista, actualiza y completa tareas, con o sin lead vinculado.

Envía texto, imágenes y plantillas oficiales (HSM) y lista números y plantillas aprobadas.

Catálogo

Lee pipelines y etapas, campos personalizados y secuencias de nutrición.

Webhooks

Suscríbete a eventos (lead creado, etapa cambiada, venta, tarea, etc.) y recíbelos en tu URL, con firma HMAC.

Flujo básico de integración

Genera una API Key en el panel de Syncro, en Configuración → API Keys (ver Autenticación).
Haz llamadas a la API enviando el header X-API-Key con tu clave.
Descubre los IDs que vas a usar: lista pipelines/etapas (GET /pipelines) y campos personalizados (GET /custom-fields).
Crea o actualiza leads (POST /leads o POST /leads/upsert), crea tareas, envía WhatsApp, etc.
(Opcional) Suscríbete a webhooks (POST /webhooks) para recibir eventos en tiempo real en tu sistema.

Primera solicitud

Tras generar tu clave, prueba la conexión obteniendo los datos de tu cuenta:

curl https://app.syncro.chat/api/v1/account \
  -H "X-API-Key: crm_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json"

Respuesta esperada:

{
  "success": true,
  "account": { "id": 1, "name": "Minha Empresa", "plan": "scale" }
}

Siguiente paso: Autenticación.