# ربط واتساب الأعمال وإنشاء مفاتيح API في "إدارة علاقات العملاء"

> المصدر: https://help.getedara.com/ar/articles/90000050-%D8%B1%D8%A8%D8%B7-%D9%88%D8%A7%D8%AA%D8%B3%D8%A7%D8%A8-%D8%A7%D9%84%D8%A3%D8%B9%D9%85%D8%A7%D9%84-%D9%88%D8%A5%D9%86%D8%B4%D8%A7%D8%A1-%D9%85%D9%81%D8%A7%D8%AA%D9%8A%D8%AD-api-%D9%81%D9%8A-%D8%A5%D8%AF%D8%A7%D8%B1%D8%A9-%D8%B9%D9%84%D8%A7%D9%82%D8%A7%D8%AA-%D8%A7%D9%84%D8%B9%D9%85%D9%84%D8%A7%D8%A1 · التصنيف: إدارة علاقات العملاء › الإعداد والإدارة · English: https://help.getedara.com/en/articles/90000050-connecting-whatsapp-business-and-creating-api-keys-in-edara-crm

اربط رقم واتساب الأعمال الخاص بشركتك، فيرسل فريقك عروض الأسعار للعملاء من هذا الرقم مباشرة من النظام، بدل أن يرسلها كل مندوب من هاتفه الشخصي.

ومفاتيح API تتيح لأداة خارجية، مثل Zapier أو نظام شريك أو سكربت خاص بك، أن تقرأ من النظام أو ترسل إليه سجلات دون أن يسجّل أحد الدخول، وأنت تحدّد بالضبط ما يحقّ لكل مفتاح فعله.

## اتبع الخطوات

تبدأ بربط رقم واتساب الأعمال واختباره، ثم تنشئ مفاتيح API للأدوات الخارجية.

### ربط واتساب الأعمال

يستخدم الربط محرّك ويب واتساب غير رسمي، لذا قد يحظر واتساب الرقم. فاستخدم رقم أعمال مخصّصًا، وزِد عدد الرسائل تدريجيًا. ولربط الرقم:

1. من " **الإعدادات** " افتح " **واتساب** " تحت " **التكاملات** "، واقرأ تنبيه " **اقرأ هذا قبل الربط** "، ثم اضغط على " **ربط واتساب الأعمال** ".
2. تحت " **أضِف رقم عملك** " أدخِل الرقم المخصّص بالصيغة الدولية، مثل +201001234567، واضغط على " **متابعة** ".
3. يظهر رمز QR تحت " **امسح رمز QR بهاتفك** ". من الهاتف الذي يحمل الرقم افتح واتساب الأعمال ← الإعدادات ← الأجهزة المرتبطة ← ربط جهاز، وامسح الرمز. فتظهر " **واتساب الأعمال يعمل** " مع شارة " **متصل** ".

> **ملحوظة:** الضغط على "**ربط واتساب الأعمال**" يعني قبولك شروط التنبيه. وصفحة واتساب للمشرف فقط.

إذا انتهى الرمز قبل أن تمسحه، أو غيّرت رأيك في منتصف الطريق:

1. ينتهي الرمز خلال 20 ثانية تقريبًا، فاضغط على " **تحديث QR** " للحصول على رمز جديد.
2. لإيقاف الربط اضغط على " **إلغاء الإعداد** ".
3. أكّد في النافذة، فيُمسح الرقم وخطوة رمز QR، وتعود الصفحة إلى بدايتها.

### إرسال رسالة اختبارية

بعد الربط، تأكّد أن رسالة عرض السعر تصل وتظهر بشكل صحيح:

1. انتقل إلى بطاقة " **إرسال رسالة اختبارية** " تحت " **واتساب الأعمال يعمل** ".
2. أدخِل رقم هاتف تتحكّم به بالصيغة الدولية.
3. اضغط على " **إرسال اختباري** "، فتظهر رسالة " **تم الإرسال — تحقّق من الهاتف.** ". وراجع رسالة عرض السعر التجريبية على الهاتف.

> **ملحوظة:** إذا ظهر أن خدمة واتساب لم تردّ في الوقت المحدّد، فتحقّق من الهاتف قبل إعادة الإرسال، فقد تكون الرسالة وصلت بالفعل.

### إرسال عروض الأسعار من فريقك

بعد الربط يرسل فريقك عرض السعر من رقم عملك، من صفحة العرض نفسها:

1. افتح عرض السعر من تبويب " **عروض الأسعار** " في الصفقة.
2. اضغط على " **مشاركة** " واختر " **إرسال عبر واتساب الأعمال** "، فتظهر رسالة " **تم الإرسال إلى العميل عبر واتساب الأعمال** ".
3. إذا كان العميل قد استلم العرض من قبل، يسأل النظام " **هل تريد إرسال هذا العرض مرة أخرى؟** "، فاضغط على " **إرسال مرة أخرى** " فقط إن كنت تقصد ذلك.

> **ملحوظة:** يبقى "**إرسال عبر واتساب الأعمال**" معطّلًا حتى يُربط الرقم، وحين لا يكون لجهة الاتصال أو المؤسسة رقم هاتف. ويجب أن يكون هاتف العميل بالصيغة الدولية، مثل +20 100 123 4567. ويرسل كل الأدوار عدا المحلل والمُطّلع.

### فصل واتساب الأعمال

لإيقاف الإرسال من رقم العمل:

1. من " **الإعدادات** " ← " **واتساب** " اضغط على " **فصل** ".
2. أكّد الفصل في النافذة.
3. تعود الصفحة إلى زر " **ربط واتساب الأعمال** ". وحتى تعيد الربط، لا يستطيع المندوبون إلا استخدام " **فتح في واتساب الخاص بي** ".

### إنشاء مفتاح API

صفحة "**مفاتيح API**" تحت "**الفريق والصلاحيات**" في الإعدادات، وهي للمشرف فقط. ولإنشاء مفتاح:

1. اضغط على " **مفتاح جديد** ".
2. في " **إنشاء مفتاح API** " اكتب " **الاسم** " الذي يدلّ على من يستخدمه، مثل Zapier إنتاج. وتحت " **الصلاحيات** " حدّد فقط ما تحتاجه الأداة، صلاحية واحدة على الأقل.
3. اضغط على " **إنشاء** ". تعرض نافذة " **انسخ مفتاح API الجديد** " المفتاح كاملًا، فاضغط على " **نسخ المفتاح** " واحفظه في مكان آمن، ثم اضغط على " **إغلاق** ".

> **ملحوظة:** المفتاح يُعرض مرة واحدة. بعد إغلاق النافذة لا يعرض الجدول إلا أوله، ولا يستطيع النظام إظهاره مجددًا. فإن فقدته، احذفه وأنشئ مفتاحًا جديدًا.

الصلاحيات مقسّمة حسب السجلات: "**العملاء المحتملون**" و"**جهات الاتصال**" و"**المؤسسات**" و"**الصفقات**" و"**الأنشطة**" و"**الملاحظات**" لكلٍّ منها إنشاء وقراءة. و"**بيانات مرجعية**" للقراءة فقط: المسارات والمستخدمون والمنتجات والطلبات. أما "**تعيين التواريخ والأسعار الأصلية**" تحت "**الترحيل**" فهي فقط لنقل البيانات من نظام CRM آخر، لتحتفظ السجلات بتواريخها الأصلية.

### تعديل المفتاح أو تعطيله أو حذفه

يعرض الجدول لكل مفتاح "**الاسم**" وأول "**المفتاح**" وعدد "**الصلاحيات**" و"**تاريخ الإنشاء**" و"**آخر استخدام**" و"**الحالة**". ومن عمود "**إجراءات**":

1. " **تعديل** ": غيّر " **الاسم** " أو " **الصلاحيات** " واضغط على " **حفظ** ". ويظهر ما دام المفتاح نشطًا.
2. " **تعطيل** ": تتوقّف التكاملات التي تستخدم المفتاح حتى تضغط على " **تفعيل** ".
3. أيقونة الحذف: تزيل المفتاح نهائيًا، ويُرفض أي تكامل يستخدمه من تلك اللحظة. ولا يمكن التراجع.

> **ملحوظة:** راجع عمود "**آخر استخدام**" قبل أن تعطّل مفتاحًا أو تحذفه، لتعرف هل ما زال مستخدمًا. وفي سجل التغييرات يظهر التعديل الذي تمّ عبر مفتاح بصيغة «بواسطة الاسم (اسم المفتاح)».

### ما تعطيه للمطوّر

بطاقة "**كيفية الاستخدام**" أسفل الجدول فيها كل ما يحتاجه من يربط الأداة:

1. انسخ معرّف المستأجر الخاص بك بزر " **نسخ** " بجواره.
2. يوضح المثال أن المفتاح يُرسل في ترويسة X-API-Key أو كرمز Bearer، ومعه دائمًا ترويسة Tenantid.
3. اضغط على " **فتح توثيق الـ API** " للمرجع الكامل.

> **ملحوظة:** أرسل للمطوّر المفتاح وهذه البطاقة، لا بيانات دخولك أنت. وتعامل مع المفاتيح كأنها كلمات مرور: لا تلصقها في المحادثات، واستخدم مفتاحًا لكل تكامل، لتوقف واحدًا دون أن تعطّل الباقي.

### عند تعطيل من أنشأ المفتاح

من أنشأ المفتاح رآه كاملًا وقد تكون لديه نسخة منه، لذا يتوقّف المفتاح عن العمل فور تعطيل حسابه:

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

> **ملحوظة:** قبل تعطيل شخص من صفحة الأعضاء، يخبرك النظام بعدد المفاتيح النشطة التي أنشأها. وإذا أعدت تفعيل حسابه، تعود مفاتيحه إلى العمل.

## انتبه لهذه النقاط

- صفحتا " **واتساب** " و" **مفاتيح API** " للمشرف فقط.
- المفتاح يعمل باسم مساحة العمل كلها لا باسم شخص واحد، لذا امنح الصلاحيات التي تحتاجها الأداة فقط.
- لإرسال عروض الأسعار وخيارات المشاركة الأخرى راجع [إنشاء عروض الأسعار وإرسالها للعملاء في "إدارة علاقات العملاء"](https://help.getedara.com/ar/articles/90000039-%D8%A5%D9%86%D8%B4%D8%A7%D8%A1-%D8%B9%D8%B1%D9%88%D8%B6-%D8%A7%D9%84%D8%A3%D8%B3%D8%B9%D8%A7%D8%B1-%D9%88%D8%A5%D8%B1%D8%B3%D8%A7%D9%84%D9%87%D8%A7-%D9%84%D9%84%D8%B9%D9%85%D9%84%D8%A7%D8%A1-%D9%81%D9%8A-%D8%A5%D8%AF%D8%A7%D8%B1%D8%A9-%D8%B9%D9%84%D8%A7%D9%82%D8%A7%D8%AA-%D8%A7%D9%84%D8%B9%D9%85%D9%84%D8%A7%D8%A1) . ولتعطيل الأعضاء راجع [دعوة الأعضاء وضبط الأدوار والفرق في "إدارة علاقات العملاء"](https://help.getedara.com/ar/articles/90000046-%D8%AF%D8%B9%D9%88%D8%A9-%D8%A7%D9%84%D8%A3%D8%B9%D8%B6%D8%A7%D8%A1-%D9%88%D8%B6%D8%A8%D8%B7-%D8%A7%D9%84%D8%A3%D8%AF%D9%88%D8%A7%D8%B1-%D9%88%D8%A7%D9%84%D9%81%D8%B1%D9%82-%D9%81%D9%8A-%D8%A5%D8%AF%D8%A7%D8%B1%D8%A9-%D8%B9%D9%84%D8%A7%D9%82%D8%A7%D8%AA-%D8%A7%D9%84%D8%B9%D9%85%D9%84%D8%A7%D8%A1) .

## حان وقت التجربة

بيانات تجريبية — لا تُؤثر على أي بيانات حقيقية. اضغط "ربط واتساب الأعمال" وأكمل الخطوات حتى ترسل رسالة اختبارية، ثم افتح "مفاتيح API" من القائمة وأنشئ مفتاحًا.

## قد تتساءل

**هل يمكن أن يُحظر رقم واتساب الأعمال بعد الربط؟**

نعم، لأن الربط يستخدم محرّك ويب واتساب غير رسمي. قلّل المخاطرة برقم أعمال مخصّص، ورسائل بقوالب، وزيادة تدريجية في عدد الرسائل.

**لماذا زر "إرسال عبر واتساب الأعمال" معطّل؟**

لأن الرقم لم يُربط بعد من "الإعدادات" ثم "واتساب"، أو لأن جهة الاتصال أو المؤسسة ليس لها رقم هاتف.

**نسيت نسخ مفتاح API، هل يمكنني رؤيته مرة أخرى؟**

لا. المفتاح يُعرض مرة واحدة فقط عند إنشائه. احذفه وأنشئ مفتاحًا جديدًا، ثم ضعه في التكامل.

**لماذا ظهر مفتاح بحالة "متوقّف"؟**

لأن حساب من أنشأه تم تعطيله. أنشئ مفتاحًا جديدًا واحذف القديم، أو أعد تفعيل حساب هذا الشخص فتعود مفاتيحه إلى العمل.