إعداد مشغّل ربط الويب

Documentation Index

Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt

Use this file to discover all available pages before exploring further.

​

متى تستخدم ربط الويب

​

إعداد خطوة بخطوة

​

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

1. اذهب إلى الإعدادات → سير العمل
2. انقر + سير عمل جديد
3. قم بتسميته (مثلًا، “إرسال نموذج الموقع”)

​

الخطوة 2: تهيئة مشغّل ربط الويب

1. انقر على كتلة المشغّل
2. اختر ربط الويب
3. ستتلقى عنوان URL فريدًا لربط الويب مثل:
   https://api.twenty.com/webhooks/workflow/abc123...
   
4. انسخ هذا العنوان URL - ستحتاج إليه لخدمتك الخارجية

​

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

1. انقر تحديد الجسم المتوقع
2. أدخل JSON نموذجيًا يطابق ما سترسله خدمتك:

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "company": "Acme Inc",
  "message": "Interested in your product"
}

3. انقر حفظ - سيؤدي هذا إلى إنشاء متغيّرات يمكنك استخدامها في الخطوات اللاحقة

​

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

1. أضف إجراء إنشاء سجل
2. حدِّد كائن الأشخاص
3. عيّن الحقول:

​

الخطوة 5: اختبار ربط الويب

curl -X POST https://api.twenty.com/webhooks/workflow/abc123... \
  -H "Content-Type: application/json" \
  -d '{"firstName":"Test","lastName":"User","email":"test@example.com"}'

1. أنشئ طلب POST إلى عنوان ربط الويب الخاص بك
2. عيّن ترويسة Content-Type إلى application/json
3. أضف جسم JSON الاختباري الخاص بك
4. أرسل وتحقّق من تشغيلات سير العمل

​

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

​

التعامل مع بُنى بيانات مختلفة

​

بيانات متداخلة

{
  "contact": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "source": "website"
}

​

المصفوفات

{
  "items": [
    {"name": "Product A", "qty": 2},
    {"name": "Product B", "qty": 1}
  ]
}

export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;
  return { items };
};

export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;

  return {
    product: {
      name: items[0]?.name || "",
      qty: items[0]?.qty || 0
    }
  };
};

​

ذات صلة

• مشغلات سير العمل
• إجراءات سير العمل