ربط Zapier أو n8n

Zapier وn8n أداتا أتمتة. يمكنهما نقل البيانات من أي تطبيق آخر تقريبًا إلى BytePhase. مثلًا: صف جديد في جدول بيانات يمكن أن يصبح عميلًا محتملًا.

قبل أن تبدأ

• تحتاج حسابًا في Zapier أو n8n. في Zapier، خطوة Webhooks by Zapier ميزة مدفوعة.
• يمكنك ربط هذا في كل الباقات. لرؤية الاستفسارات، تحتاج باقة Standard أو أعلى.
• من المفيد أن يساعدك شخص بنى Zap أو سير عمل في n8n من قبل.

الخطوات

1. افتح Settings › Integrations. تحت Website & forms، انقر Connect على Zapier أو n8n.

2. اختر Self check-in (تسجيل ذاتي) أو Lead (عميل محتمل)، ثم انقر Next.

3. انسخ API key وEndpoint URL. في Zapier، ترى أيضًا API base URL.

   يظهر مفتاح API مرة واحدة فقط. انسخه الآن.

   

   الكمبيوتر

4. أنشئ الربط في أداتك. يعرض How to connect على الشاشة الخطوات:

   • Zapier: في الـ Zap، أضف إجراء Webhooks by Zapier › POST. الصق Endpoint URL وأضف مفتاح API كما هو موضح على الشاشة. أو ابحث في Zapier عن “BytePhase” واربط باستخدام مفتاح API وAPI base URL.
   • n8n: أضف عقدة HTTP Request، وانقر Import cURL والصق مثال curl من Code examples.

   الأقسام التالية تبيّن ما تختاره داخل Zapier وn8n.

5. شغّل اختبارًا من أداتك: خطوة Test في Zapier، أو شغّل العقدة في n8n. ثم انقر Check now في BytePhase.

   ترى Test submission captured.

6. انقر Next عبر Match fields وIf customer exists، ثم انقر Activate integration.

تم!

الـ Zap أو سير العمل في n8n ينشئ الآن عملاء محتملين أو تسجيلات ذاتية في BytePhase في كل مرة يعمل فيها.

إعداد الـ Zap في Zapier

1. في Zapier، انقر Create، ثم Zap.

2. اختر التطبيق الذي تأتي منه بياناتك كمُشغِّل (trigger). في Google Forms، اختر New Form Response، لا New or Updated Form Response، وإلا فإن تعديل إجابة ينشئ عميلًا محتملًا ثانيًا.

3. انقر Test trigger ليجد Zapier إدخالًا حديثًا. إن لم يجد شيئًا، املأ نموذجك بنفسك مرة واختبر مجددًا.

4. أضف إجراءً: Webhooks by Zapier، ثم POST. املأه هكذا:

   • URL: قيمة Endpoint URL من BytePhase.
   • Payload Type: ‏Json. Wrap Request In Array: ‏No. Unflatten: ‏Yes.
   • Headers: أضف X-API-Key مع مفتاح API. وأضف أيضًا Content-Type وAccept، وقيمة كل منهما application/json.
   • Data: انسخ شكل مثال curl من Code examples. حقولك توضع داخل data. املأ كل قيمة من أداة الاختيار في Zapier بدلًا من كتابتها.

5. إن أردت، أضف خطوة Filter by Zapier قبل الإجراء. اسمح بمرور الإدخال فقط إذا كان فيه اسم وبريد إلكتروني أو رقم جوال. هذا يمنع الرسائل المزعجة.

6. بعد تفعيل التكامل في BytePhase، انقر Publish في Zapier.

إعداد سير العمل في n8n

يملأ Import cURL عقدة HTTP Request نيابة عنك. لملئها يدويًا بدلًا من ذلك:

1. اضبط Method على POST وURL على Endpoint URL من BytePhase.

2. أضف ترويستين (headers): X-API-Key مع مفتاح API، وContent-Type بقيمة application/json.

3. أرسل المحتوى بصيغة JSON، بنفس شكل مثال curl. حقولك توضع داخل data.

4. إذا كانت أسماء حقولك مختلفة عن أسماء BytePhase، أضف عقدة Set قبلها. غيّر الأسماء إلى ما يظهر في View available fields.

احفظ مفتاح API في بيانات الاعتماد (credentials) في n8n بدلًا من كتابته في العقدة، حتى لا يظهر إذا صدّرت سير العمل.

ما يستطيعه تطبيق BytePhase في Zapier

عند الربط عبر تطبيق BytePhase في Zapier، يمنحك ربط واحد:

• Triggers (يحدث شيء في BytePhase): طلب إصلاح جديد، أو عميل، أو عميل محتمل، أو دفعة، أو طلب إصلاح خارجي، أو تغيّر حالة طلب إصلاح.
• Actions (يفعل BytePhase شيئًا): إنشاء عميل، أو إنشاء عميل محتمل، أو إضافة تسجيل ذاتي.
• Search: البحث عن عميل.

معلومات مفيدة

• لرؤية كل إرسال وهل نجح، استخدم View activity في البطاقة.
• للقائمة الكاملة بالحقول التي يقبلها BytePhase، انقر View available fields في خطوة الربط، أو راجع developers.bytephase.com.
• إذا تسرّب مفتاح API، استخدم Rotate key في صفحة النشاط. ثم حدّث الـ Zap أو سير العمل بالمفتاح الجديد.
• إذا أعاد Zapier تنفيذ خطوة، قد ينشئ BytePhase سجلًا ثانيًا. اختيارك تحت If customer exists هو ما يمنع التكرار. في n8n، أضف ترويسة Idempotency-Key بقيمة فريدة لكل إدخال، حتى تُتجاهل إعادة المحاولة.