Integraciones
Conecta Chekku a tu stack con API REST, webhooks, Workflows y conectores.
Audiencia: Admin · Desarrollador
Chekku expone datos de campo a sistemas externos mediante API REST, webhooks, conectores opcionales y Workflows nativos. Elige la vía según quién mantiene la integración y qué tan en tiempo real debe ser la sincronización.
API REST
La API REST de Chekku permite a clientes autenticados:
- Leer y escribir lugares, usuarios, visitas, envíos de formulario y tareas (alcances varían por endpoint y plan).
- Consultar listas paginadas con filtros (fecha, equipo, lugar).
- Adjuntar archivos donde el endpoint soporte carga multipart.
La autenticación suele usar claves API u tokens OAuth emitidos desde ajustes del workspace. Rota claves con la misma cadencia que otros secretos de producción.
Referencia completa: docs de la API de Chekku — documentación estilo OpenAPI con esquemas y ejemplos. Empieza con lecturas sobre una visita de prueba antes de escribir datos.
Webhooks
Los webhooks envían payloads HTTP POST a tu URL cuando ocurren eventos—visita completada, formulario enviado, tarea actualizada, etc.
| Ideal para | Menos ideal para |
|---|---|
| Ingesta en ERP/CRM en tiempo real | "Crear tarea al enviar formulario X" solo dentro de Chekku |
| Staging en data warehouse | Correo ad hoc sin servidor |
| Pipelines de validación custom | Mantenimiento por admins no técnicos |
Debes operar un endpoint HTTPS accesible, verificar firmas (cuando existan) y manejar reintentos de forma idempotente.
Workflows vs. webhooks al enviar formulario
Cuando un usuario móvil envía un formulario, compiten dos patrones:
Prefiere Workflows cuando
- El siguiente paso permanece dentro de Chekku (tarea, registro de workflow, notificación).
- Admins deben cambiar enrutamiento sin desplegar código.
- Quieres filtros sobre respuestas y tipo de visita en la UI.
Disparador: form_submitted. Ver Automatizaciones al enviar formulario.
Prefiere webhooks cuando
- Un sistema externo debe recibir cada payload al instante (SAP, Salesforce, middleware propio).
- Ya operas infraestructura de integración con monitoreo y colas de fallos.
Evita duplicar ambos para el mismo evento salvo que necesites entrega dual explícita—de lo contrario, depurar qué sistema creó una tarea se vuelve difícil.
Fuentes de datos y catálogos externos
Las Fuentes de datos sincronizan filas desde Google Drive, Sheets, cargas Excel, SQL, SAP y otros conectores (disponibilidad variable). Los formularios consumen catálogos vía campos Lista—no mediante llamadas API ad hoc en cada toque.
Oficina mantiene catálogos; móvil lee copias sincronizadas. Ver Fuentes de datos.
Conectores e integraciones a medida
Además de API/webhooks genéricos, Chekku y partners pueden ofrecer conectores prearmados para ERP o BI concretos. Los logos en marketing indican dirección; confirma disponibilidad y plan con tu cuenta antes de planificar proyecto.
Checklist de seguridad
- Guarda claves API en gestor de secretos, no en apps móviles ni repos públicos.
- Restringe endpoints webhook con TLS 1.2+, listas IP si aplica y verificación de payload.
- Registra IDs de correlación de payloads Chekku al abrir tickets de soporte.
- Minimiza PII exportada a terceros a lo que el caso de uso requiera.
Consejos
- Prototipa con llamadas API solo lectura, luego habilita escrituras.
- Mapea claves de campo antes de modelos BI (Claves de campo y API).
- Documenta qué sistema es maestro de lugares vs. Chekku.
- Para necesidades solo de reporte, export Excel puede bastar—API no es obligatoria.