Which plans include webhooks?

Webhooks are included on the Growth plan and above, at no extra cost, alongside API access. A 30-day free trial started on Growth or Pro includes it, so you can build and test webhooks during the trial.

Which events can I subscribe to?

guest.created fires when a guest signs up on your WiFi for the first time, and guest.returned fires when a guest who has been before connects again. Accounts with Rewards on can add reward.issued, reward.redeemed, reward.redemption_voided and points.earned; accounts with Events on can add ticket.order.paid, ticket.checked_in and ticket.order.refunded; and reservation.attended fires when a booking or ticket holder turns up. Table bookings add booking.created, booking.amended, booking.cancelled, booking.attended and booking.no_show, and workflow.action fires when a Send to your webhooks step runs in one of your Workflows. You tick the events you want per endpoint, so an endpoint only receives what it asked for.

How do I know a request really came from CaptiFi?

Every request carries an X-CaptiFi-Signature header containing a timestamp and an HMAC SHA-256 of the timestamp and the raw request body, keyed with your endpoint signing secret. Verify it in constant time against the raw body, not re-encoded JSON, and reject anything more than five minutes old. Anyone can post to your URL, but only CaptiFi can produce a valid signature.

What happens if my server is down?

Failed deliveries retry automatically with backoff, and every attempt is recorded in the delivery log for 30 days with the response code and duration. An endpoint that keeps failing is switched off, so the log shows exactly why deliveries stopped.

Could I receive the same event twice?

Yes, a network hiccup can mean a retry lands after your server already accepted the first attempt. Treat repeats of the same delivery id as one event: record the ids you have processed and ignore ones you have already seen.

Who is responsible for the guest data once it reaches us?

Webhook payloads contain guest personal data, so once a copy is in your systems you are the controller of that copy and your own retention, security and deletion obligations apply. Deleting a guest in CaptiFi does not delete your copy.

Integración con desarrolladores

Webhooks + CaptiFi

Haz que las inscripciones de invitados se envíen a tus propios sistemas en cuanto ocurran, con cargas firmadas, intentos automáticos y un registro de entregas. Incluido en Growth y superiores.

Comienza la prueba gratuita Ver todas las integraciones

Resumen

¿Qué hace la integración con Webhooks?

Webhooks push events to your own systems the moment they happen: a guest signs up on your WiFi for the first time, or a returning guest connects again, and your booking system, CRM or automation tool knows a second later. Add up to five HTTPS endpoints; each request is signed with HMAC SHA-256, failed deliveries retry with backoff and every attempt is logged for 30 days. For teams with their own stack. Included on the Growth plan and above.

Los webhooks convierten CaptiFi en una fuente de eventos para el resto de tu stack. En lugar de preguntar a la API qué cambió, le das a CaptiFi una URL HTTPS y CaptiFi la publica en cuanto ocurre algo: un invitado se registra en tu WiFi por primera vez, o un invitado que ya lo ha estado antes se conecta de nuevo. Las recompensas, eventos y reservas añaden las suyas propias: una recompensa emitida o canjeada, puntos ganados, pedido de entrada pagado, facturado o reembolsado, un reservado o titular de entrada, y una reserva de mesa confirmada, modificada, cancelada, llegada o marcada como no presentada. Un paso de Enviar a tus webhooks en uno de tus flujos de trabajo también publica su propio evento. Tu sistema de reservas, CRM o herramienta de automatización lo saben un segundo después.

Suma hasta cinco endpoints, lo cual es útil para apuntar los mismos eventos a un sistema en vivo y uno de staging, y marca los eventos que cada endpoint debería recibir. Cada solicitud lleva una firma SHA256 de HMAC sobre el cuerpo en bruto, junto con el nombre del evento y un ID de entrega, para que puedas demostrar que una carga útil proviene de CaptiFi antes de confiar en ella y tratar una repetición del mismo id como un solo evento.

La entrega está diseñada para el mundo real. Un intento fallido se reintenta automáticamente con retroceso, cada intento se registra durante 30 días con el código de respuesta y cuánto tiempo ha tardado tu servidor, y un endpoint que sigue fallando se apaga en lugar de ser golpeado para siempre. Puedes lanzar un evento de prueba mientras construyes y rotar un secreto de firma cuando lo necesites. Las cargas útiles de Webhook contienen datos personales de invitados, así que CaptiFi solo los enviará por HTTPS, y una vez que una copia llega a tus sistemas se aplican tus propias obligaciones de retención y eliminación.

Lo que obtienes

Por qué conectar Webhooks con CaptiFi

Reacciona en cuanto llega un invitado

Un huésped inicia sesión y tu sistema se entera un segundo después, así que los viajes bienvenidos, los registros CRM y las alertas de operaciones se activan al llegar en lugar de en tu siguiente encuesta programada.

Cargas útiles firmadas puedes comprobarlas

Cada solicitud lleva una firma HMAC SHA-256 sobre el cuerpo en bruto más una marca de tiempo, así que puedes rechazar cualquier cosa que no sea genuinamente de CaptiFi y cualquier cosa que se vuelva a reproducir después.

Reintentos y registro de entregas

Los fallos se reintentan automáticamente con backoff, y cada intento se registra durante 30 días con el código de respuesta y la duración, que responde en segundos "¿lo envió CaptiFi o lo rechazó mi servidor?" en segundos.

Hasta cinco endpoints, en directo y staging

Apunta los mismos eventos a producción y a un entorno de prueba, apaga un endpoint sin eliminarlo, envía un evento de prueba mientras construyes y rota un secreto de firma cuando tu política de seguridad lo indique.

Qué datos fluyen hacia Webhooks

guest.created: un invitado se registra en tu WiFi por primera vez

Guest.Returned: Un invitado que regresa se conecta de nuevo

reward.issued, reward.redeemed, reward.redemption_voided y points.earned, de tu programa de Rewards

ticket.order.paid, ticket.checked_in y ticket.order.refunded, de Eventos

reservation.attended: Aparece un poseedor de reserva o de entrada

booking.created, booking.amended, booking.cancelled, booking.attended y booking.no_show, a partir de reservas de mesas

workflow.action: un paso Enviar a tus webhooks se ejecuta en uno de tus flujos de trabajo, llevando los campos nombrados en ese paso

Se capturaron el nombre del invitado, correo electrónico y teléfono

Estado de marketing y consentimiento de contacto

El lugar y la fecha de la visita

Un ID de entrega por evento, para la deduplicación

Cómo funciona

En marcha en minutos

Añadir un extremo

Abre Webhooks en tu panel de CaptiFi, pega la URL HTTPS que debería recibir eventos y marca los eventos que quieras. La URL debe ser HTTPS: las cargas útiles contienen datos personales de invitados y nunca se envían sin cifrar.

Verifica la firma

Calcula un SHA256 - HMAC de la marca de tiempo y el cuerpo bruto de la solicitud usando tu secreto de firma de endpoint, compáralo en tiempo constante con la cabecera X-CaptiFi-Signature y rechaza cualquier cosa anterior a cinco minutos. Verifica siempre antes de confiar en una carga útil.

Envía un evento de prueba y ponlo en directo

Lanza un evento de prueba desde el panel de control para confirmar que tu gestor lo acepta, luego activa el endpoint. Responde con cualquier 2xx tan pronto como hayas aceptado el evento y haz el trabajo lento después.

Mira el registro de entregas

Cada intento se lista con el evento, número de intento, código de respuesta y duración, que se conservan durante 30 días. Elimina la duplicación en el id del evento para que nunca se procese un reintento dos veces.

Lee la guía de configuración de Webhooks

Paso a paso, con capturas de pantalla.

En el mundo real

Cómo utilizan los locales Webhooks con CaptiFi

Hotel

Un hotel introduce cada nuevo registro WiFi en su CRM vinculado al PMS al llegar, así que la recepción ve a un huésped que regresa antes de que llegue al mostrador.

Grupo de restaurantes

Un evento guest.returned activa una alerta interna para los habituales, permitiendo al equipo de sala saludar a los comensales frecuentes por su nombre sin que nadie vigile un panel de control.

Comercio minorista

Las nuevas inscripciones se publican directamente en una herramienta de automatización low-code, que añade el contacto a una plataforma de correo, etiqueta la sucursal de la tienda y comienza una secuencia de vales de primera visita.

Preguntas frecuentes

¿Qué planes incluyen webhooks?

Los webhooks están incluidos en el plan Growth y superiores, sin coste adicional, junto con el acceso a la API. Una 30prueba gratuita de un día iniciada en Growth o Pro los incluye, para que puedas construir y probar webhooks durante la prueba.

¿A qué eventos puedo suscribirme?

guest.created se activa cuando un huésped se registra en tu WiFi por primera vez, y guest.returned se activa cuando un invitado que ya había estado activa se vuelve a conectar. Las cuentas con Recompensas activadas pueden añadir reward.issued, reward.redeemed, reward.redemption_voided y points.earned; las cuentas con Eventos activadas pueden añadir ticket.order.paid, ticket.checked_in y ticket.order.refunded; y reservation.attended se activa cuando aparece un poseedor de reserva o entrada. Las reservas de mesa añaden booking.created, booking.amended, booking.cancelled, booking.attended y booking.no_show, y workflow.action se activa cuando se ejecuta un paso de Enviar a tus webhooks en uno de tus flujos de trabajo. Marcas los eventos que quieres por endpoint, así que un endpoint solo recibe lo que pidió.

¿Cómo sé que realmente vino una petición de CaptiFi?

Cada solicitud lleva un encabezado X-CaptiFi-Signature que contiene una marca de tiempo y un HMAC SHA-256 de la marca de tiempo y el cuerpo de la petición en bruto, con el secreto de firma de tu endpoint. Verifica en tiempo constante contra el cuerpo bruto, no con JSON recodificado, y rechaza cualquier cosa con más de cinco minutos de antigüedad. Cualquiera puede publicar en tu URL, pero solo CaptiFi puede producir una firma válida.

¿Qué pasa si mi servidor está caído?

Las entregas fallidas se vuelven a intentar automáticamente con backoff, y cada intento se registra en el registro de entregas durante 30 días con el código de respuesta y la duración. Un endpoint que sigue fallando está desactivado, así que el log muestra exactamente por qué se detuvieron las entregas.

¿Podría recibir el mismo evento dos veces?

Sí, un fallo en la red puede significar que se reintente después de que tu servidor ya aceptara el primer intento. Trata las repeticiones del mismo ID de entrega como un solo evento: registra los IDs que has procesado e ignora los que ya has visto.

¿Quién es responsable de los datos de los invitados una vez que nos llegan?

Las cargas útiles de Webhook contienen datos personales de invitados, así que una vez que una copia está en tus sistemas, eres el controlador de esa copia y se aplican tus propias obligaciones de retención, seguridad y eliminación. Eliminar a un invitado en CaptiFi no elimina tu copia.

Combina bien con

CaptiFi REST API Zapier Slack

Empieza a usar Webhooks con CaptiFi hoy mismo

30-Prueba gratuita de un día. Cancela cuando quieras.

Comienza la prueba gratuita Explora todas las integraciones

Google, Gmail, Mailchimp, Klaviyo, HubSpot, Salesforce, Facebook, Meta Pixel, Slack, Zapier, Twilio, Tripadvisor, Yelp, Trustpilot, Untappd, Feefo, REVIEWS.io, Yotpo, Square, SumUp, Airship, Revinate, Leat, Pepper, EmailOctopus, MailerLite e Incentivio son marcas comerciales de sus respectivos propietarios y aparecen aquí solo para identificar los servicios a los que CaptiFi se conecta. CaptiFi es independiente de estas empresas y no está patrocinada, certificada ni avalada por ellas. Una integración que se acerca está en nuestra hoja de ruta y aún no está disponible. Twilio y todos los logotipos relacionados son marcas registradas de Twilio Inc. o sus afiliados. Salesforce es una marca registrada de Salesforce, Inc. Slack es una marca y marca de servicio de Slack Technologies, Inc., registrada en EE. UU. y en otros países.