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

7stamp هوک های وب

موجود است

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

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

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

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

تاریخچه وفاداری را در 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
{
  "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"
}

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

01

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

02

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

03

نقطه پایانی URL را اضافه کنید و فقط انواع رویدادهایی را انتخاب کنید که جریان کاری دریافت کننده واقعاً به آن نیاز دارد.

04

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

05

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

06

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

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

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

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

از بخش Webhooks مرجع عمومی OpenAPI به‌عنوان منبع طرح و مفهوم فیلد بار فعلی استفاده کنید. به HTTPS نیاز دارید، گیرنده URL را از گزارش‌های عمومی دور نگه دارید و پردازش را بی‌توان کنید. قبل از اجرای نام سرصفحه خاص یا خط‌مشی امتحان مجدد در تولید، رویه درخواست تأیید اعتبار /signature را برای نمایه 7stamp خود در حین ورود تأیید کنید.

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

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

بله. انواع رویدادها را در تنظیمات هوک نمایه 7stamp انتخاب کنید تا گیرنده فقط رویدادهایی را که برای گردش کارش مهم هستند دریافت کند.

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

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

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

از External ID و در صورت وجود از External Source استفاده کنید. اینها شناسه هایی هستند که ادغام شما هنگام ایجاد یا اسکن کارت ارائه کرده است.

آیا باید سرصفحه امضا را در نظر بگیرم یا زمان‌بندی را دوباره امتحان کنم؟

خیر. از قرارداد تحویل فعلی OpenAPI/profile استفاده کنید و قبل از کدنویسی یک سرصفحه یا فرضیه امتحان مجدد، مراحل احراز هویت را برای نمایه خود در حین ورود تأیید کنید.

مرحله بعدی

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

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