API e integracions

14. API e integracions

La sección API e integracions contiene herramientas per la integració programática de 7stamp amb sus sistemas externos — CRM, caixa, ERP, análisis, bots de mensajería.

Claves API

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

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

Creación de una clave API

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

• Escáner — menú desplegable per seleccionar el inici de sessió del Personal al que se vinculará la clave (un Personal pot tener una clave).
• Botones CANCELAR / GENERAR.

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

Què pot hacer a través de la API

• Emitir una targeta a un client per correo electrónico/teléfono.
• Agregar un segell a un client específico.
• Emitir un voucher (amb plantilla o personalizado, amb Redeem Code).
• Canjear un voucher (si trabaja a través de su pròpia caixa).
• Leer el estado de la targeta, progreso, historial.
• Suscribirse a Webhooks per recibir esdeveniments en tiempo real.

Webhooks

Els Webhooks envían esdeveniments de targeta a un sistema externo. Compatibles (consulte el glosario de esdeveniments):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (amb 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"
  }
}

Integracions de caixa listas per usar

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

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

Per difusiones per WhatsApp, Telegram, Viber, se conecta la integració de 7loc.com. Una vez activa, el canal “mensajeros” queda disponible en Campanyes junto a PUSH i correo electrónico.

Escenarios sense codi: Zapier i Make

La API + Webhooks de 7stamp funcionan amb Zapier i Make (Integromat), lo que le permet crear escenarios sense programación:

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

---