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.
Integración de desarrolladores
7Stamp Webhooks
DisponibleEnví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.
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 {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}Configure y pruebe un webhook
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.
En 7Stamp Admin, abre Stamp Cards → API & Integrations → Webhooks.
Agregue la URL del endpoint. El webhook recibe todos los eventos de tarjeta del perfil, así que filtre por data.event_type en su receptor.
Guarde la configuración del perfil y luego active un escaneo de prueba desechable o una acción de tarjeta para producir un evento.
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.
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
Use la sección Webhooks de la referencia pública de OpenAPI como fuente del esquema actual de la carga útil. El cuerpo es un sobre: profile_id y profile_name indican el perfil de 7Stamp, event_id identifica el evento y el propio evento de tarjeta va en data (para una URL de Make o Zapier, la clave es card_event). Cada entrega se firma en un solo encabezado, X-Webhook-Signature: t=…,s=…. Calcule HMAC-SHA256 con el secreto del webhook sobre t más el cuerpo sin procesar de la solicitud, codifíquelo en hexadecimal y compárelo con s; el secreto está en la página del webhook en 7Stamp Admin. Use X-Webhook-Event-Id para descartar entregas repetidas: un reintento se vuelve a firmar con un nuevo t. También puede proteger el endpoint con Basic Auth. Exija HTTPS y mantenga la URL del receptor fuera de los logs públicos.
Preguntas frecuentes
¿Puedo seleccionar solo ciertos eventos de webhook?
No. Un webhook de 7Stamp recibe todos los eventos de tarjeta del perfil. Filtre por data.event_type en su receptor; en Make y Zapier el evento llega bajo card_event, así que filtre por card_event.event_type.
¿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?
Use data.external_id y, cuando esté presente, data.external_source: vuelven en cada webhook de las tarjetas que usted emitió a través de la API con su propio ID. Un cliente que obtuvo la tarjeta por su cuenta no tiene External ID, así que identifíquelo por data.user.email. Una dirección «Hide My Email» de Apple es una dirección de reenvío, no la que figura en su CRM.
¿Cómo compruebo que un webhook proviene de 7Stamp?
Divida el encabezado X-Webhook-Signature en t y s, calcule HMAC-SHA256 con el secreto del webhook de 7Stamp Admin sobre t más el cuerpo sin procesar de la solicitud, codifíquelo en hexadecimal y compárelo con s. Tome t exactamente como se envió y el cuerpo como los bytes sin procesar recibidos, antes de cualquier análisis del JSON. Descarte una entrega cuyo X-Webhook-Event-Id ya haya procesado: un reintento se vuelve a firmar con un nuevo t.
Páginas relacionadas
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.