github-actions[bot]
9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
221 lines
12 KiB
Plaintext
221 lines
12 KiB
Plaintext
---
|
|
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).
|