Conectar BI (Power BI/Tableau) y Zapier/Make

Genera tu propia API key y conecta herramientas de BI y de automatización a tus datos del CRM, sin ninguna cuenta externa nuestra.

Puedes conectar herramientas de BI (Power BI, Tableau, Looker) y de automatización (Zapier, Make, n8n) directamente a tu base del CRM. No se necesita ninguna cuenta externa nuestra: generas una API key dentro del propio CRM y la conectas a la herramienta. Todo es de solo lectura y está restringido a los datos de tu tenant.

Requisitos previos

• Una cuenta en la herramienta de BI (Power BI, Tableau, Looker Studio) o de automatización (Zapier, Make, n8n) que pueda consumir una API REST/JSON con un encabezado de autenticación.
• En Sellio, ser administrador para generar la API key en Configuración → API.

1) Genera una API key

1. Abre Configuración → API.
2. Crea una nueva API key y copia el valor (comienza con sk_ y solo aparece una vez; trátalo como una contraseña).
3. En las herramientas, envía esa clave en el encabezado: Authorization: Bearer sk_...

2) Endpoints de datos (las "tablas")

• GET /api/v1/objects: lista los objetos disponibles (las tablas que el BI puede leer).
• GET /api/v1/data/{objeto}: los registros del objeto ya aplanados en filas, con columnas estables: id, created_at, updated_at, owner_id y una columna por campo (el api_name del campo).

Paginación: usa ?page=1&pageSize=100 (o ?limit= y ?offset=). El pageSize máximo es 200. La respuesta trae object, columns (nombre y tipo de cada columna), page, pageSize, total y rows.

3) Power BI / Tableau / Looker

1. En Power BI: Obtener datos → Web; en Tableau: Conector Web/JSON; en Looker Studio: conector JSON/URL.
2. Apunta a la URL de datos, por ejemplo https://TU-CRM/api/v1/data/opportunity
3. Agrega el encabezado Authorization con el valor Bearer sk_... (tu API key).
4. Las columnas vienen estables y tipadas: mapea una vez y el reporte sigue funcionando a medida que entran nuevos registros.

4) Zapier / Make / n8n

• Disparador por polling ("New/Updated record"): consulta GET /api/v1/data/{objeto}?updated_since=<ISO> (o created_since=<ISO>) para recibir solo lo que cambió o nació desde la última verificación. Los más recientes vienen primero.
• Disparador instantáneo: en Configuración → Webhooks, crea un webhook de salida y apunta la URL al "Catch Hook" de Zapier (o al "Custom Webhook" de Make/n8n). Por cada registro creado/actualizado, el CRM envía el evento firmado (HMAC) al instante.

En Configuración → Integraciones, la tarjeta "BI y Automatización externa" reúne los enlaces de los endpoints y el atajo para generar la API key.

Cómo probar

1. Rápido: abre GET https://TU-CRM/api/v1/objects con el encabezado Authorization: Bearer sk_... (en un navegador con extensión, en Postman o con curl) y revisa la lista de objetos.
2. Lee datos: llama a GET /api/v1/data/opportunity?pageSize=5 y confirma que vienen filas con las columnas id, created_at, updated_at, owner_id y los campos.
3. En BI: arma la conexión apuntando a la URL de datos y verifica que las columnas aparezcan tipadas; en Zapier/Make, dispara el disparador de prueba y observa que el registro llega.

Solución de problemas

• 401 Unauthorized: la API key está ausente, es incorrecta o no se envió como "Authorization: Bearer sk_...". Genera una nueva en Configuración → API (el valor solo aparece una vez) y reconfigura la herramienta.
• 404 en el endpoint: verifica la URL: los objetos están en /api/v1/objects y los datos en /api/v1/data/{api_name}. Usa el api_name exacto del objeto (no la etiqueta traducida).
• Vienen pocas filas: hay paginación. Usa ?page=1&pageSize=200 (máximo 200) e itera las páginas; para incremental, usa ?updated_since=<ISO>.
• El webhook instantáneo no se dispara: confirma que el webhook de salida en Configuración → Webhooks apunta al "Catch Hook" (Zapier) / "Custom Webhook" (Make/n8n) y está activo. El CRM firma el envío (HMAC); valida el secreto si la herramienta lo exige.
• Solo leo mis datos: correcto, cada API key está aislada al tenant dueño; nunca ve datos de otra empresa.

Abrir este artículo dentro del sistema →