API & การเชื่อมต่อ

14. API & การเชื่อมต่อ

The API & การเชื่อมต่อ ส่วน contains tools for programmatic integration of 7stamp with your external systems — CRM, POS, ERP, analytics, messenger bots.

API Keys

The main page of the ส่วน is the API key list. Columns:

• Name — key name (usually matches the linked พนักงาน name).
• Login — the พนักงาน login the key is tied to.
• API Key — the key itself (starts with 7loc_sc_..., hidden by default, copyable with one click).
• Status — Active.
• 🔄 — regenerate the key.
• 🗑️ — delete the key.

Creating an API key

Tap + ADD API KEY — the Generate API Key popup opens:

• พนักงาน สแกนner — dropdown to pick the พนักงาน Login the key will be bound to (one พนักงาน can have one key).
• Buttons CANCEL / GENERATE.

After GENERATE the key is created and appears in the list. Copy it immediately — the full key may not be shown again.

What you can do via the API

• Issue a การ์ด to a ลูกค้า by email/phone.
• Add a แสตมป์ to a specific ลูกค้า.
• Issue a voucher (templated or custom, with Redeem Code).
• Redeem a voucher (if you work via your own POS).
• อ่าน state of the การ์ด, progress, history.
• Subscribe to Webhooks to receive events in real time.

Webhooks

Webhooks send การ์ด events to an external system. การสนับสนุนed (see the event glossary):

• การ์ด_issued, การ์ด_saved, การ์ด_opened.
• แสตมป์_added.
• goal_reached, รางวัล_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (with the result).
• birthday_reached.
• inactivity_trigger.
• แคมเปญ_sent.

Webhook payload example

{
 "event": "voucher_redeemed",
 "timestamp": "2026-05-11T12:34:56Z",
 "ธุรกิจ_id": "b_123",
 "location_id": "loc_45",
 "ลูกค้า": {
 "id": "c_789",
 "วอลเล็ต_pass_id": "wp_abc",
 "language": "en"
 },
 "การ์ด": { "id": "การ์ด_001", "goal_index": 2 },
 "voucher": {
 "id": "v_555",
 "type": "voucher",
 "redeem_code": "FREECOFFEE",
 "redeem_code_formats": ["text", "qr", "barcode"],
 "status": "redeemed",
 "redeemed_via": "พนักงาน_scanner"
 }
}

Ready-made POS integrations

• Poster — ready-made integration, connects in a few clicks.
• Serve — ready-made integration.
• Other tills — made on request. Free if technically feasible (i.e., your till exposes an เปิด API or Webhooks).

Messenger broadcasts via 7loc.com

For WhatsApp, Telegram, Viber broadcasts, the 7loc.com integration is connected. Once active, the “messengers” channel becomes available in แคมเปญ ถัดไป to PUSH and Email.

ไม่-code scenarios: Zapier and Make

7stamp API + Webhooks work with Zapier and Make (Integromat), letting you build scenarios without coding:

• “When voucher_redeemed — add a tag in Mailchimp”.
• “When goal_reached — send a notification to Slack”.
• “When birthday_reached — สร้าง a task in CRM”.

---