es
Integraciones›Conecte Zapier, Make, n8n y Pipedream

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

TipoPasoAPI de Crisphive
AcciónReservar y confirmar un trabajoPOST /v1/job-requests/book-and-confirm
BúsquedaEncontrar un cliente por teléfonoGET /v1/customers?phone=+16135550142
AcciónCrear un clientePOST /v1/customers
AcciónObtener un trabajoGET /v1/job-requests/{id}
DisparadorNuevo 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_at es la hora de reloj local del negocio, sin desfase de zona horaria.
  • Envíe customer_id, o un objeto customer: un cliente que ya existe (mismo teléfono o correo electrónico) se reconoce, nunca se duplica.
  • job_type_id es 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 4xx normal 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 200 con confirmed: false y un refusal (el mismo error_code y data que devolvería el paso de confirmación); el trabajo espera en la cola del coordinador.
Envíe siempre un 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.

1
Suscribirse

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.

2
Responder al ping

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.

3
Verificar cada entrega

Compruebe el encabezado Crisphive-Signature con el secreto antes de confiar en el payload — vea Webhooks para el algoritmo exacto.

4
Cancelar la suscripción

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.* requiere customers_view, technician.* requiere team_view, job_request.* requiere job_view. Cualquier otro se rechaza con 403 WEBHOOK_EVENT_NOT_PERMITTED.
  • Reservar requiere job_create y job_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.

Pruebe primero con una clave chsk_test_: los trabajos de sandbox nunca llegan a un cliente real, y los disparadores de sandbox solo reciben eventos de sandbox.