التكاملات

يتصل NueForm بـ أي خدمة تمتلك API من خلال Data Nodes — موصل HTTP الشامل الخاص بك. بدلاً من التكاملات المبنية مسبقًا المحدودة، تحصل على تحكم كامل في كيفية تدفق بيانات النموذج إلى الخدمات الخارجية.

يغطي هذا الدليل الإعداد خطوة بخطوة لأكثر منصات الأتمتة شيوعًا، بالإضافة إلى التكامل المباشر مع API.

Zapier (أكثر من 8,000 تطبيق)

يربط Zapier نماذجك بأكثر من 8,000 تطبيق بما في ذلك Google Sheets و Slack و Salesforce و HubSpot و Mailchimp والمزيد.

كيف يعمل

يستخدم Zapier مشغل Catch Hook الذي ينشئ عنوان webhook URL فريدًا. يرسل Data Node الخاص بك بيانات النموذج إلى هذا العنوان، ويوجهها Zapier إلى أي تطبيق متصل.

الخطوة 1: إنشاء Zap مع مشغل Webhooks

1. سجل الدخول إلى zapier.com وانقر على Create Zap.
2. للمشغل، ابحث عن Webhooks by Zapier.
3. اختر الحدث Catch Hook.
4. انقر على Continue — سينشئ Zapier عنوان webhook URL فريدًا مثل:
   textنسخ

   https://hooks.zapier.com/hooks/catch/123456/abcdef/
   

5. انسخ هذا العنوان — ستحتاجه لـ Data Node الخاص بك.

الخطوة 2: تكوين Data Node الخاص بك

1. في منشئ NueForm، أضف Data Node إلى سير عمل النموذج.
2. اضبط ما يلي:
   • Method: POST
   • URL: الصق عنوان webhook الخاص بـ Zapier
   • Headers:
     jsonنسخ

     {
       "Content-Type": "application/json"
     }
     

   • Body: اربط حقول النموذج بجسم JSON:
     jsonنسخ

     {
       "name": "{{full_name}}",
       "email": "{{email}}",
       "message": "{{message}}",
       "submitted_at": "{{timestamp}}"
     }
     

   • Silent Mode: تفعيل (موصى به — بدون شاشة تحميل للمستجيب)

الخطوة 3: اختبار الاتصال

1. في Zapier، انقر على Test trigger — سينتظر طلبًا.
2. في NueForm، قم بمعاينة النموذج وأرسل استجابة تجريبية.
3. يجب أن يكتشف Zapier بيانات الاختبار ويعرض حقول النموذج.

الخطوة 4: إضافة الإجراء

1. عد إلى Zapier، انقر على + لإضافة إجراء.
2. اختر تطبيق الوجهة (مثل Google Sheets أو Slack أو HubSpot).
3. اربط الحقول من بيانات webhook بالإجراء.
4. اختبر وانشر Zap الخاص بك.

مثال: نموذج → Google Sheets

{
  "name": "{{full_name}}",
  "email": "{{email_address}}",
  "company": "{{company_name}}",
  "budget": "{{budget_range}}",
  "source": "NueForm Contact Form"
}

يرسل هذا كل إرسال نموذج كصف جديد في Google Sheets — تلقائيًا.

n8n (أكثر من 400 عقدة)

n8n هي منصة أتمتة سير عمل مفتوحة المصدر تحتوي على أكثر من 400 عقدة مدمجة. يمكن استضافتها ذاتيًا أو استخدامها عبر n8n Cloud.

كيف يعمل

يستخدم n8n عقدة Webhook كمشغل لسير العمل. تنشئ عنوان URL لنقطة النهاية يستدعيه Data Node لبدء سير العمل.

الخطوة 1: إنشاء سير عمل n8n مع مشغل Webhook

1. سجل الدخول إلى مثيل n8n الخاص بك (cloud أو مستضاف ذاتيًا).
2. أنشئ سير عمل جديدًا.
3. انقر على Add first step واختر On webhook call.
4. في إعدادات عقدة Webhook:
   • اضبط HTTP Method على POST
   • دوّن Test URL (للاختبار) و Production URL (للاستخدام الفعلي)
   • يبدو Production URL كالتالي:
     textنسخ

     https://your-instance.app.n8n.cloud/webhook/abc-123-def
     

5. انقر على Listen for test event لوضعه في وضع الاستماع.

الخطوة 2: تكوين Data Node الخاص بك

1. أضف Data Node إلى سير عمل NueForm.
2. قم بتكوينه:
   • Method: POST
   • URL: الصق عنوان webhook الخاص بـ n8n (استخدم Test URL للاختبار، Production URL عند التشغيل الفعلي)
   • Headers:
     jsonنسخ

     {
       "Content-Type": "application/json"
     }
     

   • Body:
     jsonنسخ

     {
       "respondent_email": "{{email}}",
       "answers": {
         "name": "{{name}}",
         "feedback": "{{feedback}}",
         "rating": "{{satisfaction_rating}}"
       }
     }
     

   • Silent Mode: تفعيل

الخطوة 3: بناء سير عمل n8n

بعد أن تستقبل عقدة Webhook البيانات، أضف أي عقد تحتاجها:

• Google Sheets — سجل الاستجابات في جدول بيانات
• Slack — أرسل إشعارًا لفريقك
• Email (SMTP) — أرسل بريد تأكيد إلكتروني
• HTTP Request — استدعِ API أخرى
• IF — وجّه البيانات شرطيًا بناءً على إجابات النموذج

الخطوة 4: التفعيل

1. اختبر بإرسال نموذج والتأكد من أن n8n يستقبل البيانات.
2. حوّل عنوان عقدة Webhook من Test إلى Production.
3. فعّل سير العمل (زر التبديل في الزاوية العلوية اليمنى).
4. حدّث عنوان Data Node إلى Production URL.

Make (أكثر من 3,000 تطبيق)

Make (المعروف سابقًا بـ Integromat) هو منصة أتمتة مرئية تحتوي على أكثر من 3,000 تكامل مع التطبيقات.

كيف يعمل

يستخدم Make وحدة Custom Webhook كمشغل للسيناريو. ينشئ عنوان URL يرسل إليه Data Node البيانات.

الخطوة 1: إنشاء سيناريو في Make

1. سجل الدخول إلى make.com وأنشئ سيناريو جديدًا.
2. انقر على زر + وابحث عن Webhooks.
3. اختر Custom webhook.
4. انقر على Add لإنشاء webhook جديد.
5. أعطه اسمًا (مثل "NueForm Contact Form").
6. ينشئ Make عنوان URL مثل:
   textنسخ

   https://hook.make.com/abcdefghijk123456
   

7. انسخ هذا العنوان.

الخطوة 2: تكوين Data Node الخاص بك

1. أضف Data Node إلى سير عمل NueForm.
2. اضبط:
   • Method: POST
   • URL: الصق عنوان webhook الخاص بـ Make
   • Headers:
     jsonنسخ

     {
       "Content-Type": "application/json"
     }
     

   • Body:
     jsonنسخ

     {
       "form_name": "Contact Form",
       "name": "{{full_name}}",
       "email": "{{email}}",
       "phone": "{{phone_number}}",
       "inquiry_type": "{{inquiry_type}}"
     }
     

   • Silent Mode: تفعيل

الخطوة 3: تحديد بنية البيانات

1. في Make، انقر على Run once في وحدة webhook.
2. أرسل استجابة تجريبية في NueForm.
3. سيكتشف Make بنية البيانات ويربط الحقول تلقائيًا.

الخطوة 4: إضافة الوحدات والتفعيل

1. أضف وحدات الوجهة (Google Sheets، CRM، البريد الإلكتروني، إلخ).
2. اربط حقول بيانات webhook بكل وحدة.
3. فعّل جدولة السيناريو.

IFTTT (أكثر من 1,000 خدمة)

يتصل IFTTT (If This Then That) بأكثر من 1,000 خدمة بما في ذلك أجهزة المنزل الذكي ووسائل التواصل الاجتماعي وتطبيقات الإنتاجية.

كيف يعمل

يستخدم IFTTT خدمة Webhooks مع مشغل Receive a web request. يطلق Data Node حدثًا إلى عنوان webhook الخاص بـ IFTTT.

الخطوة 1: إعداد IFTTT Webhooks

1. اذهب إلى ifttt.com وأنشئ Applet جديدًا.
2. لـ "If This"، ابحث عن Webhooks.
3. اختر Receive a web request.
4. أدخل اسم حدث (مثل nueform_submission).
5. لـ "Then That"، اختر خدمة الإجراء.

الخطوة 2: الحصول على عنوان Webhook

1. اذهب إلى ifttt.com/maker_webhooks.
2. انقر على Documentation.
3. سترى مفتاحك الفريد وتنسيق العنوان:
   textنسخ

   https://maker.ifttt.com/trigger/{event}/with/key/YOUR_KEY
   

4. استبدل {event} باسم الحدث الخاص بك:
   textنسخ

   https://maker.ifttt.com/trigger/nueform_submission/with/key/abc123xyz
   

الخطوة 3: تكوين Data Node الخاص بك

يقبل IFTTT Webhooks ما يصل إلى 3 قيم (value1، value2، value3):

1. أضف Data Node إلى سير عمل NueForm.
2. اضبط:
   • Method: POST
   • URL: عنوان webhook الخاص بك في IFTTT
   • Headers:
     jsonنسخ

     {
       "Content-Type": "application/json"
     }
     

   • Body:
     jsonنسخ

     {
       "value1": "{{full_name}}",
       "value2": "{{email}}",
       "value3": "{{message}}"
     }
     

   • Silent Mode: تفعيل

التكامل المباشر مع API

للتحكم الأقصى، استدعِ أي REST API مباشرة — بدون حاجة لوسيط.

مثال: الإرسال إلى الخادم الخاص بك

Method: POST
URL: https://api.yourapp.com/form-submissions
Headers:
{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}
Body:
{
  "form_id": "contact-form",
  "data": {
    "name": "{{name}}",
    "email": "{{email}}",
    "message": "{{message}}"
  }
}

مثال: الإضافة إلى CRM

Method: POST
URL: https://api.hubspot.com/crm/v3/objects/contacts
Headers:
{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_HUBSPOT_TOKEN"
}
Body:
{
  "properties": {
    "firstname": "{{first_name}}",
    "lastname": "{{last_name}}",
    "email": "{{email}}",
    "company": "{{company}}"
  }
}

مثال: إرسال رسالة Slack

Method: POST
URL: https://hooks.slack.com/services/T00/B00/xxxx
Headers:
{
  "Content-Type": "application/json"
}
Body:
{
  "text": "New form submission from {{name}} ({{email}}): {{message}}"
}

نصائح وأفضل الممارسات

استخدام Silent Mode

لمعظم التكاملات، فعّل Silent Mode حتى لا يرى المستجيب مؤشر التحميل. يتم تنفيذ الطلب في الخلفية.

معالجة الأخطاء

• إذا كانت الخدمة الخارجية معطلة، سيفشل طلب Data Node. فكر في تعيين Timeout معقول (5-10 ثوانٍ).
• للتكاملات الحرجة، فكر في استخدام Webhooks المدمجة في NueForm كنسخة احتياطية — فهي تعيد المحاولة عند الفشل.

ربط المتغيرات

استخدم صيغة {{variable_name}} (أقواس مزدوجة) في أجسام الطلبات لإدراج قيم إجابات النموذج. الأقواس المفردة {variable_name} تعمل في العناوين و headers.

راجع Variables للمرجع الكامل.

الاختبار

1. فعّل Debug Mode على Data Node أثناء التطوير لرؤية الطلب/الاستجابة الكاملة.
2. استخدم خدمة مثل webhook.site لفحص الحمولة الدقيقة التي يرسلها Data Node.
3. عطّل Debug Mode قبل النشر.

ذو صلة

• Data Nodes — مرجع تكوين Data Nodes الكامل
• Variables — صيغة استيفاء المتغيرات
• Webhooks — بديل webhook بعد الإرسال