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

# Salesforce

> مزامنة جهات اتصال Wave إلى Salesforce كـ Leads أو Contacts

<Info>
  متاح في خطط **Pro** و**Teams** و**Enterprise**.
</Info>

يزامن تكامل Salesforce جهاتِ اتصال Wave إلى Salesforce إما كـ Leads أو Contacts حسب اختيارك عند الإعداد. يستخدم Wave حقل معرّف خارجي مخصصاً لـ upsert السجلات، مما يمنع التكرار حتى لو كان السجل موجوداً مسبقاً. تُدعم بيئتا Salesforce الإنتاجية والاختبارية (sandbox).

## كيفية الاتصال

<Steps>
  <Step title="فتح التكامل">
    انتقل إلى **التكاملات → Salesforce**.
  </Step>

  <Step title="اختيار نوع السجل">
    اختر ما إذا كنت تريد مزامنة جهات الاتصال كـ **Leads** أو **Contacts**.
  </Step>

  <Step title="تفعيل المزامنة التلقائية (اختياري)">
    شغّل **المزامنة التلقائية** لاستيراد جميع جهات اتصال Wave الموجودة فوراً.
  </Step>

  <Step title="الاتصال بـ Salesforce">
    انقر على **اتصال** وسجّل الدخول إلى حساب Salesforce الخاص بك.
  </Step>
</Steps>

يطلب Wave الوصول غير المتصل (للحفاظ على الاتصال نشطاً دون تسجيلات دخول متكررة) ووصول القراءة/الكتابة لإنشاء السجلات وتحديثها في Salesforce.

## ما الذي يُزامَن

| حقل Wave                  | حقل Salesforce                       |    Leads    | Contacts |
| ------------------------- | ------------------------------------ | :---------: | :------: |
| الاسم الأول               | `FirstName`                          |     نعم     |    نعم   |
| اسم العائلة               | `LastName`                           |     نعم     |    نعم   |
| البريد الإلكتروني الأساسي | `Email`                              |     نعم     |    نعم   |
| الهاتف الأساسي            | `Phone`                              |     نعم     |    نعم   |
| المسمى الوظيفي            | `Title`                              |     نعم     |    نعم   |
| الشركة                    | `Company`                            | نعم (مطلوب) |     -    |
| ملاحظة جهة الاتصال        | `Description`                        |     نعم     |    نعم   |
| مصدر العميل المحتمل       | `LeadSource` = "Wave Connect"        |     نعم     |     -    |
| عضو الفريق المُعيَّن      | `OwnerId` (تطابق بالبريد الإلكتروني) |     نعم     |    نعم   |

**اتجاه المزامنة**: Wave → Salesforce (صادر فقط)

**وقت المزامنة**: في الوقت الفعلي عند إنشاء جهة اتصال أو تحديثها أو حذفها

## الميزات

* **Leads أو Contacts**: اختر نوع سجل Salesforce الذي يناسب سير عملك.
* **دعم Sandbox**: الاتصال ببيئة Salesforce الاختبارية للاختبار.
* **المزامنة التلقائية عند الاتصال**: استيراد جميع جهات اتصال Wave الموجودة عند الاتصال الأول.
* **إلغاء الازدواجية**: يُنشأ حقل معرّف خارجي مخصص (`WaveConnectId__c`) تلقائياً ويُستخدم لـ upserts، لذا لا تنشئ إعادة المزامنة تكرارات أبداً.
* **تعيين المالك**: تُعيَّن جهات الاتصال إلى مستخدم Salesforce الذي يتطابق بريده الإلكتروني مع عضو فريق Wave.

## إضافة حقل المعرّف الخارجي يدوياً

تُنشئ Wave حقل `WaveConnectId__c` للمعرّف الخارجي تلقائياً عند الاتصال. تحتاج إلى هذه الخطوة فقط إذا اتصلت **بدون حساب مسؤول Salesforce**، لأن إنشاء حقل مخصص يتطلب أذونات مسؤول. في هذه الحالة، اطلب من مسؤول Salesforce إضافة الحقل يدوياً.

<Steps>
  <Step title="فتح كائن Lead">
    في **الإعداد** في Salesforce، افتح **Object Manager** وحدد كائن **Lead**.
  </Step>

  <Step title="التحقق من الحقل">
    ضمن **الحقول والعلاقات**، تحقق من وجود `WaveConnectId__c`.
  </Step>

  <Step title="إنشاء الحقل">
    إذا لم يكن موجوداً، انقر على **جديد**، واختر **نص** كنوع الحقل، وسمّه بحيث يكون اسم API هو `WaveConnectId__c`.
  </Step>

  <Step title="ضبط أمان مستوى الحقل">
    تأكد من أن **المستخدم القياسي** لديه وصول للقراءة/الكتابة على الحقل.
  </Step>

  <Step title="الإضافة إلى تخطيطات الصفحات والحفظ">
    أضف الحقل إلى تخطيطات الصفحات ذات الصلة، ثم احفظ.
  </Step>
</Steps>

<Note>
  إذا كان الحقل موجوداً بالفعل، افتحه وحدد **ضبط أمان مستوى الحقل** للتأكد من أن **المستخدم القياسي** لديه وصول للقراءة/الكتابة. للتفاصيل الكاملة، راجع [دليل إعداد Salesforce](https://support.wavecnct.com/en/articles/10492839-salesforce).
</Note>

## القيود والمتطلبات

* يُنشأ الحقل المخصص `WaveConnectId__c` تلقائياً في حساب Salesforce الخاص بك. لا تحذفه ولا تعيد تسميته. يُستخدم لإلغاء الازدواجية.
* بالنسبة لـ Leads، يتطلب Salesforce حقل `Company`. إذا لم يكن لجهة اتصال Wave شركة، فإنها تأخذ قيمة `N/A` افتراضياً.
* إذا اكتشف Salesforce تكراراً عبر قواعد الكشف عن التكرار، فإن Wave يتجاوز القاعدة ويحفظ السجل.
* تطابق المالك يعتمد على البريد الإلكتروني. إذا لم يُعثر على مستخدم Salesforce مطابق، تُحفظ جهة الاتصال بدون مالك.

## قطع الاتصال

انتقل إلى **التكاملات → Salesforce** وانقر على **قطع الاتصال**. سيزيل ذلك التكامل ويُلغي وصول Wave. لن تُحذف السجلات التي تمت مزامنتها بالفعل إلى Salesforce.