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

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

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

هنگامی که گردش کار شما یک دنباله واضح است، از Zapier استفاده کنید: یک مخاطب یا سفارش ظاهر می‌شود، 7stamp یک عمل را انجام می‌دهد، سپس ابزار تجاری دیگری به‌روزرسانی می‌شود. مسیر امن امروز API توسط Zapier برای تماس‌های خروجی 7stamp API و Webhooks by Zapier → Catch Hook برای رویدادهای 7stamp ورودی است.

هیچ برنامه عمومی 7stamp در بازار Zapier وجود ندارد. در صورت وجود از API by Zapier → API Request استفاده کنید: به جای اینکه در یک مرحله Zap نمایش داده شود، یک کلید ثابت API را در اتصال برنامه ذخیره می‌کند. فقط برای رویدادهای ورودی Catch Hook از Webhooks by Zapier استفاده کنید. کلید 7stamp Bearer را در فیلد اقدام قابل مشاهده Webhooks قرار ندهید.

باز کردن Zapier مرجع API را باز کنید

با یک Zap خطی و قابل آزمایش شروع کنید

اولین Zap را کوچک نگه دارید. جریان قابل اعتماد تماس به کارت یا سفارش پرداخت شده به تمبر نقطه شروع بهتری نسبت به همگام سازی گسترده دو طرفه CRM است.

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

روی یک مخاطب جدید یا واجد شرایط راه اندازی کنید، CRM ID آن را به External ID External ID نقشه برداری کنید، و کارت 29 را نصب کنید ⟧ ارسال کنید. به یک ایمیل یا مرحله SMS.

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

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

یک کوپن بازیابی یکباره صادر کنید

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

رویدادهای کارت را به CRM

برگردانید تا برای دریافت رویدادهای کارت 7stamp از Webhooks by Zapier > Catch Hook استفاده کنید. External ID برگشتی را با رکورد CRM مطابقت دهید و یادداشت، برچسب یا کار مربوطه را اضافه کنید.

7stamp operations to call from API by Zapier

Add API by Zapier → API Request بعد از ماشه شما. یک اتصال کلید 7stamp API ایجاد کنید، سپس روش دقیق و URL را در زیر انتخاب کنید. هر عملیات فیلدهایی را برمی گرداند که می توانید در مرحله بعدی Zap نقشه برداری کنید.

API توسط Zapier اقدام POST /cards/invite

Create Card Invite

ایجاد یک کیف پول جدید کارت نصب و تحویل یک کارت خارجی ⟦2974 کد 3-in.

مورد نیاز: external_id از ماشه CRM/contact.
مرحله بعدی: نقشه install_url در ایمیل، SMS، یا فیلد CRM.

API توسط Zapier اقدام POST /cards/invite/bulk

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

حداکثر 100 پیوند دعوت از یک کنترل ایجاد می‌کند.

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

API توسط Zapier اقدام POST /cards/scan

Scan Card

تمبر با User Card ID، تعداد ⟦29759 ⦁، تعداد 6 ⟧ یا 6 سفارش ID و داده های رسید اختیاری.

هویت: external_id بعلاوه اختیاری external_source; user_card_id در صورت حضور هر دو برنده است.
قانون تمبر: stamps_count بر مبلغ اولویت دارد.

API توسط Zapier اقدام POST /vouchers/issue

Issue Voucher

کوپن را مستقیماً برای صاحب کارت صادر می‌کند.

کوپن: الزامی.short_description و هدف external_id یا شناخته شده ⟦29771
نتیجه: نقشه unique_code، وضعیت، یا expires_at به یادداشت یا پیام CRM.

API توسط Zapier اقدام POST /messages/send

Send Message

ارسال پست کیف پول-کارت و محتوای ایمیل ⟦29778 به صاحب کارت.

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

API توسط Zapier اقدام GET /cards

Find Cards

سوابق کارت را بر اساس ⟦29783 با فیلتر منبع و قالب، گزینه‌ای می‌یابد.

مورد نیاز: external_id به عنوان پارامتر پرس و جو.
ابتدا استفاده کنید: زمانی که قانون شما از دعوت های تکراری جلوگیری می کند، قبل از ایجاد دعوت استفاده کنید.

API توسط Zapier اقدام GET /cards/{user_card_id}

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

وضعیت یک کارت را با 7stamp ID داخلی آن می خواند.

مورد نیاز: {user_card_id} را با ID بازگردانده شده توسط 7stamp جایگزین کنید.
خروجی مفید: stamps_count، وضعیت کیف پول، و active_vouchers_count.

API توسط Zapier اقدام GET /templates

List Templates

الگوهای موجود در نمایه متصل را فهرست می کند و اتصال API را تأیید می کند.

اولین تست: قبل از هر اقدامی برای نوشتن با آن تماس بگیرید: داده‌های مشتری را تغییر نمی‌دهد.
بعدا استفاده کنید: وقتی چندین الگو وجود دارد، شناسه فعال به template_id تبدیل می‌شود.

API توسط Zapier اقدام GET /templates/{template_id}/design

Get Template Design

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

Zapier ماشه Webhooks by Zapier → Catch Hook

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

Catch Hook به Zapier یک HTTPS HTTPS منحصر به فرد می‌دهد. آن را در تنظیمات webhook 7stamp Admin قرار دهید و آن را با یک رویداد کارت واقعی آزمایش کنید.

در Zapier: از Catch Hook برای داده های رویداد تجزیه شده استفاده کنید. فقط زمانی از Catch Raw Hook استفاده کنید که به سرصفحه درخواست خام نیز نیاز دارید/body.
مطابقت دهید: مخاطب CRM را با استفاده از external_id و رویداد 2981⟧ اختیاری پیدا کنید.

سه گردش کار Zapier که می‌توانید گام به گام بسازید

هر سناریو از یک ماژول Zapier واقعی و در حال حاضر موجود استفاده می‌کند. ابتدا یک مسیر کوچک بسازید و قبل از روشن کردن 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 قرار دهید، یک external_source ثابت مانند kommo تنظیم کنید و فقط زمانی که بیش از یک الگوی 7stamp فعال است، template_id را اضافه کنید.
4 عمل را تست کنید. تأیید کنید که پاسخ حاوی install_url و delivery_insert_code برای همان external_id باشد.
5 به‌روزرسانی CRM، ایمیل یا اقدام SMS خود را اضافه کنید. نقشه install_url از پاسخ API؛ تست URL را سخت کد یا کپی نکنید.

Check: ایجاد Card Invite همیشه یک دعوت جدید را برمی‌گرداند. اگر خط مشی شما یک دعوت برای هر مخاطب است ابتدا یک درخواست 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 فیلتری اضافه کنید که فقط پس از پاسخ موفقیت‌آمیز ادامه یابد، سپس با نتیجه تایید شده، دستور/CRM را به‌روزرسانی کنید.

Check: اگر Zap دوباره پخش شد، قبل از ارسال اسکن دیگر، سفارش اصلی را بررسی کنید. external_order_id را ثابت نگه دارید تا بعداً بتوان رویداد را با هم تطبیق داد.

3. رویداد 7stamp → یادداشت یا کار CRM ایجاد کنید

نتیجه مورد انتظار: Zapier یک رویداد 7stamp تجزیه شده دریافت می‌کند، مشتری را تا external_id پیدا می‌کند و پیگیری مناسب را ایجاد می‌کند.

1 یک Zap جدید با 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 یک کنش CRM با استفاده از external_id پیدا کنید. یک قانون فیلتر یا مسیرها برای event_type اضافه کنید، برای مثال SCAN را از REWARD_EARNED جدا کنید.
5 یک یادداشت CRM/task ایجاد کنید و فقط فیلدهایی را که برای آن رویداد وجود دارد، مانند scanned_at، stamps_after، external_order_id، یا issued_vouchers نقشه برداری کنید.

Check: یک Catch Hook URL یک راز است. اگر Zap به مالک دیگری منتقل شد، قبل از تکیه بر آن، URL را در 7stamp Admin به‌روزرسانی کنید.

قبل از ساخت Zap کلید 7stamp API را ایجاد کنید

اینها پله های سمت 7stamp هستند. این کار را یک بار انجام دهید، سپس از کلید فقط در داخل اتصال API توسط Zapier استفاده کنید—نه در فیلد عمل Webhooks by Zapier یا یادداشت.

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

کلید 7stamp API تازه تولید شده آماده کپی کردن است — کلید را در اتصال ایمن API توسط Zapier کپی کنید، نه در یک مرحله Webhooks متن ساده یا یک سند مشترک.

قوانین اتصال که از عدم تطابق داده ها جلوگیری می کند

کلید API را در اتصال ⟦29818 در Zapier نگه دارید

در 7stamp Admin، API & Integrations → API Keys → Add API Key را انتخاب کنید. در API توسط Zapier، یک اتصال کلید API با یک سرصفحه ثابت Authorization حاوی Bearer و به دنبال آن کلید ایجاد کنید. API توسط Zapier به جای یک مرحله Zap قابل مشاهده، اعتبار را در اتصال نگه می‌دارد. دسترسی به اتصال را محدود کنید و در صورت لو رفتن کلید را بچرخانید.

نقشه External ID و External Source به طور مداوم

External ID شناسه مشتری پایدار شماست؛ External Source برچسب‌هایی را که از کجا آمده است، به عنوان مثال hubspot، bitrix24، shopify یا پوستر نشان می‌دهد. از همان جفت برای ایجاد، یافتن، اسکن، کوپن، و جریان های وب هوک استفاده کنید.

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

اقدامات هدف‌یابی کارت User Card ID یا External ID را می‌پذیرد. وقتی هر دو وجود دارند، User Card ID اولویت دارد. از ID داخلی فقط پس از بازگشت توسط یک مرحله 7stamp قابل اعتماد استفاده کنید. در غیر این صورت سیستم منبع External ID را ترجیح دهید.

درخواست دقیق API توسط Zapier: اهدای یک تمبر

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

اولین Zap خود را بسازید

یک کلید 7stamp API در Admin ایجاد کنید: API & Integrations → API Keys → Add API Key. در صورت موجود بودن از یک کلید تست جداگانه/profile استفاده کنید.

در Zapier، یک Zap ایجاد کنید و تریگر منبع را آزمایش کنید. از یک نمونه واقعی استفاده کنید تا مخاطب ID، مشتری ID، سفارش ID و مبلغ برای نقشه برداری در دسترس باشد.

API by Zapier → API Request را اضافه کنید. یک اتصال 7stamp برای هدر ثابت Bearer Authorization به جای قرار دادن راز در یک فیلد عمل Webhooks by Zapier ایجاد کنید.

ابتدا با شماره GET https://api.7loc.com/cards-api/templates تماس بگیرید. این کار کلید را تأیید می‌کند و نشان می‌دهد که کدام شناسه‌های الگوی فعال بدون تغییر داده‌های مشتری در دسترس هستند.

POST /cards/invite یا POST /cards/scan را انتخاب کنید، JSON را به عنوان نوع بدنه تنظیم کنید و External ID پایدار را به اضافه الگوی مربوطه را از فیلدهای 4⟦29.

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

از درخواست جهانی فقط برای مسیرهای مستند استفاده کنید

از API توسط Zapier برای درخواست 7stamp با کلید Bearer API استفاده کنید: کلیدهای سرصفحه ایستا را در اتصال برنامه نگه می دارد. از Webhooks by Zapier برای تحویل رویداد Catch Hook استفاده کنید، نه به عنوان مکان ترجیحی برای راز 7stamp. پایه URL را در https://api.7loc.com/cards-api, نگه دارید، از مرجع عمومی OpenAPI برای طرحواره‌های دقیق استفاده کنید و هرگز اعتبارنامه یا داده‌های مشتری را به یک URL تأیید نشده ارسال نکنید.

رویدادهای 7stamp را از طریق Catch Hook دریافت کنید

Webhooks by Zapier → Catch Hook را ایجاد کنید، URL منحصربه‌فرد نشان داده شده در تنظیمات آزمایشی را کپی کنید، آن را در تنظیمات وب هوک نمایه 7stamp جای‌گذاری کنید، انواع رویداد را انتخاب کنید و سپس یک اسکن آزمایشی واقعی یا رویداد کارت ارسال کنید. از External ID و External Source رویداد برای پیدا کردن مخاطب مناسب ⟦29964 استفاده کنید. فقط زمانی Catch Raw Hook را انتخاب کنید که به طور خاص به بدنه تجزیه نشده و سرصفحه درخواست نیاز دارید.

اکنون از مسیر امن Zapier استفاده کنید

API توسط Zapier و Catch Hook برای هر عملیات عمومی و رویداد کارت ⟦29687 کافی است. اگر به یک برنامه بومی آینده 7stamp Zapier نیاز دارید، اکشن دقیق/trigger را که تیم شما بیشتر استفاده می‌کند را برای ما ارسال کنید.

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

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

از کجا می توانم برنامه 7stamp را در Zapier پیدا کنم؟

امروز هیچ برنامه عمومی 7stamp بازار وجود ندارد. برای تماس‌های 7stamp API از API by Zapier → API Request و برای رویدادهای ورودی 7stamp از Webhooks by Zapier → Catch Hook استفاده کنید.

توکن Zapier را کجا ایجاد کنم؟

یک کلید 7stamp API در Admin در زیر API & Integrations → API Keys → Add API Key ایجاد کنید. آن را به عنوان یک سرصفحه ثابت Bearer Authorization در اتصال API توسط Zapier ذخیره کنید، نه در یک فیلد عمل قابل مشاهده Webhooks by Zapier.

چگونه می‌توان Zapier یک رویداد تمبر یا کوپن دریافت کرد؟

یک Catch Hook در Webhooks by Zapier ایجاد کنید، URL ایجاد شده را در تنظیمات webhook نمایه 7stamp جای‌گذاری کنید، رویدادها را انتخاب کنید و قبل از فعال کردن به‌روزرسانی‌های ⟦29713، یک رویداد آزمایشی ارسال کنید.

آیا باید Zapier یا Make را انتخاب کنم؟

Zapier را برای یک گردش کاری عمدتاً خطی با ماشه انتخاب کنید. زمانی که به روترها، تغییرات پیچیده یا سناریوهای چند شاخه ای طولانی نیاز دارید، Make را انتخاب کنید. هر دو از یک کلید 7stamp API و نقاط پایانی استفاده می‌کنند.

صفحات مرتبط

باز Zapier API توسط Zapier کمک کنید Zapier Catch Hook کمک کنید 7stamp API مرجع راه اندازی وب هوک راهنمای Make

مرحله بعدی

اولین Zap را با یک تماس آزمایشی بسازید

Create the API key, test GET /templates through API by Zapier, then build one contact-to-card or order-to-stamps action. هنگامی که جریان خروجی یک نتیجه آزمایش اثبات شده داشت، Catch Hook را اضافه کنید.

Open 7stamp Admin Read the API reference