CRM 連絡先
新規または適格な連絡先をトリガーとして招待を作成し、その CRM ID を External ID にマッピングし、カード招待を作成し、返されたインストール URL を電子メールまたは SMS ステップに渡します。
コードなしの自動化ガイド
7stamp を Zapier に接続します — ステップバイステップ
実装ガイドワークフローが明確なシーケンスである場合、Zapier を使用します。連絡先または注文が表示され、 7stamp がアクションを実行すると、別のビジネス ツールが更新されます。今日の安全なルートは、発信 7stamp API の場合は API Zapier まで、着信 7stamp のイベントの場合は Webhooks by Zapier → Catch Hook です。
Zapier のマーケットプレイスには公開されている 7stamp アプリがありません。可能な場合は API by Zapier → API Request を使用します。Zap ステップで公開するのではなく、静的な API キーをアプリ接続に保存します。 Webhooks by Zapier は、受信する Catch Hook イベントにのみ使用します。表示されている Webhook アクション フィールドに 7stamp Bearer キーを入力しないでください。
線形でテスト可能な Zap から開始
最初のザップは小さくしてください。連絡先からカード、または支払い済み注文からスタンプまでの信頼性の高いフローは、広範な双方向同期よりも優れた出発点です。
チェックアウト後にスタンプを追加します
支払い済みの注文またはクローズしたレシートからトリガーし、顧客 ID と注文 ID をマッピングし、注文金額または明示的なスタンプ数で Scan Card を使用します。
1 回限りのリカバリ バウチャーを発行する
CRM ルール、サポート イベント、またはセグメント エクスポートを使用して顧客を識別し、カードにバウチャーを発行し、正しいチャネルからフォローアップ メッセージを送信します。
CRM
にカード イベントを書き戻します。 Webhooks by Zapier > Catch Hook を使用して、7stamp カード イベントを受け取ります。返された External ID を CRM レコードと照合し、関連するメモ、タグ、またはタスクを追加します。
7stamp API から Zapier までに電話をかける操作
トリガーの後に API by Zapier → API Request を追加します。 7stamp API キー接続を 1 つ作成し、以下の正確な方法と完全な URL を選択します。各操作は、次の Zap ステップにマップできるフィールドを返します。
API による Zapier アクション
POST /cards/invite Card Invite を作成する
1 つの外部連絡先に対して、新しいウォレット カード インストール URL と配信挿入コードを作成します。
- 必須
- CRM/contactトリガーからのexternal_id。
- 次のステップ
- install_url を電子メール、SMS、または CRM フィールドにマッピングします。
API による Zapier アクション
POST /cards/invite/bulk Card Invite を一括作成
制御された JSON バッチから最大 100 個の招待リンクを作成します。
- 1 ～ 100 個の招待オブジェクトを含む必須の
- 項目の配列。
- チェック
- success_count、error_count、およびすべての結果を納品前に読んでください。
Zapier アクションによる API
POST /cards/scan Scan Card
User Card ID または External ID により、金額、スタンプ数、順序 ID、およびオプションでスタンプを追加します領収書のデータ。
- ID
- external_id とオプションの external_source;両方が存在する場合、user_card_id が勝ちます。
- スタンプルール
- stamps_count が金額より優先されます。
API Zapier アクション
POST /vouchers/issue Issue Voucher
カード所有者に直接バウチャーを発行します。
- 必須の
- バウチャー。short_description とターゲット external_id または既知の user_card_id。
- 結果
- unique_code、ステータス、または expires_at を CRM メモまたはメッセージにマップします。
API Zapier アクション
POST /messages/send Send Message
により、ウォレットカードのプッシュと/or 電子メールの内容がカード所有者に送信されます。
- カードプッシュ
- card_push_text は 20 文字に制限されています。
- 電子メール
- 件名と本文。結果は、配信がキューに入れられたかどうかを報告します。
Zapier アクションによる API
GET /cards Find Cards
オプションのソースフィルターとテンプレートフィルターを使用して、External ID によってカードレコードを検索します。
- クエリパラメータとして
- external_id が必要です。
- 最初に使用します
- ルールで招待の重複が回避される場合は、招待を作成する前に使用します。
によりカード詳細
GET /cards/{user_card_id} Get Card Detail
Reads the state of a card by its 7stamp internal ID.
- 必須
- {user_card_id} を、7stamp によって返される ID に置き換えます。
- 有用な出力
- stamps_count、ウォレットの状態、および active_vouchers_count。
Zapier アクションによる API
GET /templates List Templates
接続されたプロファイルで使用可能なテンプレートをリストし、API 接続を検証します。
- 最初のテスト
- 書き込みアクションの前に呼び出します。顧客データは変更されません。
- 後で使用します
- 複数のテンプレートが存在する場合、アクティブ ID は template_id になります。
Zapier アクション
GET /templates/{template_id}/design Get Template Design
Retrieves a template's design settings for a known template ID.
Zapier トリガー
Webhooks by Zapier → Catch Hook カードイベント
Catch Hook は、Zapier に固有の HTTPS URL を与えます。 7stamp Admin の Webhook 設定に貼り付けて、実際のカード イベントでテストします。
- Zapier
- 解析されたイベント データには Catch Hook を使用します。 Catch Raw Hook は、生のリクエスト ヘッダー/body. も必要な場合にのみ使用してください。
- Match
- と一致します。イベントから external_id とオプションの external_source を使用して、CRM 連絡先を見つけます。
段階的に構築できる 3 つの Zapier ワークフロー
各シナリオでは、現在利用可能な実際の Zapier モジュールを使用します。まず小さなルートを 1 つ構築し、Zap をオンにする前に使い捨てコンタクトでテストします。
1. 認定された CRM 連絡先 → カードの発行
期待される結果: 次の Zap ステップは install_url を受け取り、顧客に送信するか、CRM レコードに書き戻すことができます。
- 1 Zap を作成し、連絡先がロイヤルティの資格があることを意味する CRM イベントを選択します。トリガーをテストし、連絡先の不変 ID があることを確認します。
- 2 API by Zapier → API Request を追加します。 7stamp API キー接続を作成または選択し、POST を選択し、URL を https://api.7loc.com/cards-api/cards/invite. に設定します。
- 3 本体を JSON に設定します。 CRM ID を external_id にマッピングし、kommo などの固定の external_source を設定し、複数の 7stamp テンプレートがアクティブな場合にのみ template_id を追加します。
- 4 アクションをテストします。応答に同じ external_id に対する install_url と delivery_insert_code が含まれていることを確認します。
- 5 CRM 更新、メール、または SMS アクションを追加します。 API 応答からの install_url をマップします。テスト URL をハードコードしたりコピーしたりしないでください。
リンクを送信する前に、: Card Invite を作成すると、常に新しい招待状が返されます。ポリシーが連絡先ごとに 1 つの招待である場合は、まず Find Cards リクエストまたは Zapier フィルターを追加します。
2. 支払い済みの注文 → 特典スタンプ
期待される結果: 注文により追跡可能な 7stamp スキャンが作成され、Zap はソース システムに stamps_added または scan_id を記録できます。
- 1 有料注文/Closed 受信トリガーを使用してテストします。続行する前に、顧客 ID と固有の注文 ID の両方が存在していることを確認してください。
- 2 API by Zapier → API Request と POST https://api.7loc.com/cards-api/cards/scan を追加し、同じ 7stamp 接続を選択します。
- 3 JSON に、external_id、external_source、external_order_id、および金額ベースのテンプレートの場合は金額を、明示的なスタンプ特典の場合は stamps_count を付けて送信します。
- 4 使い捨ての注文でテストします。応答内の成功、scan_id、および stamps_added を検査します。
- 5 成功した応答後にのみ継続するフィルターを追加し、確認された結果で order/CRM を更新します。
リンクを送信する前に、: ザップが再生される場合は、別のスキャンを送信する前に元の順序を確認してください。後でイベントを調整できるように、external_order_id を安定させてください。
3. 7stamp イベント → CRM メモまたはタスクを作成
期待される結果: Zapier は、解析された 7stamp イベントを受け取り、external_id によって顧客を見つけ、適切なフォローアップを作成します。
- 1 Webhooks by Zapierをトリガーとして新しいザップを作成します。 Catch Hook を選択して続行し、テストステップに示されている一意の URL をコピーします。
- 2 7stamp Admin で、API & Integrations → Webhooks を開き、Catch Hook URL を追加し、必要なイベントタイプのみを選択して保存します。
- 3 実際のテストスキャンまたはカードイベントを発生させます。 Zapier に戻り、Test trigger をクリックして、event_type、external_id、および external_source がサンプル フィールドとして到着することを確認します。
- 4 external_id を使用して、CRM 連絡先を検索アクションを追加します。 event_type にフィルターまたはパス ルールを追加します。たとえば、SCAN を REWARD_EARNED から分離します。
- 5 CRM ノート/task を作成し、scanned_at、stamps_after、external_order_id、issued_vouchers など、そのイベントに存在するフィールドのみをマップします。
リンクを送信する前に、: Catch Hook URL は秘密です。 Zap が別の所有者に譲渡された場合は、それに依存する前に、7stamp Admin の URL を更新してください。
Zap
These are the 7stamp-side steps. Do this once, then use the key only inside the API by Zapier connection—not in a Webhooks by Zapier action field or a note.
データの不一致を防ぐ接続ルール
Zapier 接続
In 7stamp Admin, choose API & Integrations → API Keys → Add API Key. In API by Zapier, create an API-key connection with a static Authorization header containing Bearer followed by that key. API by Zapier keeps the credential in the connection instead of a visible Zap step; restrict access to the connection and rotate the key if it is exposed.
External ID と External Source を一貫してマップする
External ID は独自の安定した顧客 ID です。 External Source は、Hubspot、bitrix24、shopify、poster など、発信元のラベルを付けます。作成、検索、スキャン、バウチャー、および Webhook フローには同じペアを使用します。
どのカード ID が勝つかを知る
カードを対象としたアクションは、User Card ID または External ID を受け入れます。両方が存在する場合は、User Card ID が優先されます。内部 ID は、信頼できる 7stamp ステップによって返された後にのみ使用してください。それ以外の場合は、ソース システム External ID を優先します。
Zapier による正確な API リクエスト: スタンプ 1 つを獲得
これを自動化ステップにコピーします
http Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Data:
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"stamps_count": 1,
"external_order_id": "order_2048"
}最初のザップを構築します
管理者で 7stamp API キーを作成します: API & Integrations → API Keys → Add API Key。利用可能な場合は、別のテスト キー/profile を使用してください。
Zapier で、Zap を作成し、ソース トリガーをテストします。連絡先 ID、顧客 ID、注文 ID、および金額をマッピングに使用できるように、実際のサンプルを使用します。
API by Zapier → API Request を追加します。シークレットを Webhooks by Zapier アクションフィールドに入れるのではなく、静的 Bearer Authorization ヘッダーの 7stamp 接続を作成します。
まずはGET https://api.7loc.com/cards-api/templates に電話してください。これにより、キーが機能することが確認され、顧客データを変更せずに使用できるアクティブなテンプレート ID が表示されます。
POST /cards/invite または POST /cards/scan を選択し、ボディタイプとして JSON を設定し、安定した External ID と関連するテンプレート/order フィールドをトリガーからマップします。
使い捨て連絡先を使用してアクションを実行し、その正確な応答フィールドを検査して、Zap を公開する前にそれらのフィールドを次の CRM、電子メール、またはメッセージングのステップにマップします。
文書化されたルートにのみユニバーサル リクエストを使用します。
Bearer API キーを持つ 7stamp リクエストには、Zapier による API を使用します。アプリ接続で静的ヘッダー キーを保持します。 Webhooks by Zapier は、7stamp シークレットの優先場所としてではなく、Catch Hook イベント配信に使用します。ベース URL を https://api.7loc.com/cards-api, に保ち、正確なスキーマについてはパブリック OpenAPI 参照を使用し、資格情報や顧客データを未検証の URL に送信しないでください。
Catch Hook を通じて7stamp イベントを受信します
Webhooks by Zapier → Catch Hook を作成し、テスト設定に表示されている一意の URL をコピーし、7stamp プロファイルの Webhook 設定に貼り付け、イベント タイプを選択し、実際のテスト スキャンまたはカードを送信しますイベント。イベント ペイロードの External ID と External Source を使用して、正しい CRM 連絡先を見つけます。解析されていない本文とリクエスト ヘッダーが特に必要な場合にのみ、Catch Raw Hook を選択してください。
安全な Zapier ルートを今すぐ使用してください。
API by 53⟧ と Catch Hook は、すべての公開 7stamp API 操作とカード イベントに十分です。将来のネイティブ 7stamp Zapier アプリが必要な場合は、チームが最もよく使用するアクション/trigger を正確に送信してください。
よくある質問
Zapier の 7stamp アプリはどこで見つかりますか?
現在、公開されている 7stamp マーケットプレイス アプリはありません。 7stamp API 通話には API by Zapier → API Request を使用し、7stamp イベントの受信には Webhooks by Zapier → Catch Hook を使用します。
Zapier トークンはどこで作成すればよいですか?
Admin の API & Integrations → API Keys → Add API Key の下に 7stamp API キーを作成します。表示される Webhooks by Zapier アクション フィールドではなく、API by Zapier 接続の静的 Bearer Authorization ヘッダーとして保存します。
Zapier はスタンプやバウチャーイベントを受け取るにはどうすればよいですか?
Webhooks by Zapier で Catch Hook を作成し、生成された URL を 7stamp プロファイルの Webhook 設定に貼り付け、イベントを選択して、CRM 更新を有効にする前にテストイベントを送信します。
Zapier と Make のどちらを選択すればよいでしょうか?
ほぼ直線的なトリガーアクションワークフローの場合は、Zapier を選択します。ルーター、複雑な変換、または長い複数ブランチのシナリオが必要な場合は、Make を選択してください。どちらも同じ 7stamp API キーとエンドポイントを使用します。
次のステップ
テストコンタクト
を使用して最初の Zap を構築する API キーを作成し、GET /templates から API をテストするZapier までに、連絡先からカードへ、または注文からスタンプへのアクションを 1 つ作成します。アウトバウンドフローのテスト結果が証明されたら、Catch Hook を追加します。