# واجهة برمجة تطبيقات واتساب للأعمال

يدعم منشئ MaviBot أيضًا واجهة برمجة تطبيقات WhatsApp Business الرسمية.

## كيفية ربط WhatsApp Business

 لربط واجهة برمجة تطبيقات WhatsApp Business (WABA) بمشروعك، انتقل إلى **الرسائل** وانتقل إلى **واجهة برمجة تطبيقات WhatsApp Business**.

<div data-with-frame="true"><figure><img src="/files/4448dd96ebe41613e6aa1a2f54d3b8c516ec6e14" alt=""><figcaption></figcaption></figure></div>

**ربط واجهة برمجة تطبيقات WhatsApp Business**

<div data-with-frame="true"><figure><img src="/files/c8acef9558ca77257620fe3d6585559d18f250b4" alt=""><figcaption></figcaption></figure></div>

في النافذة التي تفتح، سجّل الدخول باستخدام حسابك على Facebook. ثم انقر على زر "الاتصال عبر Facebook".&#x20;

إذا لزم الأمر، أدخل كلمة مرور Facebook للمتابعة.

<div data-with-frame="true"><figure><img src="/files/abf2b452b0db4d9d11c42f7ca1830979bbe77a97" alt="" width="563"><figcaption></figcaption></figure></div>

اكتمل الإعداد الآن. لست بحاجة إلى إبقاء هاتفك متصلاً بالإنترنت طوال الوقت؛ فسيعمل الروبوت بثبات واستقلالية.

## قوالب الرسائل لواجهة برمجة تطبيقات WhatsApp Business

عند استخدام واجهة برمجة تطبيقات WhatsApp Business، لا يمكن للمستخدمين مراسلة العملاء في أي وقت من اليوم وإرسال عدد غير محدود من الرسائل عند إنشاء روبوت، على غرار WhatsApp الرمادي، خارج نافذة خدمة العملاء التي مدتها 24 ساعة.

خارج نافذة الـ24 ساعة، لا يمكن استخدام سوى قوالب رسائل WhatsApp (أو رسائل قوالب WhatsApp)، وخلالها تتم المراسلة مجانًا ضمن الفئة المحددة.

تُستخدم هذه الوظيفة في WhatsApp لمنع الرسائل المزعجة عبر تحديد عدد الرسائل المسموح بها في فترة زمنية معينة، وكذلك عبر تعيين فئة للقوالب.

تم تثبيت الفئات التالية للرسائل في WhatsApp Business Api بواسطة Meta:

1\. قوالب مفيدة (تتضمن معلومات محددة حول المعاملات والفواتير والمدفوعات وما إلى ذلك);

2\. قوالب للتسويق (معلومات عن الشركة أو المنظمة أو الاستراتيجيات أو الإعلان والترويج);

3\. قوالب للتحقق والمصادقة.

<div data-with-frame="true"><figure><img src="/files/77aa4aedfc159da2e5654c5d0237fdc12f3417eb" alt="" width="563"><figcaption></figcaption></figure></div>

تخضع القوالب التي يتم إنشاؤها لـ WABA للمراجعة.

### الأسباب الرئيسية لرفض القالب

يفشل عدد كبير من القوالب في اجتياز مراجعة WhatsApp لعدة أسباب:

1. **الإعلانات المفرطة:** ترفض WhatsApp Business القوالب المحمّلة بالإعلانات والمحتوى الترويجي. إذا قرر المشرفون أو الذكاء الاصطناعي الخاص بالمنصة أن الإعلانات تطغى على الرسالة الأساسية، فسيتم حظر القالب.
2. **انتهاك سياسة المنتجات:** سيتم رفض القوالب التي تروّج لعناصر محظورة مثل المخدرات أو المواد المؤثرة عقليًا أو الكحول أو التبغ أو الخدمات الحميمة أو أي محتوى يُعتبر مهينًا للكرامة الإنسانية.
3. **الغموض أو الإغفال أو الكذب:** إذا اكتشف مشرفو WhatsApp أي معنى خفي أو معلومات مضللة أو نقصًا في التفاصيل الواضحة حول شركتك أو خدمتك، فلن تتم الموافقة على القالب.
4. **جمع المعلومات السرية:** سيفشل التحقق من القوالب المصممة لجمع بيانات حساسة من المستخدم (مثل أرقام جوازات السفر، وتفاصيل البطاقات المصرفية، وأرقام الهوية الشخصية، وعناوين المنازل).
5. **محتوى مسيء:** سيتم رفض أي رسالة تحتوي على معلومات قد تسيء إلى المستخدمين بناءً على العرق أو الجنسية أو الجنس أو الهوية أو غير ذلك من المعايير.
6. **رفض تقديري:** يحتفظ مشرفو WhatsApp بالحق في رفض القوالب دون تقديم سبب محدد.

كيفية تثبيت قوالب الرسائل

نظرًا لأن القوالب تُنشأ من كتل، يجب عليك أولًا إنشاء كتلة في مسارك قبل استخدامها كقالب لواجهة برمجة تطبيقات WhatsApp Business.

* **التكلفة والرسالة الأولى:** إرسال رسائل القوالب مجاني ضمن نافذة المحادثة التي مدتها 24 ساعة. إن **الرسالة الأولى** إلى العميل لا يمكن أن تكون إلا قالبًا تمت الموافقة عليه من Meta (Facebook).
* **بعد 24 ساعة:** بمجرد مرور 24 ساعة منذ فتح الدردشة، يمكنك فقط إرسال قالب معتمد آخر لإعادة تفاعل المستخدم.
* **ملاحظة حول المراجعة:** قد تفشل القوالب في المراجعة إذا كانت تحتوي على متغيرات (سواء بالخط السيريلي أو اللاتيني).

## **إنشاء القوالب في MaviBot**

1. انتقل إلى **القنوات** قسم، اختر **واجهة برمجة تطبيقات WhatsApp Business**، ثم اختر **قوالب الرسائل**.

<div data-with-frame="true"><figure><img src="/files/a941aac175bf872c49268a14ec31fd27db89c178" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/04c3afbad44ecc31c5c001537564153ccb1d0563" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/37ed88296032c834eff0a4af8491d686f95bbd7b" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/0666818a60ac4ffb8b5abd3a7a944890590e9ce6" alt="" width="563"><figcaption></figcaption></figure></div>

4. سيتم إرسال قالب الرسالة للمراجعة عند الإنشاء. **يمكنك استخدام القوالب المعتمدة فقط.** تستغرق المراجعة عادةً حوالي 8 ساعات، وبحد أقصى 48 ساعة.

## أنواع القوالب

هناك 3 أنواع من القوالب المتاحة للاختيار من بينها.

يمكنك إرفاق صورة إلى **التسويق** القالب بالتنسيقات التالية: SVG وPNG وJPG وGIF.

#### كيفية تمرير المتغيرات في القوالب

تُدار المتغيرات في القوالب بالطريقة نفسها كما هو الحال في MaviBot بالكامل، وليس وفقًا للتنسيق الأصلي لـ WhatsApp.

{% hint style="danger" %}
نظامنا مهيأ لمتغيرات MaviBot و **لا يدعم** المتغيرات في `{{1}}` تنسيق
{% endhint %}

#### استخدام المتغيرات في رسائل قوالب WhatsApp

إذا كنت بحاجة إلى استخدام متغيرات في قوالب الرسائل، فاتبع هذه القاعدة: **اكتب دائمًا أسماء المتغيرات باستخدام الأحرف اللاتينية فقط**، على سبيل المثال، `#{example}`. بعد الإرسال، تحقّق من معالجة المتغيرات بشكل صحيح من خلال فحص الرسالة عبر [الرابط](https://business.facebook.com/wa/manage/message-templates/).

إذا كان القالب يحتوي على متغير، لكن الروبوت لا يعيّن له قيمة أو كانت القيمة مفقودة، فلن يتم **إرسال الرسالة**!

## كيفية عمل الأزرار في القوالب

تدعم قوالب الرسائل الأزرار. في MaviBot، يتم إعداد الأزرار بطريقة مشابهة للصيغة

واجهة برمجة تطبيقات Facebook. يمكنك التعرف عليها من خلال [الرابط](https://developers.facebook.com/docs/whatsapp/business-management-api/message-):

يتم ضبط الأزرار بصيغة مصفوفة JSON.

**معلمات إنشاء الزر:**

| المعامل       | مطلوب | الوصف                                                                                                                                                                                                           |
| ------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| النوع         | نعم   | القيم: PHONE\_NUMBER وURL وQUICK\_REPLY                                                                                                                                                                         |
| text          | نعم   | نص الزر                                                                                                                                                                                                         |
| url           | لا    | <p>عنوان URL الذي سيتم فتحه</p><p>عند النقر على الزر. يمكنك استخدام المتغيرات من أجل</p><p>إنشاء روابط ديناميكية.</p>                                                                                           |
| phone\_number | لا    | <p>رقم الهاتف الذي</p><p>سيتم إجراء المكالمة إليه عند الضغط على الزر</p>                                                                                                                                        |
| example       | لا    | <p>يوفر مثالًا على البيانات المحتملة لقالبك. يساعد هذا في عملية المراجعة والموافقة بحيث يمكنك</p><p>فهم الرسالة التي تخطط لإرسالها. تأكد</p><p>من أن هذه مجرد أمثلة ولا تحتوي على أي معلومات سرية أو شخصية.</p> |

على سبيل المثال: رسالة بزرين: \[{"type":"QUICK\_REPLY", "text": "نعم، مناسب"}, {"type":"QUICK\_REPLY", "text": "غير مناسب"}]

### ميزات الأزرار في القوالب

هناك نوعان من الأزرار المتاحة في رسائل القوالب:

1. **الدعوة إلى الإجراء (CTA):** زر لرابط أو رقم هاتف (يُعرض مع أيقونة رابط أو سماعة هاتف بجانب نصه).
2. **رد سريع:** أزرار نصية قياسية بحد أقصى 20 حرفًا.

**القيود:**

* يمكن أن يحتوي قالب واحد على ما يصل إلى **3 أزرار رد سريع** وما يصل إلى **زرَي دعوة إلى الإجراء**. ومع ذلك، لا يمكنك استخدام رابطين أو رقمين هاتفيين في الوقت نفسه.
* لا يمكن للأزرار أن تتضمن متغيرات أو فواصل أسطر أو رموزًا تعبيرية أو رموز تنسيق.

**السلوك:**

* النقر على **زر رد سريع** يرسل نصه كرسالة رد من المستخدم.
* أ **دعوة إلى الإجراء** يمكن للزر فتح رابط إلى ملف.
* النقر على **دعوة إلى الإجراء** زر لإجراء مكالمة هاتفية يفتح أداة الاتصال القياسية. على WhatsApp Web، ستظهر رسالة تفيد بأنه لا يمكن إجراء المكالمات من إصدار سطح المكتب.

### كيف تعمل مراجعة القالب

يُرسل كل قالب للمراجعة فور إنشائه. تستغرق العملية عادةً **حوالي 8 ساعات**، مع مدة مراجعة قصوى تبلغ **48 ساعة**.

يمكنك تتبع حالة المراجعة في قائمة القوالب الخاصة بك.

إذا تم رفض قالب، فسيتم توفير سبب الرفض.

**القوالب ذات احتمال الموافقة المرتفع عادةً:**

* تستخدم لغة واضحة ومهنية.
* تخدم حالة استخدام محددة ومشروعة (مثل: تذكيرات المواعيد، تحديثات الطلبات).

**مهم:** النص في *مائل* يمكن أن يكون متغيرًا ومخصصًا.

مرحبًا، لم نتمكن من الوصول إليك. هل سيكون من المناسب لك متابعة التواصل هنا؟

مرحبًا، لقد تركت رسالة على الموقع وطلبت مني التواصل معك. (قابل للتغيير)

مرحبًا، أنا جون سميث من MaviBot. لقد تقدمت سابقًا بطلب لإنشاء روبوت دردشة. يسرنا أن نخبرك بأن لدينا بعض الأخبار لك.

القوالب التي لن تجتاز المراجعة:

أي نص إعلاني

#### **كيفية التحقق مما إذا كنت ضمن نافذة الـ24 ساعة**

يمكنك تحديد عدد الأيام التي انقضت منذ آخر رسالة من العميل باستخدام `days_from_last_message()` الوظيفة في شرط التشغيل الخاص بك.

**مثال على التحقق من نافذة الـ24 ساعة:**

`days_from_last_message() == 0`

### كيفية استخدام الأزرار بدون قوالب

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

1. [**أزرار الرد:**](/doc/ar/chatbot/builder/alazrar.md) بحد أقصى **3** يمكن استخدامها في كتلة.
2. [**أزرار مضمنة**](/doc/ar/chatbot/builder/alazrar.md)**:** يمكنك إنشاء ما يصل إلى **10**، وتظهر كما هو موضح في المثال.

**القيود المهمة على الأزرار غير التابعة للقوالب:**

* يمكن أن تحتوي الأزرار فقط على **text**. **الروابط غير مدعومة.**
* وظيفتها الوحيدة هي **نقل العميل من كتلة إلى أخرى** ضمن مسارك.

***

**القيود على الحسابات غير الموثقة**

تواجه حسابات Facebook Business غير الموثقة القيود التالية:

* **50 رسالة قالب يوميًا** (مشمولة في الرسوم الشهرية).
* **لا توجد قيود** على الرسائل الواردة.

لرفع هذه القيود، يجب على شركتك إكمال عملية **التحقق من النشاط التجاري** ، والتي تستغرق عادةً **2–3 أسابيع**.

## أنظمة الدفع

تحقق مع بائع الخدمة المعتمد لديك بشأن تسعير الرسائل الواردة والصادرة للحسابات غير الموثقة.

{% hint style="info" %}
يتم الدفع مباشرةً إلى **360dialog**.
{% endhint %}

## أخطاء إرسال الرسائل

**الأسباب المحتملة لفشل التسليم:**

1. رقم هاتف المستلم غير مسجل على WhatsApp.
2. محاولة إرسال قالب من فئة **"المصادقة"** إلى مستخدم WhatsApp مع رمز الدولة **+91 (الهند)**. حاليًا، لا يمكن تسليم قوالب فئة المصادقة إلى المستخدمين في الهند.
3. لم يقبل المستلم **شروط الخدمة** و **سياسة الخصوصية**.
4. لم يتم تسليم الرسالة للحفاظ على تجربة مستخدم عالية الجودة (هذا حظر عام من السياسة).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/chatbot/ttbyqat-almraslh/waba.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.