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 参照）。

• card_issued, card_saved, card_opened。
• stamp_added。
• goal_reached, reward_issued。
• voucher_issued, voucher_redeemed, voucher_expired。
• lottery_played（結果付き）。
• birthday_reached。
• inactivity_trigger。
• campaign_sent。

webhook payload の例

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

既成の 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 を追加する”。
• “goal_reached が発生したら Slack に notification を送る”。
• “birthday_reached が発生したら CRM に task を作成する”。