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

اتصال 7stamp به Make — مرحله به مرحله

راهنمای پیاده سازی

از Make برای اتصال 7stamp با CRM، POS، فروشگاه آنلاین، صفحه گسترده، ابزار پیام‌رسانی یا هر سیستمی که می‌تواند داده‌ها را به یک سناریو ارسال کند، استفاده کنید. مسیر آماده تولید امروز برنامه Make HTTP برای 7stamp API تماس و Make Custom webhook برای رویدادهای 7stamp ورودی است.

هنوز هیچ برنامه عمومی 7stamp در انتخابگر برنامه Make وجود ندارد. منتظر یکی نباشید: HTTP → Make a request را اضافه کنید، از روش دقیق URL، متد، هدر Bearer و JSON در زیر استفاده کنید، سپس فیلدها را از ماژول منبع خود ترسیم کنید. این همان 7stamp Integration API کانکتور آینده است.

فیلترها و روترها 99999 Make باز API مرجع

اولین سناریویی را انتخاب کنید که با گردش کار شما مطابقت دارد

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

بعد از یک مخاطب جدید CRM یک کارت ایجاد کنید

از مخاطب CRM ID به عنوان External ID استفاده کنید، یک External ID ارسال کنید، یک ⟦3001 دعوت نامه ارسال کنید، سپس یک کارت ⟦300 ارسال کنید. URL از طریق ایمیل معمولی، SMS یا مرحله پیام رسانی.

پس از سفارش پولی تمبر اضافه کنید

سناریو را از یک سفارش پرداختی POS یا تجارت الکترونیک فعال کنید. مشتری ثابت خود را به شماره ID ترسیم کنید و ID را در اسکن کارت سفارش دهید، سپس از مقدار یا تعداد مهر صریح استفاده کنید.

ارسال پاداش پیگیری

هنگامی که یک رویداد کارت پاداش یا کوپن را گزارش می‌کند، سناریو را منشعب کنید: CRM را به‌روزرسانی کنید، تیم را مطلع کنید، و فقط در صورت نیاز، یک فشار کارت کیف پول یا ایمیل ارسال کنید.

سیستمی را بدون برنامه بومی Make

اداره کنید از ماژول Make HTTP برای تماس مستقیم با 7stamp استفاده کنید. این انتخاب جهانی برای یک POS، ERP، موتور رزرو، یا هر سرویس اول API است.

7stamp عملیات برای تماس از Make HTTP

برای هر کارت زیر، HTTP → Make a request را اضافه کنید، سپس روش و URL را دقیقاً مطابق شکل تنظیم کنید. برای هر درخواست از همان کلید Bearer استفاده کنید. نقشه‌برداری مورد نیاز به شما می‌گوید چه چیزی را از راه‌انداز CRM، POS یا تجارت الکترونیک خود تهیه کنید.

ماشه Make Webhooks → Custom webhook

یک رویداد کارت دریافت کنید

یک Custom webhook در Make ایجاد کنید، URL آن را کپی کنید، سپس آن URL را در نمایه ⟦30092. زمانی که 7stamp رویدادی مانند SCAN، REWARD_EARNED، یا VOUCHER_ISSUED ارسال می‌کند، یک سناریو شروع می‌شود.

در Make: Webhooks → Custom webhook → افزودن؛ یک نام واضح به آن بدهید و URL تولید شده آن را کپی کنید.
در 7stamp: Admin → API & Integrations → Webhooks; URL را جایگذاری کنید، انواع رویداد را انتخاب کنید، ذخیره کنید، سپس یک رویداد آزمایشی ایجاد کنید.

HTTP اقدام POST /cards/invite

ایجاد Card Invite

یک نصب شخصی جدید URL و کد تحویل-درج برای یک مخاطب خارجی ایجاد می‌کند.

الزامی: external_id — استبل خود را نقشه برداری کنید CRM/contact ID، نه نام.
سپس از: نقشه install_url از پاسخ در ایمیل خود، SMS، یا CRM مرحله به‌روزرسانی استفاده کنید.

HTTP اقدام POST /cards/invite/bulk

ایجاد انبوه Card Invites

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

مورد نیاز: — آرایه ای JSON از 1 تا 100 شی درخواست دعوت فردی.
Check: را بررسی کنید success_count، error_count و هر نتیجه را قبل از ارسال هر پیوندی بخوانید.

HTTP اقدام GET /cards

Find Cards

سوابق کارت را با External ID، با الگوی اختیاری و فیلترهای منبع پیدا می‌کند.

مورد نیاز: پارامتر پرس و جو external_id.
اختیاری: external_source و template_id زمانی که یک سیستم چندین برنامه دارد جستجو را محدود می‌کند.

عمل HTTP GET /cards/{user_card_id}

جزئیات کارت را دریافت کنید

وضعیت کامل یک کارت را زمانی که مرحله قبلی User Card ID داخلی خود را برگرداند، می‌خواند.

الزامی: {user_card_id} را با ID داخلی که توسط یک پاسخ مطمئن 7stamp بازگردانده شده است جایگزین کنید.
اجتناب کنید: کارت ID را از نمایه دیگری حدس نزنید یا ذخیره نکنید.

HTTP اقدام POST /cards/scan

اسکن کارت

از مبلغ خرید یا تعداد صریح تمبر اضافه می‌کند. User Card ID یا External ID را می‌پذیرد و می‌تواند مرجع سفارش خارجی را حفظ کند.

هویت: استفاده از external_id و اختیاری external_source؛ user_card_id در صورت ارائه هر دو برنده است.
خرید: استفاده از مبلغ برای کارت‌های مبتنی بر مبلغ یا stamps_count برای شماره صریح؛ stamps_count اولویت دارد.
قابلیت ردیابی: نقشه external_order_id از سفارش پرداخت شده/receipt تا بتوان رویدادهای 7stamp را با هم مطابقت داد.

HTTP اقدام GET /templates

List Templates

الگوهای کارت موجود در کلید API را فهرست می‌کند. از آن برای آزمایش اتصال یا انتخاب یک الگو به صورت پویا استفاده کنید.

اولین تست: این امن‌ترین درخواست اول است: بدنه ندارد و داده‌های مشتری را تغییر نمی‌دهد.
نقشه بعداً: از شناسه یک الگوی فعال به عنوان template_id فقط زمانی استفاده کنید که نمایه بیش از یک الگوی فعال داشته باشد.

HTTP اقدام GET /templates/{template_id}/design

Get Template Design

تنظیمات طراحی بصری یک الگوی شناخته شده را برمی‌گرداند، زمانی که سیستم دیگری نیاز به نمایش یک انتخاب کارت ثابت دارد، مفید است.

HTTP اقدام POST /vouchers/issue

صدور کوپن

برای صاحب کارت شناسایی شده توسط External ID یا User Card ID کوپن صادر می‌کند.

کوپن: الزامی است.short_description. کارت را با external_id یا user_card_id شناخته شده هدف قرار دهید.
اعتبار: از validity_type با validity_value استفاده کنید، یا برای تاریخ انقضای ثابت، مرجع ⟦30154 را بخوانید.

HTTP اقدام POST /messages/send

پیام ارسال کنید

محتوا را از طریق فشار کیف پول کارت و /or ایمیل، با توجه به قوانین پیکربندی شده و رضایت، برای صاحب کارت ارسال می‌کند.

فشار کارت: card_push_text به 20 کاراکتر محدود شده است و به پاس کیف پول نصب شده نیاز دارد.
ایمیل: ارسال موضوع به اضافه متن؛ پایه HTML در بدنه پشتیبانی می شود.

Make ماژول Full 7stamp endpoint URL

HTTP → Make a request

این ماژول Make است که هر مسیر بالای 7stamp را فراخوانی می‌کند. از یک URL کامل استفاده کنید، روش مستند شده را انتخاب کنید، سربرگ Bearer را اضافه کنید و فقط زمانی که مسیر به بدنه نیاز دارد از ⟦30166 استفاده کنید.

پایه URL: https://api.7loc.com/cards-api
سربرگ: Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json برای POST درخواست.

سه سناریو Make که می‌توانید دقیقاً همانطور که نوشته شده است بسازید

نام‌های زیر ماژول‌های واقعی ⟦30214 هستند. با سناریوی اول شروع کنید، آن را در مقابل یک مخاطب یکبار مصرف اجرا کنید و تنها پس از آن روترها، فیلترها یا زمان‌بندی تولید را اضافه کنید.

1. مخاطب جدید CRM ← ارسال پیوند کارت 7stamp

نتیجه مورد انتظار: مشتری install_url را دریافت می‌کند که توسط 7stamp بازگردانده شده است. CRM شما می تواند آن URL را در همان سابقه تماس نگه دارد.

1 یک سناریو ایجاد کنید و ماشه تماس CRM جدید/Created خود را اضافه کنید. برای Kommo، ماشه ایجاد مخاطب را انتخاب کنید و یک بار آن را اجرا کنید تا یک مخاطب نمونه بارگیری شود.
2 HTTP → Make a request را اضافه کنید. متد را بر روی POST و URL به https://api.7loc.com/cards-api/cards/invite.
3 اضافه کنید: Authorization: Content-Type: application/json. در بدنه JSON، مخاطب CRM ID را در external_id نگاشت کنید و external_source را روی یک برچسب ثابت مانند kommo تنظیم کنید.
4 ماژول HTTP را یک بار اجرا کنید. تأیید کنید که خروجی install_url، delivery_insert_code، external_id و template_id باشد.
5 ایمیل/SMS/CRM ماژول بروزرسانی را بعد از HTTP اضافه کنید و از خروجی HTTP نقشه install_url را اضافه کنید. اگر تیم باید بعداً آن را دوباره ارسال کند، URL را در مخاطب CRM ذخیره کنید.

Check: 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 از نام سیستم و external_order_id از سفارش ID. مبلغ را برای کارت‌های مبتنی بر مبلغ اضافه کنید، یا برای تعداد صریح تمبر stamps_count.
4 Run once با سفارش تست. قبل از فعال کردن زمان‌بندی سناریو، پرچم موفقیت بازگشتی و stamps_added را بررسی کنید.
5 به صورت اختیاری پس از مرحله HTTP یک فیلتر اضافه کنید: فقط زمانی ادامه دهید که موفقیت درست باشد، سپس scan_id یا stamps_added را به رکورد/CRM بنویسید.

Check: از همان external_order_id در تلاش‌های مجدد استفاده کنید تا بتوان ترتیب را در رویدادهای وب‌هوک بعدی ردیابی کرد. پس از اجرای نامشخص دوبار تمبر اهدا نکنید.

3. 7stamp رویداد → به روز رسانی CRM

نتیجه مورد انتظار: Make رویداد 7stamp را فوراً دریافت می‌کند و می‌تواند رکورد منطبق ⟦3028⟦2 را پیدا کند. external_id و external_source.

1 یک سناریوی Make جداگانه ایجاد کنید. Webhooks → Custom webhook را اضافه کنید، Add را انتخاب کنید، نام آن را 7stamp-card-events بگذارید و URL ایجاد شده را کپی کنید.
2 در 7stamp Admin، API & Integrations → Webhooks را باز کنید. آن URL را اضافه کنید و مجموعه کوچکی از رویدادها را انتخاب کنید، برای مثال SCAN و REWARD_EARNED.
3 یک اسکن آزمایشی یکبار مصرف یا رویداد کارت در 7stamp ایجاد کنید. به Make برگردید و از Run once استفاده کنید تا به ⟦30297 اجازه دهید ساختار داده رویداد را تعیین کند.
4 با استفاده از external_id مرحله جستجوی CRM را اضافه کنید. یک فیلتر یا روتر در event_type اضافه کنید تا SCAN، REWARD_EARNED و VOUCHER_ISSUED بتوانند اقدامات متفاوتی انجام دهند.
5 اقدام به روز رسانی CRM/note را اضافه کنید. نقشه scanned_at، stamps_after، external_order_id، و issued_vouchers فقط زمانی که آن فیلدها برای نوع رویداد انتخاب شده وجود داشته باشند.

Check: وب هوک URL را خصوصی نگه دارید. قبل از روشن کردن پیام‌ها، کوپن‌ها، یا تغییرات CRM، یک رویداد واقعی را آزمایش کنید.

کلید 7stamp API را قبل از باز کردن Make دریافت کنید

اینها صفحه نمایش های دقیق 7stamp Admin هستند. کلید را یک بار ایجاد کنید، آن را در HTTP اتصال امن HTTP/keychain کپی کنید، سپس فورا آن را از کلیپ بورد خود حذف کنید.

7stamp Admin API و صفحه ادغام با لیست API Keys و کنترل Add API Key — در 7stamp Admin، API & Integrations، سپس **API Keys** را باز کرده و **Add API Key** را انتخاب کنید.

گفتگوی کلید جدید 7stamp API با کنترل کپی قابل مشاهده است — کلید را فقط در یک اتصال امن Make HTTP/keychain. کپی کنید و در صورت فاش شدن آن را بچرخانید.

قبل از ساخت، اتصال را آماده کنید

برای هر محیط یک کلید API ایجاد کنید

در 7stamp Admin، به API & Integrations → API Keys → Add API Key بروید. هنگامی که آن گزینه در دسترس است، مقدار را در HTTP API کلید اتصال/keychain ذخیره کنید. هرگز کلید را از یک فیلد متنی ترسیم نکنید، آن را در یک یادداشت قرار ندهید، یا از آن در یک گردش کاری رو به مرورگر استفاده نکنید. یک کلید متعلق به یک 7stamp محل کار/profile. است

از یک پایدار External ID استفاده کنید

ID تغییرناپذیر را از پلتفرم CRM، POS یا تجارت خود ترسیم کنید—به عنوان مثال یک مخاطب CRM ID یا مشتری UUID. وقتی شناسه یکسان در بیش از یک سیستم ظاهر می‌شود، External Source مانند hubspot، shopify یا پوستر را اضافه کنید.

تصمیم بگیرید که کدام الگو اعمال می شود

وقتی نمایه 7stamp متصل دارای یک الگوی کارت فعال باشد، می‌توان الگو را خالی گذاشت. با الگوهای متعدد، نقشه template_id را عمداً انتخاب کنید تا هر دعوت و اسکن به برنامه وفاداری مورد نظر برسد.

تنظیم دقیق Make HTTP: یک دعوت کارت ایجاد کنید

این را در مرحله اتوماسیون خود کپی کنید 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

خود را در ⟦30316 در ⟦30316 در 1▧ بسازید و آزمایش کنید. زمانی که راه‌اندازی حساب شما اجازه می‌دهد، از یک نمایه آزمایشی جداگانه/key استفاده کنید.

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

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

از GET https://api.7loc.com/cards-api/templates به عنوان اولین درخواست استفاده کنید. پاسخ موفقیت آمیز آن ثابت می کند که کلید بدون تغییر داده های مشتری کار می کند.

برای مسیرهای POST، application/json را انتخاب کنید و شکل بدن را از این راهنما بچسبانید. نقشه یک استیبل External ID؛ فقط در صورتی که نمایه دارای چندین الگوی فعال باشد، template_id را اضافه کنید.

با یک مخاطب یکبار مصرف اجرا کنید، خروجی HTTP را بررسی کنید، و تنها پس از آن فیلدهای پاسخ دقیق آن را در ماژول CRM، ایمیل یا پیام بعدی نگاشت کنید.

چه زمانی باید از Make HTTP استفاده کنید؟

اکنون از HTTP برای 7stamp استفاده کنید: این مسیر مستند و آماده برای تولید است، نه یک بازگشت کاهش یافته. هر زمان که به عملیات 7stamp، مسیر API جدید، یا اتصال سفارشی POS/ERP نیاز داشتید، آن را انتخاب کنید. مرجع OpenAPI منبع حقیقت برای طرحواره روش، مسیر کامل، بدنه و پاسخ است. کلید حامل و پایه URL ثابت می مانند.

7stamp رویدادها را در Make

برای یک سناریوی رویداد محور، Webhooks → Custom webhook اضافه کنید و یک هوک ایجاد کنید. URL آن را کپی کنید، API & Integrations → Webhooks را در نمایه 7stamp باز کنید، URL را جایگذاری کنید، انواع رویداد را انتخاب کنید، ذخیره کنید و یک رویداد آزمایشی واقعی ارسال کنید. نمایه 7stamp مالک آن اشتراک است. API کنونی نقاط پایانی اشتراک خودکار وب هوک/unsubscribe را نشان نمی‌دهد.

هیچ اتصال عمومی Make مورد نیاز نیست

دستورالعمل‌های موجود در این صفحه از ماژول‌های Make استفاده می‌کنند که برای هر حساب Make موجود است. اگر ماژول بومی 7stamp به جای HTTP می خواهید، گردش کار مورد نیاز خود را برای ما ارسال کنید. تا آن زمان، HTTP و Custom webhook هر عملیات 7stamp مستند را پوشش می‌دهند.

درباره یک رابط بومی بپرسید

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

من نمی‌توانم 7stamp را در Make پیدا کنم. آیا هنوز هم می توانم آن را خودکار کنم؟

بله. امروز هیچ برنامه عمومی 7stamp در Make وجود ندارد. یک درخواست HTTP > Make اضافه کنید، از نقطه پایانی کامل 7stamp URL استفاده کنید و Authorization: Bearer و به دنبال آن کلید ⟦300 ⟦ خود را ارسال کنید. HTTP می‌تواند با هر نقطه پایانی مستند تماس بگیرد.

رمز اتصال Make را از کجا دریافت کنم؟

در 7stamp Admin، API Integrations، سپس API Keys و سپس Add API Key را باز کنید. محدوده کلید به محل کار/profile است که آن را ایجاد کرده است، بنابراین در صورت امکان از نمایه آزمایشی برای سناریوهای آزمایشی استفاده کنید.

کدام شناسه را باید به عنوان External ID ترسیم کنم؟

از شناسه پایدار از سیستم منبع استفاده کنید، ترجیحاً یک مخاطب CRM ID یا مشتری UUID. از نام نمایشی استفاده نکنید. یک شماره تلفن یا ایمیل می‌تواند کار کند، اما می‌تواند تغییر کند و باید به‌طور مداوم با آن‌ها رفتار شود.

چگونه رویدادهای 7stamp را در Make وارد کنم؟

یک Webhooks > Custom webhook در Make ایجاد کنید، سپس URL ایجاد شده آن را در تنظیمات webhook نمایه 7stamp جای‌گذاری کنید. پس از تحویل از یک فیلتر یا روتر Make برای رسیدگی به event_type ورودی استفاده کنید.

صفحات مرتبط

باز کردن Make Make HTTP کمک کنید Make Custom webhook کمک کنید 7stamp API مرجع راه اندازی وب هوک راهنمای Zapier

مرحله بعدی

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

کلید API را ایجاد کنید، List Templates را آزمایش کنید، و یک سناریو دعوت یا اسکن با یک مخاطب یکبار مصرف بسازید. روترها و پیام‌رسانی را تنها پس از اینکه جریان ساده قابل اعتماد باشد، اضافه کنید.

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