Integración de desarrolladores

7stamp Webhooks

Disponible

Envíe cada evento de fidelización desde 7stamp a sus propios sistemas en tiempo real. Sin encuestas ni llamadas programadas API. Los eventos llegan como solicitudes HTTPS POST a los pocos segundos de ocurrir.

Utilice webhooks para mantener su CRM, ERP o backend personalizado sincronizado con lo que sucede en el lado de la lealtad: quién se unió, quién recibió un sello, quién canjeó un cupón, quién activó un regalo de cumpleaños y quién quedó inactivo. Luego, sus sistemas deciden qué hacer con esos datos.

Qué puede hacer con los webhooks

Los webhooks son el lado saliente de la pila de integración. Reflejan la actividad de los clientes y las recompensas en los sistemas en los que ya confía para ventas, servicios, análisis y mensajería.

Refleja el historial de fidelidad en tu CRM

Cada activador de sello, vale, cumpleaños e inactividad llega al registro del cliente en su CRM. Verá el cronograma completo de lealtad junto a ventas, llamadas y boletos sin iniciar sesión en 7stamp.

Active su propia pila de mensajes

Cuando un cliente canjee un cupón, envíe un agradecimiento SMS desde su puerta de enlace SMS existente. Cuando un cliente alcance la meta, publique una celebración en Slack. Cuando alguien se vuelve inactivo, dirige el caso a tu administrador de cuentas.

Potencia el análisis y la reconciliación

Transmite eventos a tu BI herramienta, almacén o canal de conciliación. Compare los canjes de vales con los recibos POS y calcule la lealtad ROI en sus propias métricas.

Tipos de eventos de tarjeta

SCAN: una tarjeta recibió una acción de escaneo/stamp.
REWARD_EARNED — Se obtuvo una recompensa en la tarjeta.
VOUCHER_ISSUED — Se emitió un vale.
VOUCHER_REDEEMED — Se canjeó un cupón.
LOTTERY_WIN — Una lotería resultó en una victoria.
DELIVERY_INSERT: se registró un flujo de inserción de entrega.
CARD_JOINED — Un cliente se unió a una tarjeta.
CARD_CAMPAIGN — Se produjo un evento de campaña de tarjetas.
BIRTHDAY_GREETING — Se produjo un evento de felicitación de cumpleaños.
ADMIN_VOUCHER_ISSUE — Un administrador emitió un vale.
CARD_ADDED_TO_WALLET: un cliente agregó la tarjeta a su billetera.
CARD_REMOVED_FROM_WALLET — Un cliente sacó la tarjeta de su billetera.

Construir un receptor de webhook seguro

Confirmar después de un manejo duradero

Su punto final debe aceptar HTTPS POST, valide la forma de la solicitud, persista o ponga en cola el evento y luego devuelva una respuesta 2xx exitosa. No realice una llamada lenta CRM ni de mensajería antes del reconocimiento si se puede poner en cola de forma segura.

Correlacionarse con External ID

Cada evento relacionado puede llevar el External ID y el External Source opcional que utilizó al crear o escanear la tarjeta. Utilice este par para actualizar su propio registro CRM, POS o pedido sin tener que adivinar a partir de un nombre o correo electrónico.

Make entrega idempotente

Almacene una clave de procesamiento duradera o una huella digital de evento antes de desencadenar efectos secundarios. Si su destinatario vuelve a ver la misma entrega, no debe agregar una nota, vale o mensaje CRM duplicado. Trate el punto final URL como un secreto.

Ejemplo de forma de carga útil de evento

Copie esto en su paso de automatización json
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

Configure y pruebe un webhook

01

Cree un punto final HTTPS en su backend, una capa de integración CRM, un webhook Make o un Zapier Catch Hook. Make asegúrese de controlar el destino antes de copiar su URL.

02

En 7stamp Admin, abre Stamp Cards → API & Integrations → Webhooks.

03

Agregue el punto final URL y seleccione solo los tipos de eventos que el flujo de trabajo de recepción realmente necesita.

04

Guarde la configuración del perfil y luego active un escaneo de prueba desechable o una acción de tarjeta para producir un evento.

05

Inspeccione la carga útil recibida. Haga coincidir External ID y External Source con el registro esperado y confirme que el receptor devuelva una respuesta exitosa.

06

Habilite CRM, vales o efectos secundarios de mensajes solo después de tener un manejo y monitoreo de fallas seguros para la reproducción.

Opciones sin código: Make y Zapier

En Make, use Webhooks → Custom webhook para generar una recepción URL y péguela en 7stamp perfil. En Zapier, utilice Webhooks by Zapier → Catch Hook para el mismo propósito. El perfil 7stamp es propietario de la suscripción porque el API actual no expone los puntos finales de registro automático de webhooks.

Contrato de seguridad y entrega

Utilice la sección Webhooks de la referencia pública OpenAPI como fuente para el esquema de carga útil actual y el significado del campo. Requerir HTTPS, mantener el receptor URL fuera de los registros públicos y hacer que el procesamiento sea idempotente. Confirme el procedimiento de solicitud de autenticación/signature para su perfil 7stamp durante la incorporación antes de aplicar un nombre de encabezado específico o una política de reintento en producción.

Preguntas frecuentes

¿Puedo seleccionar solo ciertos eventos de webhook?

Sí. Seleccione los tipos de eventos en la configuración del webhook del perfil 7stamp para que el receptor obtenga solo los eventos que son importantes para su flujo de trabajo.

¿Cómo conecto webhooks a Make o Zapier?

Cree el webhook receptor en Make o un Catch Hook en Zapier, copie el URL generado, luego péguelo en la configuración del webhook del perfil 7stamp y envíe un evento de prueba.

¿Cómo debo relacionar un evento con mi contacto CRM?

Utilice External ID y, cuando esté presente, External Source. Estos son los identificadores que su integración proporcionó cuando se creó o escaneó la tarjeta.

¿Debo asumir un encabezado de firma o volver a intentarlo?

No. Utilice el contrato de entrega OpenAPI/profile actual y confirme el procedimiento de autenticación de su perfil durante la incorporación antes de codificar un encabezado o reintentar una suposición.

Siguiente paso

¿Listo para enviar el primer evento de tarjeta?

Cree un receptor, pegue su HTTPS URL en el perfil, ejecute un escaneo desechable y valide la coincidencia External ID antes de habilitar la automatización posterior.