新しい CRM 連絡先
CRM 連絡先 ID を External ID として使用し、7stamp カード招待を作成し、返されたインストール URL を通常のメールで送信します。 SMS、またはメッセージングステップ。
コードなし自動化ガイド
7stamp を Make に接続する — ステップバイステップ
実装ガイドMake を使用して、7stamp を CRM、POS、オンライン ショップ、スプレッドシート、メッセージング ツール、またはシナリオにデータを送信できるシステムに接続します。現在、本番環境に対応したルートは、7stamp API 通話には Make の HTTP アプリ、7stamp イベントの受信には Make の Custom webhook です。
Make のアプリピッカーには、公開されている 7stamp アプリがまだありません。待つ必要はありません。HTTP → Make a request を追加し、正確な URL、メソッド、Bearer ヘッダー、および以下の JSON を使用して、ソース モジュールからフィールドをマップします。これは、将来のコネクタが使用するものと同じ 7stamp Integration API です。
ワークフローに一致する最初のシナリオを選択します
1 つのイベントと 1 つの結果から始めます。テスト データが正しい場合は、フィルター、ルーター、CRM アップデート、およびその周りのフォローアップ メッセージを追加します。
有料注文後にスタンプを追加します
有料 POS または e コマース注文からシナリオをトリガーします。安定した顧客 ID と注文 ID をカードのスキャンにマッピングし、金額または明示的なスタンプ数を使用します。
報酬のフォローアップ
を送信する カード イベントで報酬またはバウチャーが報告されたら、シナリオを分岐します。CRM を更新し、チームに通知し、必要な場合にのみウォレット カードのプッシュまたは電子メールを送信します。
ネイティブ Make アプリなしでシステムを処理します。
Make の HTTP モジュールを使用して、7stamp を直接呼び出します。これは、カスタム POS、ERP、予約エンジン、または任意の API ファースト サービスにとって普遍的な選択肢です。
7stamp Make HTTP
から呼び出す操作を以下の各カードに追加しますHTTP → Make a request、メソッドと URL を示されているとおりに正確に設定します。すべてのリクエストに同じ Bearer キーを使用します。必要なマッピングにより、CRM、POS、または e コマース トリガーから何を提供するかが決まります。
Make トリガー
Webhooks → Custom webhook カードイベントを受け取る
Make で Custom webhook を作成し、その URL をコピーして、その URL を 7stamp プロファイル Webhook 設定に貼り付けます。これにより、7stamp が SCAN、REWARD_EARNED、または VOUCHER_ISSUED などのイベントを送信するとシナリオが開始されます。
- Make
- Webhooks → Custom webhook → 追加;わかりやすい名前を付けて、生成された URL をコピーします。
- 7stamp
- 管理者 → API & Integrations → Webhooks; URL を貼り付け、イベント タイプを選択して保存し、テスト イベントを作成します。
HTTP アクション
POST /cards/invite Card Invite
を作成します。新しい個人インストール URL と 1 つの外部連絡先の配信挿入コードを作成します。
- 必須
- external_id — 名前ではなく、厩舎 CRM/contact ID をマップします。
- 次に、
- を使用して、応答の install_url を電子メール、SMS、または CRM 更新ステップにマップします。
HTTP アクション
POST /cards/invite/bulk Card Invite を一括作成
1 つのリクエストで最大 100 個の招待リンクを作成します。無制限の連絡先エクスポートではなく、制御された移行またはキャンペーンに使用します。
- 必須の
- 項目 — 1 ～ 100 個の個別の招待リクエスト オブジェクトの JSON 配列。
- リンクを送信する前に、
- success_count、error_count、および各結果を確認してください。
HTTP アクション
GET /cards Find Cards
オプションのテンプレートフィルターとソースフィルターを使用して、External ID によってカードレコードを検索します。
- 必須
- クエリパラメータ external_id。
- オプションの
- external_source および template_id は、1 つのシステムに複数のプログラムがある場合に検索を絞り込みます。
HTTP アクション
GET /cards/{user_card_id} カードの詳細を取得する
前のステップが内部 User Card ID を返したときに、1 枚のカードの完全な状態を読み取ります。
- 必須
- {user_card_id} を、信頼できる 7stamp 応答によって返される内部 ID に置き換えます。
- Avoid
- を避けてください。別のプロフィールからカード ID を推測したり保存したりしないでください。
HTTP アクション
POST /cards/scan カードをスキャン
購入金額または明示的なカウントからスタンプを追加します。 User Card ID または External ID を受け入れ、外部注文参照を保持できます。
- ID
- external_id とオプションの external_source を使用します。両方供給された場合、user_card_id が勝ちます。
- 購入
- 金額ベースのカードの場合は金額を使用し、明示的な番号の場合は stamps_count を使用します。 stamps_countが優先されます。
- トレーサビリティ
- 支払い済みの注文/receiptからexternal_order_idをマップすると、7stampのイベントを照合できます。
HTTP アクション
GET /templates List Templates
API キーで使用できるカード テンプレートをリストします。これを使用して、接続をテストしたり、テンプレートを動的に選択したりできます。
- 最初のテスト
- これは最も安全な最初のリクエストです。本文はなく、顧客データは変更されません。
- 後でマップする
- プロファイルに複数のアクティブなテンプレートがある場合にのみ、アクティブなテンプレートの ID を template_id として使用します。
HTTP action
GET /templates/{template_id}/design Get Template Design
既知のテンプレートのビジュアルデザイン設定を返します。別のシステムが一貫したカードの選択肢を表示する必要がある場合に便利です。
HTTP アクション
POST /vouchers/issue バウチャーの発行
External ID または User Card ID で識別されるカード所有者にバウチャーを発行します。
- Required
- バウチャーが必要です。short_description。 external_id または既知の user_card_id のカードをターゲットにします。
- 有効期限
- validity_type を validity_value とともに使用するか、固定有効期限については OpenAPI のリファレンスをお読みください。
HTTP アクション
POST /messages/send メッセージの送信
構成されたチャネルと同意ルールに従って、ウォレット カード プッシュと /or 電子メールを通じてカード所有者にコンテンツを送信します。
- カードプッシュ
- card_push_text は 20 文字に制限されており、インストールされたウォレット パスが必要です。
- 電子メール
- 件名と本文を送信します。基本HTMLは本体でサポートされています。
Make モジュール
Full 7stamp endpoint URL HTTP → Make a request
これは、上記のすべての 7stamp ルートを呼び出す Make モジュールです。完全な URL を使用し、文書化されたメソッドを選択し、Bearer ヘッダーを追加し、ルートに本文が必要な場合にのみ JSON を使用します。
- ベース URL
- https://api.7loc.com/cards-api
- ヘッダー
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: POST リクエストの場合は application/json。
書かれたとおりに構築できる 3 つの Make シナリオ
以下の名前は、実際の Make モジュールです。最初のシナリオから始めて、それを使い捨ての連絡先に対して実行し、その後でルーター、フィルター、または運用スケジュールを追加します。
1. 新しい CRM 連絡先 → 7stamp カードリンクを送信
期待される結果: 顧客は、7stamp から返された install_url を受け取ります。あなたの CRM はその URL を同じ連絡先記録に保存できます。
- 1 シナリオを作成し、CRM の新規/Created 連絡先トリガーを追加します。 Kommo では、連絡先作成トリガーを選択し、それを 1 回実行してサンプル連絡先をロードします。
- 2 HTTP → Make a request を追加します。メソッドを POST に設定し、URL を https://api.7loc.com/cards-api/cards/invite.
- 3 に Authorization: Bearer YOUR_7STAMP_API_KEY と Content-Type: application/json を追加します。 JSON 本文で、CRM 連絡先 ID を external_id にマッピングし、external_source を kommo などの固定ラベルに設定します。
- 4 HTTP モジュールを 1 回実行します。出力に install_url、delivery_insert_code、external_id、template_id があることを確認します。
- 5 HTTP の後に email/SMS/CRM 更新モジュールを追加し、HTTP 出力から install_url をマップします。チームが後で再送信する必要がある場合は、URL を CRM 連絡先に保存してください。
リンクを送信する前に、: POST /cards/invite は常に新しい招待状を作成します。ビジネス ルールが既存の連絡先に対する別の招待を避けることである場合は、最初に Find Cards を使用します。
2. 有料注文 → ロイヤルティスタンプを追加
期待される結果: 成功したスキャン応答には、成功、scan_id、stamps_added、および次のステップのスキャン後のカード状態が含まれます。
- 1 POS/ecommerce 有料注文トリガーから開始します。 Make そのサンプルには安定した顧客 ID と注文/receipt ID が含まれていることを確認します。
- 2 HTTP → Make a request と POST https://api.7loc.com/cards-api/cards/scan および同じ Bearer ヘッダーを追加します。
- 3 顧客からのマップ external_id、システム名からの external_source、注文 ID からの external_order_id。金額ベースのカードの場合は金額を追加し、スタンプの明示的な数の場合は stamps_count を追加します。
- 4 Run once テストオーダーあり。シナリオ スケジュールを有効にする前に、返された成功フラグと stamps_added を確認してください。
- 5 オプションで、HTTP ステップの後にフィルターを追加します。成功が true の場合にのみ続行し、注文/CRM レコードに scan_id または stamps_added を書き込みます。
リンクを送信する前に、: 再試行時に同じ external_order_id を使用すると、後の Webhook イベントで順序を追跡できます。不明確な実行の失敗後にスタンプを 2 回付与しないでください。
3. 7stamp イベント → CRM
期待される結果: を更新 Make は、すぐに 7stamp イベントを受信し、external_id と external_source を介して一致する CRM レコードを見つけることができます。
- 1 別の Make シナリオを作成します。 Webhooks → Custom webhook を追加し、追加を選択し、7stamp-card-events という名前を付け、生成された URL をコピーします。
- 2 7stamp Admin で、API & Integrations → Webhooks を開きます。 URL を追加し、SCAN と REWARD_EARNED などの小さなイベントのセットを選択します。
- 3 7stamp で使い捨てテストスキャンまたはカードイベントを作成します。 Make に戻り、Run once を使用して、Make にイベントデータ構造を決定させます。
- 4 external_id を使用して CRM 検索ステップを追加します。 event_type にフィルターまたはルーターを追加して、SCAN、REWARD_EARNED、VOUCHER_ISSUED が異なるアクションを実行できるようにします。
- 5 CRM update/note アクションを追加します。選択したイベント タイプにこれらのフィールドが存在する場合にのみ、scanned_at、stamps_after、external_order_id、および issued_vouchers をマップします。
リンクを送信する前に、: Webhook URL を非公開にしておきます。取り消し不能なメッセージ、バウチャー、または CRM の変更をオンにする前に、実際のイベントをテストしてください。
Make
These are the exact 7stamp Admin screens. Create the key once, copy it into Make's secure HTTP connection/keychain, then immediately remove it from your clipboard.
構築する前に接続を準備します
環境ごとに 1 つの API キーを作成します
7stamp Admin で、API & Integrations → API Keys → Add API Key に移動します。オプションが使用可能な場合は、Make の HTTP API キー接続/keychain に値を保存します。キーをテキスト フィールドからマップしたり、メモに配置したり、ブラウザー対応のワークフローで使用したりしないでください。キーは 1 つの 7stamp ワークプレイス/profile.
安定した External ID
を使用します。 CRM、POS、またはコマース プラットフォームから不変の ID をマッピングします。 CRM ID または顧客 UUID にご連絡ください。同じ識別子が複数のシステムに表示される可能性がある場合は、hubspot、shopify、poster などの External Source を追加します。
どのテンプレートを適用するかを決定します。
接続されている 7stamp プロファイルにアクティブなカード テンプレートが 1 つある場合、テンプレートは空のままにすることができます。複数のテンプレートを使用して、意図的に template_id をマップまたは選択し、すべての招待とスキャンが目的のロイヤルティ プログラムに到達するようにします。
正確な Make HTTP セットアップ: 1 枚のカード招待状
これを自動化ステップにコピーします
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}を作成します。 最初の Make シナリオ
を構築してテストします。 7stamp Admin で、API & Integrations → API Keys → Add API Key にキーを作成します。アカウント設定で許可されている場合は、別のテスト プロファイル/key を使用してください。
Make で、シナリオを作成し、ソーストリガーを追加します。マッピングの前に一度実行すると、実際のサンプルの連絡先または支払い済みの注文を確認できます。
次のプラスをクリックし、HTTP を検索し、リクエスト Make を選択します。このページの操作カードからメソッド、フル URL、ヘッダーを設定します。
最初のリクエストとして GET https://api.7loc.com/cards-api/templates を使用します。成功した応答は、顧客データを変更せずにキーが機能することを証明します。
POST ルートの場合、application/json を選択し、このガイドから車体形状を貼り付けます。馬小屋 External ID をマップします。プロファイルに複数のアクティブなテンプレートがある場合にのみ、template_id を追加します。
使い捨て連絡先を使用して実行し、HTTP 出力を検査してから、その正確な応答フィールドを次の CRM、電子メール、またはメッセージング モジュールにマッピングします。
Make HTTP はいつ使用するべきですか?
7stamp には HTTP を使用してください。これは文書化された本番環境に対応したルートであり、縮小されたフォールバックではありません。 7stamp の操作、新しい API ルート、またはカスタムの POS/ERP 接続が必要な場合は、いつでも選択してください。 OpenAPI 参照は、メソッド、フルパス、本体、および応答スキーマの信頼できる情報源です。ベアラーキーとベース URL は同じままです。
Make
For an event-driven scenario, add Webhooks → Custom webhook and create a webhook. Copy its URL, open API & Integrations → Webhooks in the 7stamp profile, paste the URL, select the event types, save, and send a real test event. The 7stamp profile owns that subscription; the current API does not expose automatic webhook subscribe/unsubscribe endpoints.
パブリック Make コネクタは必要ありません
このページの手順では、すべての Make アカウントで利用できる Make モジュールを使用します。 HTTP ではなく将来のネイティブ 7stamp モジュールが必要な場合は、必要なワークフローをお送りください。それまでは、HTTP と Custom webhook で、文書化されたすべての 7stamp 操作がカバーされます。
よくある質問
Make で 7stamp が見つかりません。まだ自動化できますか?
はい。現在、Make には公開されている 7stamp アプリはありません。 HTTP > Make リクエストを追加し、完全な 7stamp エンドポイント URL を使用して、Authorization: Bearer に続いて 7stamp API キーを送信します。 HTTP は、文書化されたすべてのエンドポイントを呼び出すことができます。
Make 接続のトークンはどこで入手できますか?
7stamp Admin で、API Integrations を開き、次に API Keys、次に Add API Key を開きます。キーのスコープは、それを作成したワークプレイス/profile であるため、可能な限りテスト シナリオにはテスト プロファイルを使用してください。
どの識別子を External ID としてマッピングする必要がありますか?
ソース システムからの安定した識別子、できれば CRM 連絡先 ID または顧客 UUID を使用します。表示名は使用しないでください。電話番号やメールアドレスでも問題ありませんが、変更される可能性があるため、一貫して扱う必要があります。
7stamp イベントを Make に取り込むにはどうすればよいですか?
Make で Webhook > Custom webhook を作成し、生成された URL を 7stamp プロファイルの Webhook 設定に貼り付けます。受信した event_type を処理するには、配信後に Make フィルターまたはルーターを使用します。
次のステップ
最初のロイヤルティ アクションを自動化する準備はできましたか?
API キーを作成し、List Templates をテストし、使い捨て連絡先を使用して 1 つの招待またはスキャン シナリオを構築します。ルーターとメッセージングは、単純なフローが信頼できるようになってから追加してください。