> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkiasoft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# أودو: انسخ عملاءك المحتملين إلى Odoo CRM

> كل عميل محتمل يُلتقط في لينكياسوفت يصبح crm.lead في أودو لديك، ويبقى متوافقًا معه.

إذا كان فريق مبيعاتك يعمل على أودو، فاربطه ليظهر كل عميل محتمل يُلتقط هنا — مكتوبًا يدويًا، أو
منشأً عبر الـ API، أو منشأً تلقائيًا من محادثة واتساب — في أودو أيضًا، ويتحدث مع تنقله في مسارك.

والمزامنة **باتجاه واحد**. فلينكياسوفت هو مصدر الحقيقة، وأودو يستقبل نسخة. والتغييرات داخل أودو لا
تُقرأ.

## ما تحتاجه من أودو

<Steps>
  <Step title="مستخدم للتكامل">
    أنشئ مستخدم أودو مخصصًا بدل إعادة استخدام حساب شخص. فحين يغادر أحدهم ويُعطَّل حسابه، يسقط معه
    التكامل المبني على حساب شخصي.

    ويحتاج المستخدم صلاحية الإنشاء والكتابة في **CRM**.
  </Step>

  <Step title="مفتاح API لذلك المستخدم">
    في أودو: **التفضيلات ← أمان الحساب ← مفتاح API جديد**. ويعرضه أودو مرة واحدة.

    وعلى Odoo Online تتطلب مفاتيح API تفعيل المصادقة الثنائية على الحساب أولًا — وسيخبرك أودو إن
    لم تكن مفعّلة.
  </Step>

  <Step title="اسم قاعدة بياناتك">
    يظهر في **الإعدادات ← الإعدادات العامة ← أدوات المطوّر ← تفعيل وضع المطوّر**، أو في الرابط على
    Odoo Online. فخادم أودو قد يستضيف عدة قواعد بيانات، ولا يمكن تخمينها من العنوان.
  </Step>
</Steps>

## اربطه

**التكاملات ← أودو CRM** في لينكياسوفت، ثم املأ:

| الحقل          | مثال                      |
| -------------- | ------------------------- |
| رابط النسخة    | `https://acme.odoo.com`   |
| قاعدة البيانات | `acme-production`         |
| اسم دخول أودو  | `integrations@acme.com`   |
| مفتاح API      | المفتاح من الخطوة السابقة |

اضغط **اختبار الاتصال** قبل الحفظ. فنحن نصادق على النسخة ونبلّغ بما قاله أودو فعلًا، وهو أنفع
بكثير من اكتشاف المشكلة لاحقًا عبر عملاء محتملين لا يصلون أبدًا.

<Note>
  الحفظ يعيد الاختبار دائمًا. فلا يمكن تخزين اتصال غير متحقَّق منه — وتلك هي الحالة التي يبدو فيها
  التكامل مربوطًا على الشاشة ولم يعمل قط.
</Note>

وإعدادان اختياريان:

* **إنشاء العملاء المحتملين كـ** — فرص أو عملاء محتملين. ومعظم إعدادات أودو تخفي مرحلة العملاء
  المحتملين المنفصلة، فالفرص هي الافتراضي وهي الصحيح عادةً.
* **معرّف فريق المبيعات** — لتصنيف كل شيء تحت فريق مبيعات واحد في أودو. اتركه فارغًا ليتولى أودو
  التوجيه.

## ما الذي يُرسَل

| لينكياسوفت                          | أودو                                       |
| ----------------------------------- | ------------------------------------------ |
| اسم العميل المحتمل                  | `contact_name`، وعنوان الفرصة              |
| الشركة                              | `partner_name`                             |
| البريد الإلكتروني                   | `email_from`                               |
| الهاتف                              | `phone`                                    |
| القيمة والعملة                      | `expected_revenue`، `currency_id`          |
| الاحتمالية                          | `probability`                              |
| الأولوية                            | `priority`                                 |
| تاريخ الإغلاق المتوقع               | `date_deadline`                            |
| الوسوم                              | `tag_ids`، وتُنشأ في أودو إن لم تكن موجودة |
| المصدر والقطاع ونوع العميل والمرحلة | تُضاف إلى الوصف، مع رابط للرجوع            |

<Note>
  **العملاء المحتملون يصلون بلا إسناد.** فنحن لا نضبط مندوب مبيعات عمدًا، حتى تقرر قواعد الإسناد في
  أودو وتوجيه فرق المبيعات من يلتقط العميل المحتمل — وهو ما وُجدت من أجله. أما إسناد كل عميل محتمل
  إلى حساب التكامل نفسه فسيجعل ذلك المستخدم المالك المسجَّل لمسارك كله.
</Note>

### العملاء المحتملون من واتساب وانستجرام

العميل الذي يراسلك قد لا يملك بريدًا إلكترونيًا. ولأن سجلات العملاء المحتملين لدينا تشترط واحدًا،
تحصل هذه السجلات على بريد بديل مثل
`social.whatsapp.a1b2c3@noreply.crm`.

ونحن نزيله قبل الإرسال. فلا يحصل سجل أودو على `email_from` إطلاقًا، وتُضاف ملاحظة في الوصف تفيد
بأن العميل المحتمل جاء من محادثة اجتماعية. فالعنوان البديل كان سيفسد كشف التكرار في أودو ويعطي
فريقك عنوانًا يرتد فورًا.

## التكرارات

قبل إنشاء أي شيء، نبحث عن عميل محتمل قائم في أودو بالبريد أو الهاتف نفسه — مع مقارنة أرقام الهواتف
بآخر تسعة أرقام، حتى يتطابق `+20 100 123 4567` و`01001234567` بدل أن يصبحا سجلين.

وعند التطابق **نحدّث ذلك السجل** بدل إنشاء ثانٍ. والعملاء المحتملون المؤرشفون والخاسرون مشمولون في
الفحص: فإعادة إنشاء عميل أغلقه مندوب عمدًا هو بالضبط التكرار الذي يستحق التجنب.

## البقاء محدّثًا

تعديل عميل محتمل أو نقله إلى مرحلة أخرى يحدّث سجل أودو نفسه. فنحن نخزّن معرّف أودو على العميل
المحتمل، فلا تخمين ولا انحراف.

وتعرض لوحة الصحة في صفحة التكامل عدد العملاء المحتملين الذين تمت مزامنتهم، وكم فشل، ومتى كان آخر
دفع ناجح. و**إعادة محاولة الفاشل** تعيد إلى الطابور كل ما لم ينجح — ومفيدة بعد إصلاح بيانات
الاعتماد أو مشكلة صلاحيات في أودو.

<Note>
  الدفع يحدث في الخلفية. فحفظ عميل محتمل لا ينتظر أودو أبدًا، ولا تستطيع نسخة بطيئة أو غير متاحة أن
  تبطئ نظامك. ويعني هذا أيضًا أن العميل المحتمل قد يوجد هنا لثوانٍ قبل ظهوره هناك.
</Note>

## عندما لا يصل العملاء المحتملون

عدّاد **الفاشل** في لوحة الصحة والخطأ المسجَّل على كل عميل محتمل هما نقطة البداية.

| ما تراه                          | يعني عادةً                                                                                |
| -------------------------------- | ----------------------------------------------------------------------------------------- |
| الاتصال موسوم بـ*تحتاج انتباهًا* | رفض أودو بيانات الاعتماد — أُبطل مفتاح API، أو أُوقفت المصادقة الثنائية. أعد إدخالها.     |
| إخفاقات تذكر صلاحيات الوصول      | مستخدم التكامل يفتقر إلى صلاحية الإنشاء أو الكتابة في CRM.                                |
| كل شيء متخطّى                    | الاتصال معطّل. أعد حفظه.                                                                  |
| لا شيء إطلاقًا، ولا صفوف         | لم يكن هناك اتصال فعّال وقت إنشاء هؤلاء العملاء المحتملين. اربط ثم **أعد محاولة الفاشل**. |

<Warning>
  قطع الربط يحتفظ بالروابط بين عملائك المحتملين وسجلاتهم في أودو. وهذا مقصود — فإعادة ربط النسخة
  نفسها تكمل من حيث توقفت بدل تكرار كل عميل محتمل لديك. أما إن ربطت أودو *مختلفًا*، فتوقع أن تكون
  الروابط الحالية قديمة.
</Warning>