API & Integrations

14. API & Integrations

[tangkapan skrin: 0601_Apikey.png]

Bahagian API & Integrations mengandungi alat untuk menyepadukan 7Stamp secara pengaturcaraan dengan sistem luaran anda — CRM, POS, ERP, analitik dan bot aplikasi pesanan.

API Keys

Halaman utama bahagian ini ialah senarai kunci API. Lajur:

• Name — nama kunci (biasanya sama dengan nama kakitangan yang dipautkan).
• Login — log masuk kakitangan yang dikaitkan dengan kunci.
• API Key — kunci itu sendiri (bermula dengan 7loc_sc_..., tersembunyi secara lalai, boleh disalin dengan satu klik).
• Status — Active.
• 🔄 — jana semula kunci.
• 🗑️ — padam kunci.

Mencipta kunci API

[tangkapan skrin: 0602_Apikey.png]

Tekan + ADD API KEY — tetingkap Generate API Key dibuka:

• Scanner — senarai juntai bawah untuk memilih log masuk kakitangan yang akan dikaitkan dengan kunci (satu log masuk kakitangan boleh mempunyai satu kunci).
• Butang CANCEL / GENERATE.

Selepas GENERATE, kunci dicipta dan muncul dalam senarai. Salin segera — kunci penuh mungkin tidak akan dipaparkan lagi.

Apa yang boleh anda lakukan melalui API

• Keluarkan kad kepada pelanggan melalui e-mel/telefon.
• Tambah cop kepada pelanggan tertentu.
• Keluarkan baucar (berdasarkan templat atau tersuai, dengan Redeem Code).
• Tebus baucar (jika anda bekerja melalui POS anda sendiri).
• Baca status kad, kemajuan dan sejarah.
• Langgan webhook untuk menerima peristiwa secara masa nyata.

Webhooks

Webhook menghantar peristiwa kad ke sistem luaran. Peristiwa yang disokong (lihat glosari peristiwa):

• 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.

Contoh muatan 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
    }
  }
}

Integrasi POS sedia guna

• Poster — integrasi sedia guna, disambungkan dalam beberapa klik.
• Serve — integrasi sedia guna.
• Mesin tunai lain — dibina atas permintaan. Percuma jika boleh dilaksanakan secara teknikal (iaitu mesin tunai anda menyediakan API terbuka atau webhook).

Siaran aplikasi pesanan melalui 7loc.com

Untuk siaran WhatsApp, Telegram dan Viber, integrasi 7loc.com disambungkan. Setelah aktif, saluran aplikasi pesanan tersedia dalam Campaigns di sebelah PUSH dan Email.

Senario tanpa kod: Zapier dan Make

API 7Stamp + webhook berfungsi dengan Zapier dan Make (Integromat), jadi anda boleh membina senario tanpa menulis kod:

• “Apabila VOUCHER_REDEEMED — tambah tag dalam Mailchimp”.
• “Apabila REWARD_EARNED — hantar pemberitahuan ke Slack”.
• “Apabila BIRTHDAY_GREETING — cipta tugasan dalam CRM”.

---