Cree una tarjeta después de un nuevo contacto CRM
Utilice el contacto CRM ID como External ID, cree una invitación de tarjeta 7stamp y luego envíe la instalación devuelta URL a través de tu correo electrónico habitual, SMS, o paso de mensajería.
Guía de automatización sin código
Conecte 7stamp a Make, paso a paso
Guía de implementaciónUtilice Make para conectar 7stamp con un CRM, POS, una tienda en línea, una hoja de cálculo, una herramienta de mensajería o cualquier sistema que pueda enviar datos a un escenario. La ruta lista para producción hoy es la aplicación HTTP de Make para llamadas 7stamp API y la Custom webhook de Make para eventos 7stamp entrantes.
Todavía no hay ninguna aplicación 7stamp pública en el selector de aplicaciones de Make. No espere uno: agregue HTTP → Make a request, use el URL exacto, el método, el encabezado Bearer y el JSON a continuación, luego asigne los campos de su módulo fuente. Este es el mismo 7stamp Integration API que usaría un conector futuro.
Elija el primer escenario que coincida con su flujo de trabajo
Comience con un evento y un resultado. Una vez que los datos de la prueba sean correctos, agregue filtros, enrutadores, actualizaciones CRM y mensajes de seguimiento.
Agregar sellos después de un pedido pagado
Activa el escenario desde un POS pagado o un pedido de comercio electrónico. Asigne su cliente estable ID y ordene ID en Scan a Card, luego use una cantidad o un recuento de sellos explícito.
Envíe un seguimiento de recompensa
Cuando un evento de tarjeta informe una recompensa o un vale, ramifique el escenario: actualice el CRM, notifique al equipo y envíe una tarjeta de billetera o un correo electrónico solo cuando sea necesario.
Manejar un sistema sin una aplicación Make nativa
Utilice el módulo HTTP de Make para llamar a 7stamp directamente. Esta es la opción universal para un motor de reservas personalizado POS, ERP o cualquier primer servicio API.
7stamp operaciones para llamar desde Make HTTP
Para cada tarjeta a continuación, agregue HTTP → Make a request, luego configure el método y URL exactamente como se muestra. Utilice la misma clave Bearer para cada solicitud. El mapeo requerido le indica qué suministrar desde su CRM, POS o activador de comercio electrónico.
Make disparador
Webhooks → Custom webhook Recibir un evento de tarjeta
Cree un Custom webhook en Make, copie su URL, luego pegue ese URL en la configuración del webhook del perfil 7stamp. Esto inicia un escenario en el que 7stamp envía un evento como SCAN, REWARD_EARNED o VOUCHER_ISSUED.
- En Make
- Webhooks → Custom webhook → Agregar; asígnele un nombre claro y cópielo generado URL.
- En 7stamp
- Administrador → API & Integrations → Webhooks; pegue el URL, seleccione los tipos de eventos, guarde y luego cree un evento de prueba.
HTTP
POST /cards/invite Crea una acción Card Invite
Crea una nueva instalación personal URL y un código de inserción de entrega para un contacto externo.
- Requerido
- external_id — mapea tu establo CRM/contact ID, no un nombre.
- Luego use
- Mapa install_url de la respuesta a su correo electrónico, SMS o CRM paso de actualización.
HTTP acción
POST /cards/invite/bulk Creación masiva Card Invites
Crea hasta 100 enlaces de invitación en una solicitud. Úselo para una migración o campaña controlada, no para una exportación de contactos ilimitada.
- Elementos
- requeridos: una matriz JSON de 1 a 100 objetos de solicitud de invitación individuales.
- Verifique
- Lea success_count, error_count y cada resultado antes de enviar cualquier enlace.
HTTP acción
GET /cards Find Cards
Encuentra registros de tarjetas por External ID, con plantillas opcionales y filtros de origen.
- Requerido
- Parámetro de consulta external_id.
- Opcional
- external_source y template_id limitan la búsqueda cuando un sistema tiene varios programas.
HTTP acción
GET /cards/{user_card_id} Obtener un detalle de tarjeta
Lee el estado completo de una tarjeta cuando un paso anterior ha devuelto su User Card ID interno.
- Requerido
- Reemplace {user_card_id} con el ID interno devuelto por una respuesta 7stamp confiable.
- Evite
- No adivine ni almacene una tarjeta ID de un perfil diferente.
HTTP acción
POST /cards/scan Escanear una tarjeta
Agrega sellos de un monto de compra o un conteo explícito. Acepta User Card ID o External ID y puede conservar la referencia del pedido externo.
- Identidad
- Utilice external_id y opcional external_source; user_card_id gana si se suministran ambos.
- Compra
- Usar monto para tarjetas basadas en monto o stamps_count para un número explícito; stamps_count tiene prioridad.
- Trazabilidad
- Mapee external_order_id del pedido pagado/receipt para que se puedan comparar los eventos 7stamp.
HTTP acción
GET /templates List Templates
Enumera las plantillas de tarjeta disponibles para la clave API. Úselo para probar la conexión o para seleccionar una plantilla dinámicamente.
- Primera prueba
- Esta es la primera solicitud más segura: no tiene cuerpo y no cambia los datos del cliente.
- Mapa más tarde
- Utilice la identificación de una plantilla activa como template_id solo cuando el perfil tenga más de una plantilla activa.
HTTP acción
GET /templates/{template_id}/design Get Template Design
Devuelve la configuración de diseño visual para una plantilla conocida, útil cuando otro sistema necesita mostrar una elección de tarjeta consistente.
HTTP acción
POST /vouchers/issue Emitir un vale
Emite un vale a un propietario de tarjeta identificado por External ID o User Card ID.
- Se requiere vale
- .short_description. Apunte a la tarjeta con external_id o un user_card_id conocido.
- Validez
- Utilice validity_type con validity_value, o lea la referencia OpenAPI para obtener una fecha de vencimiento fija.
HTTP acción
POST /messages/send Enviar un mensaje
Envía contenido al propietario de la tarjeta mediante push de tarjeta tipo billetera y/or correo electrónico, sujeto al canal configurado y a las reglas de consentimiento.
- Card push
- card_push_text está limitado a 20 caracteres y requiere un pase de billetera instalado.
- Correo electrónico
- Enviar asunto más cuerpo; básico HTML se apoya en el cuerpo.
Make módulo
Full 7stamp endpoint URL HTTP → Make a request
Este es el módulo Make que llama a todas las rutas 7stamp anteriores. Utilice un URL completo, seleccione el método documentado, agregue el encabezado Bearer y utilice JSON solo cuando la ruta necesite un cuerpo.
- Base URL
- https://api.7loc.com/cards-api
- Encabezado
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json para solicitudes POST.
Tres escenarios Make que puedes construir exactamente como está escrito
Los nombres a continuación son los módulos Make reales. Comience con el primer escenario, ejecútelo con un contacto desechable y solo luego agregue enrutadores, filtros o programación de producción.
1. Nuevo contacto CRM → enviar un enlace de tarjeta 7stamp
Resultado esperado: El cliente recibe el install_url devuelto por 7stamp; su CRM puede mantener ese URL en el mismo registro de contacto.
- 1 Cree un escenario y agregue el activador de contacto nuevo/Created de su CRM. Para Kommo, elija el activador de creación de contacto y ejecútelo una vez para cargar un contacto de muestra.
- 2 Agregar HTTP → Make a request. Establezca Método en POST y URL en https://api.7loc.com/cards-api/cards/invite.
- 3 Agregue Authorization: Bearer YOUR_7STAMP_API_KEY y Content-Type: application/json. En el cuerpo JSON, asigne el contacto CRM ID a external_id y establezca external_source en una etiqueta fija como kommo.
- 4 Ejecute el módulo HTTP una vez. Confirme que la salida tenga install_url, delivery_insert_code, external_id y template_id.
- 5 Agregue su módulo de actualización de correo electrónico/SMS/CRM después de HTTP y asigne install_url desde la salida HTTP. Guarde el URL en el contacto CRM si el equipo debe reenviarlo más tarde.
Verifique: POST /cards/invite siempre crea una nueva invitación. Utilice Find Cards primero si su regla comercial es evitar otra invitación para un contacto existente.
2. Pedido pagado → agregue sellos de fidelidad
Resultado esperado: Una respuesta de escaneo exitosa incluye el éxito, scan_id, stamps_added y el estado de la tarjeta posterior al escaneo para su siguiente paso.
- 1 Comience desde el activador de orden pagada POS/ecommerce. Make asegúrese de que su muestra contenga un cliente estable ID y el pedido/receipt ID.
- 2 Agregue HTTP → Make a request con POST https://api.7loc.com/cards-api/cards/scan y el mismo encabezado Bearer.
- 3 Mapa external_id del cliente, external_source del nombre del sistema y external_order_id del pedido ID. Agregue monto para tarjetas basadas en monto, o stamps_count para una cantidad explícita de sellos.
- 4 Run once con un pedido de prueba. Verifique el indicador de éxito devuelto y stamps_added antes de habilitar la programación del escenario.
- 5 Opcionalmente, agregue un filtro después del paso HTTP: continúe solo cuando el éxito sea verdadero, luego escriba scan_id o stamps_added nuevamente en el registro de pedido/CRM.
Verifique: Utilice el mismo external_order_id en los reintentos para que se pueda rastrear el pedido en eventos de webhook posteriores; no otorgue sellos dos veces después de una ejecución fallida poco clara.
3. Evento 7stamp → actualiza el evento CRM
Resultado esperado: Make recibe el evento 7stamp inmediatamente y puede encontrar el registro CRM coincidente a través de external_id y external_source.
- 1 Cree un escenario Make separado. Agregue Webhooks → Custom webhook, seleccione Agregar, asígnele el nombre 7stamp-card-events y copie el URL generado.
- 2 En 7stamp Admin, abre API & Integrations → Webhooks. Agregue eso URL y seleccione un pequeño conjunto de eventos, por ejemplo SCAN y REWARD_EARNED.
- 3 Cree un evento de tarjeta o escaneo de prueba desechable en 7stamp. Regrese a Make y use Run once para permitir que Make determine la estructura de datos del evento.
- 4 Agregue un paso de búsqueda CRM usando external_id. Agregue un filtro o enrutador en event_type para que SCAN, REWARD_EARNED y VOUCHER_ISSUED puedan realizar diferentes acciones.
- 5 Agregue la acción CRM actualizar/note. Asigne scanned_at, stamps_after, external_order_id y issued_vouchers solo cuando esos campos estén presentes para el tipo de evento seleccionado.
Verifique: Mantenga el webhook URL privado. Pruebe un evento real antes de activar mensajes irreversibles, vales o cambios CRM.
Obtenga la clave 7stamp API antes de abrir Make
Estas son las pantallas 7stamp Admin exactas. Cree la clave una vez, cópiela en la conexión segura HTTP/keychain de Make y luego elimínela inmediatamente de su portapapeles.
Prepare la conexión antes de construir
Cree una clave API por entorno
En 7stamp Admin, vaya a API & Integrations → API Keys → Add API Key. Guarde el valor en la conexión de clave HTTP API/keychain cuando esa opción esté disponible. Nunca asigne la clave desde un campo de texto, ni la coloque en una nota ni la utilice en un flujo de trabajo orientado al navegador. Una clave pertenece a un 7stamp lugar de trabajo/profile.
Utilice un estable External ID
Asigne el inmutable ID de su CRM, POS o plataforma de comercio, por ejemplo un CRM contacto ID o un cliente UUID. Agregue External Source como hubspot, shopify o poster cuando el mismo identificador pueda aparecer en más de un sistema.
Decida qué plantilla se aplica
Cuando el perfil 7stamp conectado tiene una plantilla de tarjeta activa, la plantilla se puede dejar vacía. Con varias plantillas, asigne o elija template_id deliberadamente para que cada invitación y escaneo llegue al programa de fidelización previsto.
Configuración exacta Make HTTP: cree una tarjeta de invitación
Copie esto en su paso de automatización
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}Cree y pruebe su primer escenario Make
En 7stamp Admin, cree una clave en API & Integrations → API Keys → Add API Key. Utilice un perfil de prueba independiente/key cuando la configuración de su cuenta lo permita.
En Make, cree un escenario y agregue el activador de origen. Ejecútelo una vez antes del mapeo para que pueda ver un contacto de muestra real o un pedido pagado.
Haga clic en el siguiente signo más, busque HTTP y elija Make una solicitud. Configure el método, completo URL y los encabezados de la tarjeta de operación en esta página.
Utilice GET https://api.7loc.com/cards-api/templates como primera solicitud. Su respuesta exitosa demuestra que la clave funciona sin cambiar ningún dato del cliente.
Para rutas POST, seleccione application/json y pegue la forma del cuerpo de esta guía. Mapear un establo External ID; agregue template_id solo si el perfil tiene varias plantillas activas.
Ejecute con un contacto desechable, inspeccione la salida HTTP y solo entonces asigne sus campos de respuesta exactos al siguiente CRM, correo electrónico o módulo de mensajería.
¿Cuándo deberías usar Make HTTP?
Utilice HTTP para 7stamp ahora: es la ruta documentada y lista para producción, no una alternativa reducida. Elíjalo siempre que necesite una operación 7stamp, una nueva ruta API o una conexión POS/ERP personalizada. La referencia OpenAPI es la fuente de verdad para el método, la ruta completa, el cuerpo y el esquema de respuesta; la clave de portador y la base URL permanecen iguales.
Reciba 7stamp eventos en Make
Para un escenario basado en eventos, agregue Webhooks → Custom webhook y cree un webhook. Copie su URL, abra API & Integrations → Webhooks en el perfil 7stamp, pegue el URL, seleccione los tipos de eventos, guarde y envíe un evento de prueba real. El perfil 7stamp posee esa suscripción; el actual API no expone los puntos finales de suscripción automática de webhook/unsubscribe.
No se requiere ningún conector Make público
Las instrucciones de esta página utilizan módulos Make que están disponibles para todas las cuentas Make. Si desea un futuro módulo nativo 7stamp en lugar de HTTP, envíenos el flujo de trabajo que necesita; hasta entonces, HTTP y Custom webhook cubren todas las operaciones 7stamp documentadas.
Preguntas frecuentes
No puedo encontrar 7stamp en Make. ¿Aún puedo automatizarlo?
Sí. Hoy en día no existe ninguna aplicación 7stamp pública en Make. Agregue HTTP > Make una solicitud, use el punto final 7stamp completo URL y envíe Authorization: Bearer seguido de su clave 7stamp API. HTTP puede llamar a todos los puntos finales documentados.
¿Dónde consigo el token para la conexión Make?
En 7stamp Admin, abra API Integraciones, luego API Keys, luego Add API Key. La clave tiene como alcance el lugar de trabajo/profile que la creó, así que utilice un perfil de prueba para escenarios de prueba siempre que sea posible.
¿Qué identificador debo asignar como External ID?
Utilice el identificador estable del sistema fuente, preferiblemente un contacto CRM ID o un cliente UUID. No utilice un nombre para mostrar. Un número de teléfono o un correo electrónico pueden funcionar, pero pueden cambiar y deben manejarse de manera consistente.
¿Cómo introduzco eventos 7stamp en Make?
Cree un Webhooks > Custom webhook en Make, luego pegue el URL generado en la configuración del webhook del perfil 7stamp. Utilice un filtro o enrutador Make después de la entrega para manejar el event_type entrante.
Siguiente paso
¿Listo para automatizar la primera acción de fidelización?
Cree la clave API, pruebe List Templates y cree una invitación o un escenario de escaneo con un contacto desechable. Agregue enrutadores y mensajería solo después de que ese flujo simple sea confiable.