API & Integrations

14. API & Integrations

[tangkapan layar: 0601_Apikey.png]

Bagian API & Integrations berisi alat untuk integrasi terprogram 7Stamp dengan sistem eksternal Anda — CRM, POS, ERP, analitik, bot aplikasi perpesanan.

API Keys

Halaman utama bagian ini adalah daftar kunci API. Kolomnya:

• Name — nama kunci (biasanya sama dengan nama Staff yang ditautkan).
• Login — akun staf tempat kunci ini terikat.
• API Key — kunci itu sendiri (diawali 7loc_sc_..., tersembunyi secara default, dapat disalin dengan satu klik).
• Status — Active.
• 🔄 — membuat ulang kunci.
• 🗑️ — menghapus kunci.

Membuat kunci API

[tangkapan layar: 0602_Apikey.png]

Ketuk + ADD API KEY — jendela Generate API Key terbuka:

• Scanner — daftar tarik-turun untuk memilih akun staf (Staff Login) tempat kunci akan diikat (satu Staff dapat memiliki satu kunci).
• Tombol CANCEL / GENERATE.

Setelah GENERATE, kunci dibuat dan muncul di daftar. Segera salin kunci tersebut — kunci lengkap mungkin tidak ditampilkan lagi.

Apa yang dapat Anda lakukan melalui API

• Menerbitkan kartu untuk pelanggan berdasarkan email/telepon.
• Menambahkan stempel untuk pelanggan tertentu.
• Menerbitkan voucher (dari templat atau khusus, dengan Redeem Code).
• Menukarkan voucher (jika Anda bekerja melalui POS Anda sendiri).
• Membaca status kartu, kemajuan, dan riwayat.
• Berlangganan Webhooks untuk menerima peristiwa secara real time.

Webhooks

Webhooks mengirimkan peristiwa kartu ke sistem eksternal. Yang didukung (lihat glosarium 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 payload 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 siap pakai

• Poster — integrasi siap pakai, terhubung dalam beberapa klik.
• Serve — integrasi siap pakai.
• Kasir lain — dibuat atas permintaan. Gratis jika secara teknis memungkinkan (yaitu, sistem kasir Anda menyediakan API terbuka atau Webhooks).

Siaran pesan lewat aplikasi perpesanan melalui 7loc.com

Untuk siaran pesan WhatsApp, Telegram, dan Viber, integrasi 7loc.com digunakan. Setelah aktif, saluran “aplikasi perpesanan” tersedia di Campaigns di samping PUSH dan Email.

Skenario tanpa kode: Zapier dan Make

API 7Stamp + Webhooks bekerja dengan Zapier dan Make (Integromat), sehingga Anda dapat membangun skenario tanpa menulis kode:

• “Saat VOUCHER_REDEEMED — tambahkan tag di Mailchimp”.
• “Saat REWARD_EARNED — kirim notifikasi ke Slack”.
• “Saat BIRTHDAY_GREETING — buat tugas di CRM”.

---