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):

• SCAN, DELIVERY_INSERT.
• REWARD_EARNED, LOTTERY_WIN.
• VOUCHER_ISSUED, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED.
• CARD_JOINED, CARD_ADDED_TO_WALLET, CARD_REMOVED_FROM_WALLET.
• CARD_CAMPAIGN, BIRTHDAY_GREETING.

Ejemplo de payload de Webhook

{
  "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
    }
  }
}

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 REWARD_EARNED — enviar una notificación a Slack”.
• “Quan BIRTHDAY_GREETING — crear una tarea en el CRM”.

---