API & Integrations

14. API & Integrations

API & Integrations セクションには、7Stamp を外部システム（CRM、POS、ERP、分析基盤、messenger bots）とプログラム的に連携させるためのツールが入っています。

API Keys

このセクションのメインページは API key の一覧です。カラムは次の通りです。

• Name — キー名（通常は紐づく Staff name と一致）。
• Login — キーが紐づく Staff login。
• API Key — 実際のキー（7loc_sc_... で始まり、初期状態では隠され、1クリックでコピー可能）。
• Status — Active。
• 🔄 — キーを再発行。
• 🗑️ — キーを削除。

API key の作成

+ ADD API KEY を押すと、Generate API Key ポップアップが開きます。

• Scanner — キーを紐づける Staff Login を選ぶ dropdown（1つの Staff につき1キー）。
• CANCEL / GENERATE ボタン。

GENERATE を押すとキーが作成され、一覧に表示されます。完全なキーは後で表示されない可能性があるため、その場ですぐコピーしてください。

API でできること

• 顧客に Issue a card する（email / phone）。
• 特定の顧客に Add a stamp する。
• Issue a voucher する（テンプレート式または custom、Redeem Code 付き）。
• Redeem a voucher する（独自 POS と連携している場合）。
• カードの状態、進捗、履歴を Read state する。
• Subscribe to Webhooks して、リアルタイムでイベントを受け取る。

Webhooks

Webhooks は card events を外部システムへ送信します。次のイベントがサポートされています（event glossary 参照）。

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

webhook payload の例

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

既成の POS integrations

• Poster — 数クリックで接続できる既成 integration。
• Serve — 既成 integration。
• その他のレジ — リクエストベースで対応。技術的に可能であれば無料です（つまり、あなたのレジが公開 API または Webhooks を提供している場合）。

7loc.com 経由の messenger 配信

WhatsApp、Telegram、Viber 配信には 7loc.com との integration を接続します。有効化後、Campaigns には PUSH と Email に並んで messengers チャネルが表示されます。

No-code シナリオ: Zapier と Make

7Stamp API と Webhooks は Zapier および Make (Integromat) と連携でき、コードなしでフローを構築できます。

• “VOUCHER_REDEEMED が発生したら Mailchimp に tag を追加する”。
• “REWARD_EARNED が発生したら Slack に notification を送る”。
• “BIRTHDAY_GREETING が発生したら CRM に task を作成する”。