---
title: تكامل أداة خارجية
info: These workflows focus on bringing data in and out of Twenty through API calls and webhooks.
image: /images/user-guide/integrations/plug.png
sectionInfo: أتمتة العمليات والاندماج مع الأدوات الخارجية
---

<Frame>
  <img src="/images/user-guide/integrations/plug.png" alt="Header" />
</Frame>

Below are workflow examples you could roll out to connect Twenty with the rest of your stack.

## حالات استخدام استيعاب البيانات

### تقديمات نماذج الويب

**Problem**: You need to capture leads from website forms, landing pages, or contact forms directly into Twenty.

**Solution**: Use webhook triggers to automatically create records from form submissions.

**الإعداد**:

- Create a workflow with a Webhook trigger
- Configure the webhook to expect form data (name, email, company, etc.)
- تعيين طريقة الويب هوك إلى POST
- تحديد هيكل الجسم المتوقع في المشغل

**مشغل**: ويب هوك (طلب POST من النموذج الخاص بك)

**الإجراءات**:

- بحث في السجلات للتحقق مما إذا كان الفرد/الشركة موجودًا بالفعل
- فرع: إذا كان موجودًا → تحديث سجل، وإذا لم يكن → إنشاء سجل
- إنشاء سجل لمهمة المتابعة المعينة لممثل المبيعات
- إرسال إشعار عبر البريد الإلكتروني إلى فريق المبيعات

### مزامنة بيانات المنتجات

**المشكلة**: يحتاج فريق المبيعات لديك إلى رؤية لبيانات استخدام المنتج، الفوترة، أو تبني الميزات المخزنة في مستودع البيانات.

**الحل**: قم بمزامنة بيانات المنتج بانتظام إلى Twenty لتزويد البائعين بسياق عن حساباتهم.

**مشغل**: وفقا لجدول زمني (يومي أو أسبوعي)

**الإجراءات**:

- طلب HTTP إلى واجهة برمجة تطبيق المستودع الخاص بك
- Code action to process and format the data
- استخدام وظيفة المحدد للخطوات التالية
- البحث في السجلات للعثور على سجلات الشركات المطابقة
- تحديث السجل لإضافة مقاييس استخدام المنتج
- إنشاء سجل للمهام عندما ينخفض الاستخدام دون العتبة

### ملاحظات الاجتماع من مسجلات المكالمات

**المشكلة**: تفقد الأفكار المهمة من اتصالات المبيعات أو لا يتم توثيقها بشكل صحيح في CRM.

**الحل**: إنشاء ملاحظات وعناصر عمل تلقائيًا من أنظمة تسجيل المكالمات.

**مشغل**: ويب هوك (من منصة تسجيل المكالمات)

**الإجراءات**:

- إجراء برمجة لاستخراج ملخص الاجتماع وعناصر العمل
- البحث في السجلات للعثور على الفرصة أو الاتصال ذو الصلة
- إنشاء سجل لملاحظة مع ملخص الاجتماع
- إنشاء سجل لمهام المتابعة بناءً على عناصر العمل
- إرسال بريد الإلكتروني للمشاركين مع ملخص وخطوات تالية

### إثراء البيانات

**المشكلة**: تفتقر سجلات الاتصال والشركة إلى معلومات ديموغرافية وفيرمولافية مهمة.

**الحل**: إثراء السجلات تلقائيًا باستخدام مزودي البيانات الخارجيين.

**مشغل**: يتم إنشاء السجل (كائن الأشخاص أو الشركات)

**الإجراءات**:

- طلب HTTP إلى واجهة برمجة تطبيق الإثراء
- إجراء برمجة لمعالجة استجابة الإثراء
- استخدام وظيفة المحدد للخطوات التالية
- تحديث السجل بمعلومات إضافية عن الشركة/الاتصال
- إنشاء سجل لمهمة مبيعات إذا تم تحديد عميل ذو قيمة عالية
- إرسال تنبيه عبر البريد الإلكتروني إذا كشف الإثراء عن إشارات شراء رئيسية

## حالات استخدام توزيع البيانات

### إدارة مشتركي النشرة الإخبارية

**المشكلة**: تريد إرسال رسائل بريد إلكتروني تسويقية إلى شرائح معينة من بيانات نظام إدارة علاقات العملاء الخاص بك باستخدام أدوات بريد إلكتروني متخصصة.

**الحل**: قم بتصدير قوائم المشتركين إلى منصة التسويق عبر البريد الإلكتروني الخاصة بك عند الحاجة.

**الإعداد**: قم بإنشاء عرض في Twenty مع جميع مستلمي النشرة الإخبارية

**التفعيل**: تشغيل يدوي (عند عدم تحديد أي سجل)

**الإجراءات**:

- البحث في السجلات باستخدام معايير عرض النشرة الإخبارية
- إجراء برمجي لتنسيق عناوين البريد الإلكتروني لمنصتك البريدية
- طلب HTTP لإضافة المشتركين إلى أداة التسويق عبر البريد الإلكتروني الخاصة بك
- إنشاء سجل لتتبع الحملة
- إرسال تأكيد البريد الإلكتروني لفريق التسويق

### مُحفِّزات تسلسل البريد الإلكتروني

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

**الحل**: أرسل عملاء جدد أو عملاء إلى منصة الأتمتة البريدية الخاصة بك عند حدوث أحداث معينة.

**Trigger**: Record is Created (People object with specific criteria)

**الإجراءات**:

- إجراء برمجي لتحديد تسلسل البريد الإلكتروني المناسب
- طلب HTTP لإضافة الاتصال إلى منصة الأتمتة البريدية
- تحديث السجل لتتبع الالتحاق بالتسلسل
- إنشاء سجل لمهمة متابعة لمراقبة التفاعل

### تكامل تصنيف العملاء المحتملين

**المشكلة**: تحتاج إلى تصنيف متقدم للعملاء المحتملين يجمع بيانات نظام إدارة علاقات العملاء مع الإشارات الخارجية.

**الحل**: أرسل بيانات العملاء المحتملين إلى أدوات التصنيف الخارجية أو قم بتطبيق منطق التصنيف ضمن سير الأعمال.

**الخيار 1 - أداة خارجية**:

**المحفز**: يتم تحديث السجل (جسم الأشخاص)

**الإجراءات**:

- طلب HTTP لإرسال بيانات العميل المحتمل إلى منصة التصنيف
- إجراء برمجي لمعالجة استجابة التصنيف
- تحديث السجل بنتيجة التصنيف
- إنشاء سجل لمهمة مبيعات إذا تجاوزت النتيجة الحد المطلوب

**الخيار 2 - المنطق الداخلي**:

**المحفز**: يتم تحديث السجل (جسم الأشخاص)

**الإجراءات**:

- إجراء برمجي مع خوارزمية التصنيف (حجم الشركة، الصناعة، السلوك)
- تحديث السجل بالنتيجة المحسوبة
- إرسال تنبيه بريدي لمندوب المبيعات للعملاء ذوي التصنيف العالي

### توليد الفواتير

**المشكلة**: عندما تُغلق الصفقات، يحتاج نظام الفوترة الخاص بك إلى التحديث بمعلومات العميل والصفقة.

**الحل**: إرسال بيانات الصفقة تلقائيًا إلى نظام الفوترة الخاص بك عند الفوز بالفرص.

**المحفز**: يتم تحديث السجل (جسم الفرص، المرحلة = "الإغلاق تم")

**الإجراءات**:

- البحث في السجلات للحصول على معلومات العميل الكاملة
- إجراء برمجي لتنسيق البيانات لنظام الفوترة
- طلب HTTP لإنشاء عميل في منصة الفوترة
- طلب HTTP لتوليد فاتورة
- تحديث السجل لحفظ مرجع الفاتورة
- إرسال بريد إلكتروني لفريق المالية بتفاصيل الفاتورة

## أنماط تكامل متقدمة

### مزامنة ثنائية الاتجاه

**المشكلة**: تحتاج إلى مزامنة البيانات بين Twenty ونظام آخر في كلا الاتجاهين.

**الحل**: اجمع بين سير العمل المجدول ومُحَفِّزات ويب الهوك للمزامنة في الوقت الفعلي.

**من Twenty إلى النظام الخارجي**:

**المحفز**: يتم تحديث السجل (أي كائن ذو صلة)

**الإجراءات**:

- طلب HTTP لتحديث النظام الخارجي
- تحديث السجل لتتبع حالة المزامنة والطابع الزمني

**من النظام الخارجي إلى Twenty**:

**المحفز**: ويب هوك (من النظام الخارجي)

**الإجراءات**:

- البحث في السجلات للعثور على السجل المطابق
- تحديث السجل بالبيانات الجديدة من النظام الخارجي
- إنشاء سجل لمهمة حل النزاعات إذا لزم الأمر

### معالجة البيانات متعددة الخطوات

**المشكلة**: تحتاج البيانات من المصادر الخارجية إلى معالجة معقدة قبل أن يمكن استخدامها في Twenty.

**الحل**: استخدم إجراءات البرمجة لتحويل البيانات والتحقق من صحتها.

**المحفز**: ويب هوك أو على جدول

**الإجراءات**:

- إجراء برمجي للتحقق من صحة تنسيق البيانات القادمة
- إجراء برمجي لتحويل هيكل البيانات
- إجراء برمجي لتطبيق القواعد التجارية والحسابات
- البحث في السجلات للتحقق من التكرارات
- إنشاء أو تحديث سجل بالبيانات المعالجة
- إرسال تنبيه بالبريد الإلكتروني إذا تم اكتشاف مشاكل في جودة البيانات

## نصائح التنفيذ

- قم بتخزين مفاتيح API بأمان في إعدادات → API & Webhooks
- استخدم HTTPS لجميع الاتصالات بـ external API
- كن حريصًا على حدود نسبة API - استخدم سير العمل المجدول عند الإمكان
- فكر في التحديثات الدفعية "على الجدول" عندما لا تكون المعالجة في الوقت الفعلي مطلوبة
- تذكر حد 100 عنصر سير عمل متزامن لكل مساحة عمل - استخدم "التوافر بالجملة" للقيام بتشغيلات يدوية عند معالجة سجلات متعددة (اضطلع على [ميزات سير العمل](/l/ar/user-guide/workflows/workflow-features) لمزيد من التفاصيل)
- اختبر بالبيانات التجريبية قبل تفعيل سير العمل

للحصول على مساعدة في تنفيذ القضايا التكاملية، راجع [دليل استكشاف أخطاء سير العمل وإصلاحها](/l/ar/user-guide/workflows/workflow-troubleshooting). للحصول على مساعدة في تنفيذ التكاملات المعقدة، فكر في [خدمات المحترفين](/l/ar/user-guide/workflows/professional-services).