Conecte Zapier, Make, n8n y Pipedream
Reserve trabajos y reaccione a eventos desde las herramientas de automatización que su equipo ya usa — sin código, o con muy poco.
Las aplicaciones oficiales de Crisphive para Zapier, Make, n8n y Pipedream están en camino. Todas usan la misma API pública descrita aquí, así que todo lo que hacen ya puede hacerlo hoy con los pasos genéricos de HTTP y webhook de cada plataforma.
Qué hacen las aplicaciones
| Tipo | Paso | API de Crisphive |
|---|---|---|
| Acción | Reservar y confirmar un trabajo | POST /v1/job-requests/book-and-confirm |
| Búsqueda | Encontrar un cliente por teléfono | GET /v1/customers?phone=+16135550142 |
| Acción | Crear un cliente | POST /v1/customers |
| Acción | Obtener un trabajo | GET /v1/job-requests/{id} |
| Disparador | Nuevo evento (trabajo completado, cliente creado, …) | POST /v1/webhooks al activarlo, DELETE /v1/webhooks/{id} al desactivarlo |
Reservar y confirmar en una sola llamada
Una automatización normalmente no puede ejecutar el flujo completo crear → cotizar → elegir un horario → confirmar. book-and-confirm lo hace todo en una sola solicitud: crea el trabajo, lo dimensiona a partir de la duración predeterminada del tipo de trabajo (o del job_duration_minutes que envíe) y lo confirma en scheduled_at, con Crisphive eligiendo al técnico.
curl -X POST "https://api.crisphive.com/v1/job-requests/book-and-confirm" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "Idempotency-Key: form-submission-4815" \ -H "Content-Type: application/json" \ -d '{"customer":{"full_name":"Lamar Bakery","phone":"+16135550142"},"address":{"line":"120 Bank St","city":"Ottawa","state":"ON","postal_code":"K1P 5N1","country":"CA"},"scheduled_at":"2026-10-06T10:00:00"}'
scheduled_ates la hora de reloj local del negocio, sin desfase de zona horaria.- Envíe
customer_id, o un objetocustomer: un cliente que ya existe (mismo teléfono o correo electrónico) se reconoce, nunca se duplica. job_type_ides opcional. Sin él se usa el tipo de trabajo predeterminado del negocio (“General”); cada tipo de trabajo que la automatización pueda reservar debería tener una duración predeterminada.- Una entrada no válida se rechaza con un
4xxnormal y no se crea nada. - Una vez que el trabajo existe, nunca se descarta. Si ningún técnico puede tomarlo a esa hora, la llamada responde igualmente
200conconfirmed: falsey unrefusal(el mismoerror_codeydataque devolvería el paso de confirmación); el trabajo espera en la cola del coordinador.
Idempotency-Key derivado del registro que lo dispara (un id de envío de formulario, un id de fila). Reintentar con la misma clave reproduce la primera respuesta; una clave nueva reserva un segundo trabajo.Disparadores: suscríbase con un webhook
Un disparador es un webhook que la plataforma de automatización crea cuando usted lo activa y elimina cuando lo desactiva (un “REST hook”). La lista de eventos proviene de GET /v1/webhooks/event-types, de modo que los nuevos eventos de Crisphive aparecen sin actualizar la aplicación.
Llame a POST /v1/webhooks con la URL receptora de la plataforma, los event_types que desea y expires_in_days: 365 para que el disparador no se detenga tras los 30 días predeterminados. Guarde el secret de la respuesta — se muestra una sola vez.
Crisphive envía de inmediato un evento ping firmado. Responda 2xx y la suscripción queda activa. Nunca inicie el flujo de trabajo por un ping.
Compruebe el encabezado Crisphive-Signature con el secreto antes de confiar en el payload — vea Webhooks para el algoritmo exacto.
Llame a DELETE /v1/webhooks/{id} cuando se desactive el disparador. Esto libera el espacio — un negocio puede tener como máximo 25 endpoints activos por entorno.
Quién puede conectar qué
- Activar un disparador requiere acceso de Desarrollador (
developer_manage_api_keys). De forma predeterminada solo lo tiene el Propietario del negocio; un Propietario puede conceder el módulo Developer a otro grupo en la matriz de roles. - Un disparador solo puede suscribirse a eventos que la cuenta conectada puede leer:
customer.*requierecustomers_view,technician.*requiereteam_view,job_request.*requierejob_view. Cualquier otro se rechaza con403 WEBHOOK_EVENT_NOT_PERMITTED. - Reservar requiere
job_createyjob_manage. - El Propietario y los Administradores reciben un correo la primera vez que una aplicación o una clave de API se suscribe a eventos del negocio.
- Una suscripción se detiene por sí sola cuando se revoca la clave de API que la creó, cuando se desconecta la aplicación o cuando el miembro que conectó la aplicación se va o es suspendido.
Autenticación
n8n y Pipedream se conectan con una clave de API (chsk_test_… para probar con datos de sandbox, chsk_live_… para el trabajo real). Zapier y Make se conectan con OAuth: la persona que conecta inicia sesión en Crisphive y aprueba la aplicación, y la conexión solo puede hacer lo que esa persona tiene permitido hacer en el panel.
chsk_test_: los trabajos de sandbox nunca llegan a un cliente real, y los disparadores de sandbox solo reciben eventos de sandbox.