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

قم بتوصيل 7stamp إلى Zapier — خطوة بخطوة

دليل التنفيذ

استخدم Zapier عندما يكون سير عملك تسلسلًا واضحًا: جهة اتصال أو طلب يظهر، 7stamp ينفذ إجراءً، ثم يتم تحديث أداة عمل أخرى. المسار الآمن اليوم هو API بواسطة Zapier للمكالمات الصادرة 7stamp API و Webhooks by Zapier → Catch Hook للأحداث 7stamp الواردة.

لا يوجد تطبيق 7stamp عام في سوق Zapier. استخدم API by Zapier → API Request حيثما كان ذلك متاحًا: فهو يخزن مفتاح API ثابت في اتصال التطبيق بدلاً من كشفه في خطوة Zap. استخدم Webhooks by Zapier فقط للأحداث Catch Hook الواردة؛ لا تضع مفتاح 7stamp Bearer في حقل إجراء Webhooks المرئي.

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

ابدأ بـ Zap خطي قابل للاختبار

احتفظ بالزاب الأول صغيرًا. يعد التدفق الموثوق به من جهة الاتصال إلى البطاقة أو الطلب المدفوع إلى الطوابع نقطة بداية أفضل من المزامنة واسعة النطاق CRM.

قم بإنشاء دعوة من جهة اتصال CRM

قم بتشغيل جهة اتصال جديدة أو مؤهلة، قم بتعيين CRM ID إلى External ID، قم بإنشاء بطاقة دعوة، وتمرير التثبيت الذي تم إرجاعه URL إلى بريد إلكتروني أو خطوة SMS.

أضف الطوابع بعد الدفع

قم بتشغيل الأمر المدفوع أو الإيصال المغلق، قم بتعيين هوية العميل والطلب ID، ثم استخدم Scan Card مع مبلغ الطلب أو عدد الطوابع الواضح.

إصدار قسيمة استرداد لمرة واحدة

استخدم قاعدة CRM أو حدث دعم أو تصدير شريحة لتحديد العميل، وإصدار قسيمة على بطاقته، وإرسال رسالة متابعة من القناة الصحيحة.

أعد كتابة أحداث البطاقة إلى CRM

استخدم Webhooks by Zapier > Catch Hook لتلقي 7stamp أحداث البطاقة. قم بمطابقة External ID الذي تم إرجاعه إلى سجل CRM وأضف الملاحظة أو العلامة أو المهمة ذات الصلة.

7stamp العمليات للاتصال من API بواسطة Zapier

أضف API by Zapier → API Request بعد الزناد الخاص بك. قم بإنشاء اتصال 7stamp API بمفتاح واحد، ثم حدد الطريقة الدقيقة وURL الكاملة أدناه. تقوم كل عملية بإرجاع الحقول التي يمكنك تعيينها في خطوة Zap التالية.

API بواسطة Zapier الإجراء POST /cards/invite

إنشاء Card Invite

إنشاء تثبيت جديد لبطاقة المحفظة URL ورمز إدخال التسليم لجهة اتصال خارجية واحدة.

مطلوب
external_id من الزناد CRM/contact.
الخطوة التالية
أرسل install_url إلى البريد الإلكتروني، SMS، أو الحقل CRM.
API بواسطة Zapier إجراء POST /cards/invite/bulk

إنشاء مجمّع Card Invites

إنشاء ما يصل إلى 100 رابط دعوة من مجموعة JSON مُتحكم فيها.

مطلوب
مجموعة عناصر تحتوي على 1–100 كائن دعوة.
راجع
إقرأ success_count، error_count، وكل نتيجة قبل التسليم.
API بواسطة Zapier الإجراء POST /cards/scan

Scan Card

إضافة الطوابع بواسطة User Card ID أو External ID، مع المبلغ وعدد الطوابع والطلب ID، وبيانات الاستلام الاختيارية.

الهوية
external_id بالإضافة اختياري external_source; user_card_id يفوز في حالة حضور كلاهما.
قاعدة الطوابع
stamps_count لها الأولوية على المبلغ.
API بواسطة Zapier الإجراء POST /vouchers/issue

Issue Voucher

يصدر قسيمة مباشرة إلى صاحب البطاقة.

مطلوب قسيمة
.short_description وهدف external_id أو معروف user_card_id.
النتيجة
خريطة unique_code أو الحالة أو expires_at إلى CRM ملاحظة أو رسالة.
API بواسطة Zapier الإجراء POST /messages/send

Send Message

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

دفع البطاقة
card_push_text يقتصر على 20 حرفًا.
البريد الإلكتروني
الموضوع زائد الجسم؛ تُبلغ النتيجة ما إذا كان التسليم في قائمة الانتظار.
API بواسطة Zapier إجراء GET /cards

Find Cards

يبحث عن سجلات البطاقة حسب External ID، مع مرشحات المصدر والقالب الاختيارية.

مطلوب
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

استرداد إعدادات تصميم القالب لقالب معروف ID.

Zapier الزناد Webhooks by Zapier → Catch Hook

تلقي أحداث البطاقة

Catch Hook يمنح Zapier HTTPS URL فريدًا. الصقها في إعدادات خطاف الويب الخاص بـ 7stamp Admin واختبرها باستخدام حدث بطاقة حقيقي.

في Zapier
استخدم Catch Hook لبيانات الأحداث التي تم تحليلها؛ استخدم Catch Raw Hook فقط عندما تحتاج أيضًا إلى رؤوس الطلب الأولية/body.
مطابقة
ابحث عن جهة الاتصال CRM باستخدام external_id واختياري external_source من الحدث.

ثلاثة مسارات عمل Zapier يمكنك إنشاؤها خطوة بخطوة

يستخدم كل سيناريو وحدة Zapier حقيقية ومتاحة حاليًا. أنشئ طريقًا صغيرًا واحدًا أولاً واختبره باستخدام جهة اتصال يمكن التخلص منها قبل تشغيل Zap.

1. جهة اتصال مؤهلة CRM → إصدار بطاقة

النتيجة المتوقعة: تتلقى خطوة Zap التالية install_url ويمكن إرسالها إلى العميل أو كتابتها مرة أخرى إلى سجل CRM.

  1. 1 أنشئ Zap وحدد الحدث CRM الذي يعني أن جهة الاتصال مؤهلة للحصول على الولاء. اختبر المشغل وتأكد من أن لديك جهة الاتصال غير القابلة للتغيير ID.
  2. 2 أضف API by Zapier → API Request. أنشئ أو حدد اتصال المفتاح 7stamp API، واختر POST، واضبط URL على https://api.7loc.com/cards-api/cards/invite.
  3. 3 اضبط الجسم على JSON. قم بتعيين CRM ID إلى external_id، قم بتعيين external_source ثابت مثل kommo، وأضف template_id فقط عندما يكون أكثر من قالب 7stamp نشطًا.
  4. 4 اختبار العمل. تأكد من أن الرد يحتوي على install_url و delivery_insert_code لنفس external_id.
  5. 5 أضف CRM التحديث أو البريد الإلكتروني أو SMS الإجراء. الخريطة install_url من الرد API ؛ لا تقم بترميز الاختبار أو نسخه URL.

تأكد: إنشاء Card Invite يُرجع دائمًا دعوة جديدة. أضف طلب Find Cards أو Zapier قم بالتصفية أولاً إذا كانت سياستك عبارة عن دعوة واحدة لكل جهة اتصال.

2. الطلب المدفوع → طوابع الجائزة

النتيجة المتوقعة: ينشئ الطلب مسحًا ضوئيًا 7stamp يمكن تتبعه ويمكن لـ Zap تسجيل stamps_added أو scan_id في النظام المصدر.

  1. 1 استخدم الأمر المدفوع/Closed مشغل الاستلام واختبره. تأكد من وجود العميل ID والطلب الفريد ID قبل المتابعة.
  2. 2 أضف API by Zapier → API Request مع POST https://api.7loc.com/cards-api/cards/scan وحدد نفس الاتصال 7stamp.
  3. 3 أرسل JSON مع external_id، external_source، external_order_id، وإما المبلغ للقوالب القائمة على المبلغ أو stamps_count للحصول على جائزة ختم صريحة.
  4. 4 اختبار مع أمر يمكن التخلص منه. تحقق من النجاح scan_id و stamps_added في الرد.
  5. 5 أضف فلتر يستمر فقط بعد الرد الناجح، ثم قم بتحديث الطلب/CRM بالنتيجة المؤكدة.

تأكد: في حالة إعادة تشغيل الزاب، تأكد من الأمر الأصلي قبل إرسال مسح آخر. حافظ على استقرار external_order_id حتى يمكن التوفيق بين الحدث لاحقًا.

3. 7stamp حدث → إنشاء CRM ملاحظة أو مهمة

النتيجة المتوقعة: Zapier يتلقى حدث 7stamp مُحلل، ويجد العميل بواسطة external_id، ويقوم بإنشاء المتابعة المناسبة.

  1. 1 قم بإنشاء Zap جديد باستخدام Webhooks by Zapier كمشغل. حدد Catch Hook، وتابع، وانسخ URL الفريد الموضح في خطوة الاختبار.
  2. 2 في 7stamp Admin، افتح API & Integrations → Webhooks، أضف Catch Hook URL، وحدد أنواع الأحداث المطلوبة فقط، ثم احفظها.
  3. 3 قم بإجراء فحص اختبار حقيقي أو حدث بطاقة. عد إلى Zapier، وانقر على Test trigger وأكد وصول event_type وexternal_id وexternal_source كحقول عينة.
  4. 4 أضف CRM ابحث عن إجراء جهة الاتصال باستخدام external_id. أضف قاعدة تصفية أو مسارات لـ event_type، على سبيل المثال افصل SCAN عن REWARD_EARNED.
  5. 5 أنشئ ملاحظة CRM/task وقم بتعيين الحقول الموجودة لهذا الحدث فقط، مثل scanned_at أو stamps_after أو external_order_id أو issued_vouchers.

تأكد: ا Catch Hook URL سر. إذا تم نقل Zap إلى مالك آخر، قم بتحديث URL في 7stamp Admin قبل الاعتماد عليه.

أنشئ المفتاح 7stamp API قبل إنشاء Zap

هذه هي الخطوات الجانبية 7stamp. افعل ذلك مرة واحدة، ثم استخدم المفتاح فقط داخل اتصال API بواسطة Zapier — وليس في حقل إجراء Webhooks by Zapier أو ملاحظة. شاشة

7stamp Admin API والتكاملات مع الإجراء Add API Key
افتح API والتكاملات، اختر API Keys، ثم قم بإنشاء مفتاح منفصل لبرنامج Zap حيث يتم إعداد حسابك يسمح بذلك.
مفتاح 7stamp API تم إنشاؤه حديثًا جاهز للنسخ
انسخ المفتاح إلى API الآمن عن طريق اتصال Zapier، وليس في خطوة Webhooks بنص عادي أو مستند مشترك.

قواعد الاتصال التي تمنع عدم تطابق البيانات

احتفظ بالمفتاح API في API بواسطة 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 الخاص بك

01

إنشاء مفتاح 7stamp API في المشرف: API & Integrations → API Keys → Add API Key. استخدم مفتاح اختبار منفصل/profile عندما يكون متاحًا.

02

في Zapier، قم بإنشاء Zap واختبر مشغل المصدر. استخدم عينة حقيقية حتى يكون الاتصال ID، العميل ID، الطلب ID، والمبلغ متاحًا لرسم الخرائط.

03

أضف API by Zapier → API Request. قم بإنشاء اتصال 7stamp للرأس الثابت Bearer Authorization بدلاً من وضع السر في حقل الإجراء Webhooks by Zapier.

04

اتصل على GET https://api.7loc.com/cards-api/templates أولاً. يؤدي ذلك إلى تأكيد عمل المفتاح وإظهار معرفات القوالب النشطة المتوفرة دون تعديل بيانات العميل.

05

حدد POST /cards/invite أو POST /cards/scan، قم بتعيين JSON كنوع الجسم، وقم بتعيين الإسطبل External ID بالإضافة إلى حقول القالب/order ذات الصلة من الزناد.

06

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

استخدم الطلب العام فقط للمسارات الموثقة

استخدم 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 الفريد الموضح في إعداد الاختبار، والصقه في إعدادات webhook الخاصة بالملف الشخصي 7stamp، وحدد أنواع الأحداث، ثم قم بإرسال فحص اختبار حقيقي أو حدث بطاقة. استخدم حمولة الحدث External ID وExternal Source لتحديد جهة الاتصال CRM الصحيحة. اختر Catch Raw Hook فقط عندما تحتاج على وجه التحديد إلى النص غير المُحلل ورؤوس الطلب.

استخدم الطريق الآمن Zapier الآن

API بواسطة Zapier وCatch Hook كافية لكل عملية 7stamp API عامة وحدث بطاقة. إذا كنت بحاجة إلى تطبيق 7stamp Zapier أصلي في المستقبل، أرسل لنا الإجراء الدقيق/trigger الذي يستخدمه فريقك أكثر من غيره.

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

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

أين يمكنني العثور على تطبيق 7stamp في Zapier؟

لا يوجد تطبيق سوق 7stamp عام اليوم. استخدم API by Zapier → API Request للمكالمات 7stamp API و Webhooks by Zapier → Catch Hook للأحداث 7stamp الواردة.

أين أقوم بإنشاء الرمز المميز Zapier؟

أنشئ مفتاح 7stamp API في المشرف تحت API & Integrations → API Keys → Add API Key. قم بتخزينه كرأس ثابت Bearer Authorization في API بواسطة اتصال Zapier، وليس في حقل إجراء Webhooks by Zapier مرئي.

كيف يمكن لـ Zapier الحصول على حدث ختم أو قسيمة؟

قم بإنشاء Catch Hook في Webhooks by Zapier، ثم الصق URL الذي تم إنشاؤه في إعدادات webhook الخاصة بملف 7stamp، وحدد الأحداث، وأرسل حدث اختبار قبل تمكين تحديثات CRM.

هل أختار Zapier أم Make؟

اختر Zapier لسير عمل الإجراء الخطي في الغالب. اختر Make عندما تحتاج إلى أجهزة توجيه أو تحويلات معقدة أو سيناريوهات طويلة متعددة الفروع. كلاهما يستخدم نفس المفتاح 7stamp API ونقاط النهاية.

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

فتح Zapier API بواسطة Zapier مساعدة Zapier Catch Hook مساعدة 7stamp API مرجع إعداد Webhook Make دليل

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

إنشاء أول Zap باستخدام جهة اتصال اختبارية

إنشاء مفتاح API، اختبار GET /templates حتى API بواسطة Zapier، ثم أنشئ إجراء اتصال واحد بالبطاقة أو أمر بالطوابع. أضف Catch Hook بمجرد أن يحصل التدفق الخارجي على نتيجة اختبار مثبتة.

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