Conectar Boris con Zapier

Zapier no es una API a la que Boris le mande objetos: es un oyente. Un Zap empieza con una URL, y lo que Boris publique ahí se convierte en el disparador. Con eso, cualquier evento de Boris puede terminar en un canal de Slack, una fila de Google Sheets, un CRM o un email — sin escribir código.

Conectar un Zap en dos minutos

1. En Zapier, creá un Zap nuevo y elegí el disparador «Webhooks by Zapier» → «Catch Hook».
2. Zapier te da una URL del estilo https://hooks.zapier.com/hooks/catch/123456/abcdef/. Copiala.
3. En Boris, entrá a Integraciones → Zapier, elegí el evento, pegá la URL y dale a conectar.
4. Pulsá Enviar ejemplo: Boris manda un evento de muestra para que Zapier aprenda los campos y puedas mapearlos.
5. Terminá el Zap con la acción que quieras y activalo.

No hace falta ninguna app publicada de Zapier ni programar nada.

Qué eventos podés escuchar

• Reservas: creada, modificada, cancelada, por empezar, terminada, check-in, check-out, check-in no realizado.
• Facturación: factura emitida, factura vencida, pago recibido.
• Operaciones: limpieza pendiente y terminada, incidencia reportada y resuelta, stock bajo, conflicto de recurso.

Son los mismos eventos que ya usan las notificaciones de Boris, así que no hay un segundo sistema que mantener.

Qué recibe el Zap

Un JSON con el evento arriba y los datos anidados, para que el mapeador de Zapier sea usable:

{
  "event": "booking.created",
  "event_label": "Reserva creada",
  "tenant_id": 14,
  "sent_at": "2026-08-13T09:00:00+00:00",
  "source": "boris",
  "data": { "booking_id": 4242, "customer_name": "...", ... }
}

Ideas que funcionan bien en un coworking

• Reserva creada → mensaje en el canal de Slack de recepción.
• Factura vencida → tarea en tu gestor de tareas, o email al socio.
• Check-in hecho → fila en una hoja de cálculo para el conteo de aforo.
• Incidencia reportada → ticket en tu herramienta de mantenimiento.
• Stock bajo → email al proveedor de café.

Si un Zap deja de funcionar

Cuando apagás un Zap, Zapier borra su Catch Hook y responde 410 Gone. Boris lo detecta y desactiva la suscripción sola, en vez de reintentar para siempre. La verás en gris en la lista, con el motivo.

La tabla te muestra cuántos eventos se enviaron, cuántos fallaron y el último error, para diagnosticar sin salir de Boris.

Para quien quiera publicar una app de Zapier

Boris además habla el protocolo REST Hook, que es el que usa una app de Zapier publicada para suscribirse sola cuando el usuario activa el Zap:

• POST /api/v1/zapier/subscribe — suscribe una URL a un evento.
• DELETE /api/v1/zapier/unsubscribe — la quita.
• GET /api/v1/zapier/sample?event=booking.created — payload de ejemplo para el mapeo de campos.
• GET /api/v1/zapier/events — lista de eventos disponibles.

Se autentica con una API key de Sistema → API keys, enviada en las cabeceras X-Boris-Key y X-Boris-Secret. Construir y publicar la app en Zapier es un trabajo aparte; Boris ya responde lo que esa app necesita.

Límites conocidos

• Zapier solo escucha: hoy no hay acciones que dejen a un Zap crear o modificar cosas en Boris. Para eso está la API REST.
• Las URLs tienen que ser https://.
• Un evento se entrega una vez, sin reintentos: si tu Zap estaba caído, ese evento se perdió. Para flujos críticos usá la integración de Webhooks, que sí reintenta.