Reservas y CRM

Salones, clínicas, estudios y otros negocios que trabajan con cita previa: premia las visitas cuando el cliente vino de verdad.

En un sistema de reservas, el momento que importa es cuando una cita se marca como atendida, junto con lo que pagó el cliente. Así se traduce a la API:

En el sistema de reservas	Llamada
Cliente nuevo con teléfono	`POST /v1/members` (devuelve el socio existente si el teléfono ya se conoce)
Cita atendida y pagada	`POST /v1/transactions` con el id de la cita como `external_id` y el importe pagado
Atendida, sin datos de pago	`POST /v1/visits` con el id de la cita como `external_id` (programas de sellos y de visitas)
Pago cancelado o reembolsado	`POST /v1/transactions/{external_id}/void`
El cliente quiere pagar con cashback	Lee `cashback.balance` y envía el ticket con `redeem_amount`

Usa el id de la cita (no el del cliente) como external_id: así, si la misma cita se marca dos veces como atendida, solo genera una vez.

Altegio

Los locales que usan Altegio no necesitan código: instalan la app de Loyaltyfy desde el marketplace de Altegio y conectan sus sedes. Lo que hace el conector es un buen modelo para tu propia integración:

Escucha los webhooks de registros de Altegio. Un registro con la asistencia confirmada se aplica como ticket, con el id del registro como clave de idempotencia.
Si el cliente aún no tiene tarjeta de Loyaltyfy, la visita queda en espera. Cuando el cliente añade la tarjeta (con el mismo teléfono), las visitas pendientes se aplican, así que no se pierde nada.
Además, cada 15 minutos consulta los registros recientes, porque los webhooks se pueden perder; los duplicados se ignoran por el id del registro.
Cuando el cajero canjea cashback en Loyaltyfy, el importe se puede anotar en la visita abierta de Altegio como pago de fidelización, si la red tiene configurado un tipo de tarjeta de fidelización.

Otros sistemas

Si tu sistema de reservas o CRM puede enviar webhooks, la integración más sencilla es un pequeño servicio que los reciba y llame a los endpoints de la tabla anterior. Si no puede, consulta su API cada pocos minutos para obtener las citas atendidas y envíalas con sus ids; las repeticiones no hacen daño. Escribe a api@loyaltyfy.io si quieres que creemos un conector listo para tu plataforma.