دليل التشغيل الآلي بدون رمز

قم بتوصيل 7stamp إلى Make - خطوة بخطوة

دليل التنفيذ

استخدم Make للتواصل 7stamp مع CRM أو POS أو متجر عبر الإنترنت أو جدول بيانات أو أداة مراسلة أو أي نظام يمكنه إرسال البيانات إلى سيناريو. المسار الجاهز للإنتاج اليوم هو تطبيق Make's HTTP للمكالمات 7stamp API وMake's Custom webhook للأحداث 7stamp الواردة.

لا يوجد تطبيق 7stamp عام في منتقي تطبيقات Make حتى الآن. لا تنتظر واحدًا: أضف HTTP → Make a request، استخدم بالضبط URL، الطريقة، Bearer الرأس، وJSON أدناه، ثم قم بتعيين الحقول من وحدة المصدر الخاصة بك. هذا هو نفس 7stamp Integration API الذي سيستخدمه الموصل المستقبلي.

مفتوح Make مفتوح API مرجع

اختر السيناريو الأول الذي يتوافق مع سير عملك

ابدأ بحدث واحد ونتيجة واحدة. بمجرد صحة بيانات الاختبار، أضف المرشحات وأجهزة التوجيه وتحديثات CRM ورسائل المتابعة حولها.

أنشئ بطاقة بعد جهة اتصال CRM جديدة

استخدم جهة الاتصال CRM ID كـ External ID، قم بإنشاء دعوة بطاقة 7stamp، ثم أرسل التثبيت المرتجع 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 في إعدادات webhook للملف الشخصي 7stamp. يبدأ هذا السيناريو عندما يرسل 7stamp حدثًا مثل SCAN أو REWARD_EARNED أو VOUCHER_ISSUED.

في Make
Webhooks → Custom webhook → إضافة؛ أعطه اسمًا واضحًا وانسخ الرقم الذي تم إنشاؤه URL.
في 7stamp
المشرف → 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 كائن طلب دعوة فردي.
تأكد
إقرأ 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، أو اقرأ المرجع OpenAPI لمعرفة تاريخ انتهاء الصلاحية المحدد.
HTTP الإجراء POST /messages/send

إرسال رسالة

يرسل المحتوى إلى مالك البطاقة من خلال دفع بطاقة المحفظة و/or البريد الإلكتروني، مع مراعاة القناة التي تم تكوينها وقواعد الموافقة.

دفع البطاقة
card_push_text يقتصر على 20 حرفًا ويتطلب بطاقة مرور مثبتة للمحفظة.
البريد الإلكتروني
أرسل الموضوع زائد الجسم؛ يتم دعم HTML الأساسي في الجسم.
Make الوحدة Full 7stamp endpoint URL

HTTP → Make a request

هذه هي الوحدة Make التي تستدعي كل مسار 7stamp أعلاه. استخدم URL كاملاً، وحدد الطريقة الموثقة، وأضف العنوان Bearer، واستخدم JSON فقط عندما يحتاج المسار إلى نص.

القاعدة URL
https://api.7loc.com/cards-api
الرأس
Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json للطلبات POST.

ثلاثة سيناريوهات Make يمكنك بنائها تمامًا كما هو مكتوب

الأسماء أدناه هي وحدات Make الحقيقية. ابدأ بالسيناريو الأول، وقم بتشغيله على جهة اتصال يمكن التخلص منها، وبعد ذلك فقط قم بإضافة أجهزة التوجيه أو عوامل التصفية أو جدولة الإنتاج.

1. جديد CRM جهة اتصال → إرسال رابط البطاقة 7stamp

النتيجة المتوقعة: يتلقى العميل install_url المرتجع بواسطة 7stamp; يمكن لـ CRM الاحتفاظ بذلك URL في نفس سجل الاتصال.

  1. 1 أنشئ سيناريو وأضف مشغل الاتصال CRM الجديد/Created. بالنسبة إلى Kommo، اختر مشغل إنشاء جهة الاتصال وقم بتشغيله مرة واحدة لتحميل عينة جهة اتصال.
  2. 2 أضف HTTP → Make a request. اضبط الطريقة على POST و URL إلى https://api.7loc.com/cards-api/cards/invite.
  3. 3 أضف Authorization: Bearer YOUR_7STAMP_API_KEY و Content-Type: application/json. في النص JSON، قم بتعيين CRM جهة الاتصال ID إلى external_id وقم بتعيين external_source على تسمية ثابتة مثل kommo.
  4. 4 قم بتشغيل الوحدة HTTP مرة واحدة. تأكد من أن الإخراج يحتوي على install_url وdelivery_insert_code وexternal_id وtemplate_id.
  5. 5 أضف بريدك الإلكتروني/SMS/CRM وحدة التحديث بعد HTTP والخريطة install_url من الناتج HTTP. احفظ URL على جهة الاتصال CRM إذا كان على الفريق إعادة إرساله لاحقًا.

تأكد: POST /cards/invite ينشئ دائمًا دعوة جديدة. استخدم Find Cards أولاً إذا كانت قاعدة عملك هي تجنب دعوة أخرى لجهة اتصال موجودة.

2. الطلب المدفوع → أضف طوابع الولاء

النتيجة المتوقعة: تتضمن استجابة المسح الناجحة النجاح، scan_id، stamps_added، وحالة بطاقة ما بعد المسح لخطوتك التالية.

  1. 1 ابدأ من POS/ecommerce مشغل الطلب المدفوع. Make أكيد عينته تحتوي على عميل مستقر ID والطلب/receipt ID.
  2. 2 أضف HTTP → Make a request مع POST https://api.7loc.com/cards-api/cards/scan ونفس Bearer الرأس.
  3. 3 الخريطة external_id من العميل، external_source من اسم النظام، و external_order_id من الطلب ID. أضف مبلغًا للبطاقات المستندة إلى المبلغ، أو stamps_count لعدد واضح من الطوابع.
  4. 4 Run once مع طلب تجريب. تحقق من علامة النجاح التي تم إرجاعها وstamps_added قبل تمكين جدول السيناريو.
  5. 5 أضف مرشحًا بشكل اختياري بعد خطوة HTTP: استمر فقط عندما يكون النجاح حقيقيًا، ثم اكتب scan_id أو stamps_added مرة أخرى إلى سجل الطلب/CRM.

تأكد: استخدم نفس external_order_id عند إعادة المحاولة حتى يمكن تتبع الطلب في أحداث webhook اللاحقة؛ لا تمنح الطوابع مرتين بعد فشل غير واضح.

3. 7stamp الحدث → تحديث CRM

النتيجة المتوقعة: Make يتلقى الحدث 7stamp على الفور ويمكن العثور على السجل CRM المطابق عبر external_id و external_source.

  1. 1 قم بإنشاء سيناريو Make منفصل. أضف Webhooks → Custom webhook، حدد إضافة، وقم بتسميته 7stamp-أحداث البطاقة، وانسخ URL الذي تم إنشاؤه.
  2. 2 في 7stamp Admin، افتح API & Integrations → Webhooks. أضف URL وحدد مجموعة صغيرة من الأحداث، على سبيل المثال SCAN و REWARD_EARNED.
  3. 3 قم بإنشاء اختبار مسح ضوئي أو حدث بطاقة يمكن التخلص منه في 7stamp. ارجع إلى Make واستخدم Run once للسماح لـ Make بتحديد بنية بيانات الحدث.
  4. 4 أضف خطوة بحث CRM باستخدام external_id. أضف مرشحًا أو جهاز توجيه على event_type حتى يتمكن SCAN وREWARD_EARNED وVOUCHER_ISSUED من اتخاذ إجراءات مختلفة.
  5. 5 أضف الإجراء CRM تحديث/note. الخريطة scanned_at، stamps_after، external_order_id، وissued_vouchers فقط عند وجود هذه الحقول لنوع الحدث المحدد.

تأكد: حافظ على خصوصية الويب هوك URL. اختبر حدثًا حقيقيًا قبل تشغيل الرسائل أو القسائم أو التغييرات CRM التي لا رجعة فيها.

احصل على المفتاح 7stamp API قبل فتح Make

هذه هي شاشات 7stamp Admin بالضبط. أنشئ المفتاح مرة واحدة، وانسخه إلى اتصال HTTP الآمن/keychain الخاص بـ Make، ثم قم بإزالته على الفور من الحافظة الخاصة بك.

7stamp Admin API وشاشة التكامل مع قائمة API Keys والتحكم Add API Key
في 7stamp Admin افتح API & التكامل ثم API Keys ثم اختيار Add API Key.
جديد 7stamp API مربع حوار المفتاح مع التحكم في النسخ المرئي
انسخ المفتاح فقط في Make HTTP اتصال/keychain. تعامل معه ككلمة مرور وقم بتدويره إذا تم كشفه.

قم بإعداد الاتصال قبل البناء

قم بإنشاء API مفتاح لكل بيئة

في 7stamp Admin انتقل إلى API & Integrations → API Keys → Add API Key. قم بتخزين القيمة في Make's 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 الأول

01

في 7stamp Admin، أنشئ مفتاحًا في API & Integrations → API Keys → Add API Key. استخدم ملف تعريف اختبار منفصل/key عندما يسمح إعداد حسابك بذلك.

02

في Make، أنشئ سيناريو وأضف مشغل المصدر. قم بتشغيله مرة واحدة قبل التعيين حتى تتمكن من رؤية عينة اتصال حقيقية أو طلب مدفوع.

03

اضغط على الإضافة التالية، وابحث عن HTTP، واختر Make طلب. قم بضبط الطريقة كاملة URL والرؤوس من بطاقة التشغيل في هذه الصفحة.

04

استخدم GET https://api.7loc.com/cards-api/templates كأول طلب. تثبت استجابتها الناجحة أن المفتاح يعمل دون تغيير أي بيانات للعميل.

05

لطرق POST، اختر application/json وألصق شكل الجسم من هذا الدليل. خريطة مستقر External ID; أضف template_id فقط إذا كان الملف الشخصي يحتوي على قوالب نشطة متعددة.

06

قم بالتشغيل باستخدام جهة اتصال يمكن التخلص منها، وتفقد إخراج 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 webhooks يغطيون كل عملية 7stamp موثقة.

اسأل عن موصل أصلي

الأسئلة المتداولة

لا أستطيع العثور على 7stamp في Make. هل لا يزال بإمكاني أتمتة ذلك؟

نعم. لا يوجد تطبيق 7stamp عام في Make اليوم. أضف HTTP > Make طلبًا، واستخدم نقطة النهاية 7stamp الكاملة URL، وأرسل Authorization: Bearer متبوعًا بمفتاحك 7stamp API. HTTP يمكنه الاتصال بكل نقطة نهاية موثقة.

من أين أحصل على رمز الاتصال Make؟

في 7stamp Admin، افتح API التكامل، ثم API Keys، ثم Add API Key. تم تحديد نطاق المفتاح إلى مكان العمل/profile الذي أنشأه، لذا استخدم ملف تعريف اختبار لسيناريوهات الاختبار كلما أمكن ذلك.

ما المعرف الذي يجب تعيينه كـ External ID؟

استخدم المعرف الثابت من النظام المصدر ويفضل CRM جهة اتصال ID أو العميل UUID. لا تستخدم اسم العرض. يمكن أن يعمل رقم الهاتف أو البريد الإلكتروني، ولكن يمكن أن يتغير ويجب التعامل معه باستمرار.

كيف يمكنني تحويل 7stamp الأحداث إلى Make؟

قم بإنشاء خطاف ويب > Custom webhook في Make، ثم الصق URL الذي تم إنشاؤه في إعدادات خطاف الويب للملف الشخصي 7stamp. استخدم مرشح أو جهاز توجيه Make بعد التسليم للتعامل مع event_type الوارد.

الصفحات ذات الصلة

فتح Make Make HTTP مساعدة Make Custom webhook مساعدة 7stamp API مرجع إعداد Webhook Zapier دليل

الخطوة التالية

هل أنت مستعد لأتمتة إجراء الولاء الأول؟

أنشئ المفتاح API، واختبر List Templates، وقم ببناء سيناريو دعوة أو مسح واحد باستخدام جهة اتصال يمكن التخلص منها. قم بإضافة أجهزة التوجيه والمراسلة فقط بعد أن يصبح التدفق البسيط موثوقًا به.

مفتوح 7stamp Admin اقرأ المرجع API