ادغام توسعه دهندگان

7Stamp هوک های وب

موجود است

هر رویداد وفاداری را از 7Stamp به سیستم‌های خود در زمان واقعی انتقال دهید. بدون نظرسنجی و بدون تماس برنامه ریزی شده API. رویدادها با درخواست HTTPS POST در عرض چند ثانیه پس از وقوع می‌رسند.

از وب‌قلاب‌ها استفاده کنید تا CRM، ERP یا باطن سفارشی خود را با آنچه در طرف وفاداری اتفاق می‌افتد هماهنگ نگه دارید: چه کسی ملحق شد، چه کسی یک تمبر دریافت کرد، چه کسی یک کوپن استفاده کرد، چه کسی یک هدیه تولد ایجاد کرد، و چه کسی غیرفعال شد. سپس سیستم شما تصمیم می گیرد که با آن داده ها چه کاری انجام دهد.

مرجع API را باز کنید باز کردن 7Stamp Admin

کارهایی که می توانید با وب هوک ها انجام دهید

وب هوک ها سمت بیرونی پشته یکپارچه سازی هستند. آنها فعالیت مشتری و پاداش را در سیستم هایی که قبلاً برای فروش، خدمات، تجزیه و تحلیل و پیام به آنها اعتماد دارید، منعکس می کنند.

تاریخچه وفاداری را در CRM خود منعکس کنید

هر تمبر، کوپن، تولد و عدم فعالیت در رکورد مشتری در CRM شما ثبت می‌شود. جدول زمانی کامل وفاداری را در کنار فروش، تماس‌ها و بلیت‌ها بدون ورود به 7Stamp مشاهده می‌کنید.

پشته پیام خود را فعال کنید

وقتی مشتری کوپنی را پس‌خرید می‌کند، یک تشکر 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 — یک مشتری کارت را از کیف پول خود خارج کرد.

یک گیرنده وب هوک ایمن بسازید

پس از دست زدن با دوام تصدیق کنید

نقطه پایانی شما باید HTTPS POST را بپذیرد، شکل درخواست را تأیید کند، رویداد را ادامه دهد یا در صف قرار دهد، سپس یک پاسخ موفق 2xx را برگرداند. اگر می‌توان با خیال راحت در صف قرار گرفت، قبل از تأیید تماس آهسته CRM یا پیام‌رسانی نکنید.

همبستگی با External ID

هر رویداد مرتبط می‌تواند دارای External ID و اختیاری External Source باشد که هنگام ایجاد یا اسکن کارت استفاده کردید. از این جفت برای به‌روزرسانی CRM، POS خود استفاده کنید، یا بدون حدس زدن از نام یا ایمیل، رکورد سفارش دهید.

Make تحویل ناتوان

قبل از ایجاد عوارض جانبی، یک کلید پردازشی بادوام یا اثر انگشت رویداد ذخیره کنید. اگر گیرنده شما دوباره همان تحویل را مشاهده کرد، نباید یادداشت، کوپن یا پیام تکراری CRM اضافه کند. نقطه پایانی URL را به عنوان یک راز در نظر بگیرید.

مثال شکل بارگذاری رویداد

این را در مرحله اتوماسیون خود کپی کنید json

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

پیکربندی و آزمایش یک وب هوک

یک نقطه پایانی HTTPS در باطن خود ایجاد کنید، CRM 🦠 لایه یکپارچه سازی30، ⟦ webhook Zapier Catch Hook. Make مطمئن شوید که مقصد را قبل از کپی کردن URL کنترل می‌کنید.

در 7Stamp Admin، Stamp Cards → API & Integrations → Webhooks را باز کنید.

URL نقطهٔ پایانی را اضافه کنید. وب‌هوک همهٔ رویدادهای کارت نمایه را دریافت می‌کند، پس در گیرندهٔ خود بر اساس data.event_type فیلتر کنید.

تنظیمات نمایه را ذخیره کنید، سپس یک اسکن آزمایشی یکبار مصرف یا عملکرد کارت را برای ایجاد یک رویداد فعال کنید.

محموله دریافتی را بازرسی کنید. External ID و External Source را با رکورد مورد انتظار مطابقت دهید و تأیید کنید که گیرنده یک پاسخ موفقیت آمیز را نشان می دهد.

CRM، کوپن، یا عوارض جانبی پیام را فقط پس از کنترل و نظارت ایمن برای بازپخش خرابی فعال کنید.

گزینه های بدون کد: Make و Zapier

در Make، از Webhooks → Custom webhook برای ایجاد یک گیرنده URL استفاده کنید و آن را در نمایه 7Stamp جای‌گذاری کنید. در Zapier، برای همین منظور از Webhooks by Zapier → Catch Hook استفاده کنید. نمایه 7Stamp مالک اشتراک است زیرا API کنونی نقاط پایانی ثبت وب‌قلاب خودکار را نشان نمی‌دهد.

امنیت و قرارداد تحویل

از بخش Webhooks در مرجع عمومی OpenAPI به‌عنوان منبع طرح‌وارهٔ فعلی محتوای ارسالی استفاده کنید. بدنه یک پاکت است: profile_id و profile_name نمایهٔ 7Stamp را مشخص می‌کنند، event_id رویداد را شناسایی می‌کند و خودِ رویداد کارت در data قرار دارد (برای URL مربوط به Make یا Zapier، کلید card_event است). هر تحویل در یک سرآیند امضا می‌شود، X-Webhook-Signature: t=…,s=…. HMAC-SHA256 را با کلید محرمانهٔ وب‌هوک خود روی t به‌علاوهٔ بدنهٔ خام درخواست محاسبه کنید، آن را به‌صورت هگزادسیمال کدگذاری کنید و با s مقایسه کنید؛ کلید محرمانه در صفحهٔ وب‌هوک در 7Stamp Admin قرار دارد. برای کنار گذاشتن تحویل‌های تکراری از X-Webhook-Event-Id استفاده کنید: تلاش مجدد دوباره با یک t جدید امضا می‌شود. همچنین می‌توانید نقطهٔ پایانی را با Basic Auth محافظت کنید. HTTPS را الزامی کنید و URL گیرنده را از لاگ‌های عمومی دور نگه دارید.

سوالات متداول

آیا می توانم فقط رویدادهای وب هوک خاصی را انتخاب کنم؟

خیر. وب‌هوک 7Stamp همهٔ رویدادهای کارت نمایه را دریافت می‌کند. در گیرندهٔ خود بر اساس data.event_type فیلتر کنید؛ در Make و Zapier رویداد زیر card_event می‌آید، پس بر اساس card_event.event_type فیلتر کنید.

چگونه وب هوک ها را به Make یا Zapier متصل کنم؟

وب هوک دریافتی را در Make یا یک Catch Hook در Zapier ایجاد کنید، URL ایجاد شده را کپی کنید، سپس آن را در تنظیمات ⟦30415 test webhook جای‌گذاری کنید.

چگونه باید یک رویداد را با مخاطب CRM خود مطابقت دهم؟

از data.external_id و در صورت وجود از data.external_source استفاده کنید: این دو در هر وب‌هوک برای کارت‌هایی که از طریق API با شناسهٔ خودتان صادر کرده‌اید برگردانده می‌شوند. مشتری‌ای که خودش کارت را گرفته External ID ندارد، پس او را با data.user.email تطبیق دهید. نشانی «Hide My Email» از Apple یک نشانی بازارسال است، نه نشانی‌ای که در CRM شما ثبت شده است.

چطور بررسی کنم که یک وب‌هوک از طرف 7Stamp آمده است؟

سرآیند X-Webhook-Signature را به t و s تقسیم کنید، HMAC-SHA256 را با کلید محرمانهٔ وب‌هوک از 7Stamp Admin روی t به‌علاوهٔ بدنهٔ خام درخواست محاسبه کنید، آن را به‌صورت هگزادسیمال کدگذاری کنید و با s مقایسه کنید. t را دقیقاً همان‌طور که ارسال شده و بدنه را به‌صورت بایت‌های خام دریافتی، پیش از هرگونه تجزیهٔ JSON، در نظر بگیرید. تحویلی را که X-Webhook-Event-Id آن را قبلاً پردازش کرده‌اید کنار بگذارید: تلاش مجدد دوباره با یک t جدید امضا می‌شود.

صفحات مرتبط

باز API مرجع Make راهنما Zapier guide ⟧27⟧ 27⟧30

مرحله بعدی

آماده ارسال اولین رویداد کارت هستید؟

یک گیرنده ایجاد کنید، HTTPS URL آن را در نمایه بچسبانید، یک اسکن یکبار مصرف را اجرا کنید و قبل از فعال کردن اتوماسیون پایین دست، External ID مطابق را تأیید کنید.

باز کردن 7Stamp Admin مرجع API را بخوانید