API e integraciones

14. API e integraciones

La sección API e integraciones contiene herramientas para la integración programática de 7stamp con sus sistemas externos — CRM, caja, ERP, análisis, bots de mensajería.

Claves API

La página principal de la sección es la lista de claves API. Columnas:

• Nombre — nombre de la clave (generalmente coincide con el nombre del Personal vinculado).
• Inicio de sesión — el inicio de sesión del Personal al que está vinculada la clave.
• Clave API — la clave en sí (comienza con 7loc_sc_..., oculta por defecto, copiable con un clic).
• Estado — Activo.
• 🔄 — regenerar la clave.
• 🗑️ — eliminar la clave.

Creación de una clave API

Toque + AÑADIR CLAVE API — se abre el popup Generar clave API:

• Escáner — menú desplegable para seleccionar el inicio de sesión del Personal al que se vinculará la clave (un Personal puede tener una clave).
• Botones CANCELAR / GENERAR.

Después de GENERAR la clave se crea y aparece en la lista. Cópiela de inmediato — es posible que la clave completa no se muestre de nuevo.

Qué puede hacer a través de la API

• Emitir una tarjeta a un cliente por correo electrónico/teléfono.
• Agregar un sello a un cliente específico.
• Emitir un voucher (con plantilla o personalizado, con Redeem Code).
• Canjear un voucher (si trabaja a través de su propia caja).
• Leer el estado de la tarjeta, progreso, historial.
• Suscribirse a Webhooks para recibir eventos en tiempo real.

Webhooks

Los Webhooks envían eventos de tarjeta a un sistema externo. Compatibles (consulte el glosario de eventos):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (con el resultado).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Ejemplo de payload de Webhook

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Integraciones de caja listas para usar

• Poster — integración lista para usar, se conecta en pocos clics.
• Serve — integración lista para usar.
• Otras cajas — realizadas bajo solicitud. Gratuitas si son técnicamente factibles (es decir, su caja expone una API abierta o Webhooks).

Difusiones por mensajería a través de 7loc.com

Para difusiones por WhatsApp, Telegram, Viber, se conecta la integración de 7loc.com. Una vez activa, el canal “mensajeros” queda disponible en Campañas junto a PUSH y correo electrónico.

Escenarios sin código: Zapier y Make

La API + Webhooks de 7stamp funcionan con Zapier y Make (Integromat), lo que le permite crear escenarios sin programación:

• “Cuando voucher_redeemed — añadir una etiqueta en Mailchimp”.
• “Cuando goal_reached — enviar una notificación a Slack”.
• “Cuando birthday_reached — crear una tarea en el CRM”.

---