ロイヤルティ履歴をCRM にミラーリングします
すべてのスタンプ、クーポン、誕生日、および非アクティブのトリガーは、CRM の顧客レコードに記録されます。 7stamp にログインしなくても、販売、通話、チケットの横に完全なロイヤルティ タイムラインが表示されます。
開発者統合
7stamp Webhook
利用可能7stamp からのすべてのロイヤルティ イベントをリアルタイムで独自のシステムにプッシュします。ポーリングやスケジュールされた API 通話はありません。イベントは、発生後数秒以内に HTTPS POST リクエストとして到着します。
Webhook を使用して、CRM、ERP、またはカスタム バックエンドをロイヤルティ側で起こっていること (誰が参加したのか、誰がスタンプを取得したのか、誰がバウチャーを引き換えたのか、誰が誕生日プレゼントをトリガーしたのか、誰が非アクティブになったのか) と同期させます。その後、システムがそのデータをどう扱うかを決定します。
Webhook でできること
Webhook は、統合スタックのアウトバウンド側です。これらは、顧客と報酬のアクティビティを、販売、サービス、分析、メッセージングですでに信頼しているシステムに反映します。
独自のメッセージング スタックをトリガーします
顧客がクーポンを引き換えたら、既存の SMS ゲートウェイから感謝のメッセージ SMS を送信します。顧客がゴールしたら、Slack でお祝いを投稿します。誰かが非アクティブになった場合は、ケースをアカウント マネージャーにルーティングします。
分析と調整の強化
BI ツール、ウェアハウス、または調整パイプラインにイベントをストリーミングします。バウチャー引き換え額と POS 領収書を照合し、独自の指標でロイヤルティ ROI を計算します。
カード イベント タイプ
SCAN — カードがスキャン/stamp アクションを受け取りました。
REWARD_EARNED — カードで報酬を獲得しました。
VOUCHER_ISSUED — バウチャーが発行されました。
VOUCHER_REDEEMED — バウチャーが引き換えられました。
LOTTERY_WIN — 宝くじの結果、当たりました。
DELIVERY_INSERT — 配送挿入フローが記録されました。
CARD_JOINED — 顧客がカードに参加しました。
CARD_CAMPAIGN — カードキャンペーンイベントが発生しました。
BIRTHDAY_GREETING — 誕生日の挨拶イベントが発生しました。
ADMIN_VOUCHER_ISSUE — 管理者がバウチャーを発行しました。
CARD_ADDED_TO_WALLET — 顧客がカードをウォレットに追加しました。
CARD_REMOVED_FROM_WALLET — 顧客が財布からカードを取り出しました。
安全な Webhook レシーバーを構築する
耐久性のある処理後に確認する
エンドポイントは HTTPS を受け入れる必要がありますPOST、リクエストの形式を検証し、イベントを永続化またはキューに入れてから、成功した 2xx レスポンスを返します。安全にキューに入れることができる場合は、確認応答の前に低速の CRM またはメッセージング コールを行わないでください。
External ID
関連するすべてのイベントには、カードの作成またはスキャン時に使用した External ID およびオプションの External Source が含まれます。このペアを使用すると、名前やメールアドレスから推測することなく、自分の CRM、POS、または注文記録を更新できます。
Make 配信べき等
副作用を引き起こす前に、耐久性のある処理キーまたはイベント フィンガープリントを保存します。受信者が同じ配信を再度見た場合、重複したメモ、伝票、またはメッセージを追加しないでください。エンドポイント URL をシークレットとして扱います。
イベント ペイロードの形状の例
これを自動化ステップにコピーします
json {
"event_type": "SCAN",
"scanned_at": "2026-07-23T12:34:56Z",
"user_card_id": 123,
"card_template_id": 42,
"card_template_name": "Coffee Loyalty",
"stamps_added": 1,
"stamps_before": 4,
"stamps_after": 5,
"amount": 24.5,
"external_order_id": "order_2048",
"external_id": "crm_contact_8821",
"external_source": "hubspot"
}Webhook の構成とテスト
バックエンドに HTTPS エンドポイント、CRM 統合レイヤー、Make Webhook、または Zapier を作成しますCatch Hook。 Make URL をコピーする前に、必ず宛先を制御してください。
7stamp Admin で、Stamp Cards → API & Integrations → Webhooks を開きます。
エンドポイント URL を追加し、受信ワークフローが実際に必要とするイベント タイプのみを選択します。
プロファイル設定を保存し、使い捨てテスト スキャンまたはカード アクションをトリガーしてイベントを生成します。
受信したペイロードを検査します。 External ID と External Source を予期されるレコードと照合し、受信者が成功した応答を返すことを確認します。
CRM、バウチャー、またはメッセージングの副作用は、リプレイセーフな処理と障害の監視が行われた後にのみ有効にしてください。
コードなしオプション: Make および Zapier
Make では、Webhooks → Custom webhook を使用して受信 URL を生成し、7stamp プロファイルに貼り付けます。 Zapier では、同じ目的で Webhooks by Zapier → Catch Hook を使用します。現在の API は自動 Webhook 登録エンドポイントを公開しないため、7stamp プロファイルはサブスクリプションを所有します。
セキュリティおよび配信契約
現在のペイロード スキーマとフィールドの意味のソースとして、公開リファレンス OpenAPI の Webhook セクションを使用します。 HTTPS を要求し、受信者 URL を公開ログから遠ざけ、処理を冪等にします。本番環境で特定のヘッダー名または再試行ポリシーを強制する前に、オンボーディング中に 7stamp プロファイルの request-authentication/signature 手順を確認してください。
よくある質問
特定の Webhook イベントのみを選択できますか?
はい。 7stamp プロファイルの Webhook 設定でイベント タイプを選択し、受信者がワークフローに重要なイベントのみを取得できるようにします。
Webhook を Make または Zapier に接続するにはどうすればよいですか?
Make で受信 Webhook を作成するか、Zapier で Catch Hook を作成し、生成された URL をコピーして、7stamp プロファイルの Webhook 設定に貼り付けて、テスト イベントを送信します。
イベントをCRM 連絡先に一致させるにはどうすればよいですか?
External ID を使用し、存在する場合は External Source を使用します。これらは、カードの作成時またはスキャン時に統合によって提供された識別子です。
署名ヘッダーまたはリトライのタイミングを想定する必要がありますか?
いいえ。現在の OpenAPI/profile 配信契約を使用し、ヘッダーをハードコーディングしたり仮定を再試行したりする前に、オンボーディング中にプロファイルの認証手順を確認してください。
次のステップ
最初のカードイベントを送信する準備はできましたか?
受信機を作成し、その HTTPS URL をプロファイルに貼り付け、使い捨てスキャンを実行し、ダウンストリーム自動化を有効にする前に一致する External ID を検証します。