# فيسبوك ماسنجر

## كيفية ربط صفحة فيسبوك

إذا كانت لديك بالفعل صفحة أعمال على فيسبوك، فيمكنك ربط بوت بها.

{% hint style="warning" %}

#### **مهم!**

تأكد من إنشاء **صفحة**، وليس مجموعة. لا يمكن ربط روبوتات الدردشة على فيسبوك إلا بالصفحات.
{% endhint %}

{% hint style="danger" %}
لا يمكن ربط البوت إلا بواسطة مالك الصفحة أو أحد المشرفين.
{% endhint %}

أولاً، أنشئ صفحة أعمال على فيسبوك.

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

لربط فيسبوك مع MaviBot، انتقل إلى قسم "Messengers" واختر Facebook.

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

<div data-with-frame="true"><figure><img src="/files/3ec025e9052355bf5d76ac7233b0c87301e589dc" alt="" width="375"><figcaption></figcaption></figure></div>

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

{% hint style="info" %}
قد يُعرض عليك ربط **حسابات الأعمال في إنستغرام** أيضًا، لكن هذا اختياري.
{% endhint %}

بعد ذلك، اختر الصفحة التي تريد ربط البوت بها. ثم اختر أذونات البوت. تأكد من تفعيل جميع المفاتيح.

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

إذا نجحت العملية، فسترى النافذة التالية.

{% hint style="warning" %}
يجب تفعيل الرسائل للصفحة.
{% endhint %}

سترى زر "Start" الافتراضي بعد الدخول إلى المجموعة.

لا تنسَ تضمين هذه الكلمة في شروط كتلة البدء.

يتم إعداد رسالة الترحيب التي يراها المستخدم قبل النقر على زر "Start" في إعدادات صفحة فيسبوك.

### ما الذي يجب فعله إذا لم تكن الصفحة المطلوبة موجودة في القائمة

إذا كنت لا ترى المجموعة التي تحتاجها في القائمة، فهذا يعني على الأرجح أن المنشئ لا يملك أذونات لتلك المجموعة. تحتاج إلى منحها له.

**للقيام بذلك:**

سجّل الخروج من النظام باستخدام الزر الموجود في الزاوية العلوية اليمنى.

انقر على "Log in with Facebook."

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

انقر **"Edit settings"**.

اختر الصفحة التي تريدها واتبع جميع الخطوات الموضحة في بداية المقال.

## كيفية إنشاء البثوث على فيسبوك

ينطبق ذلك على أي رسائل ترسلها: عبر روبوتات الدردشة، أو البثوث الجماعية، أو الرسائل المرسلة يدويًا.

عندما يشترك مستخدم في روبوت دردشة أو يبدأ محادثة مع صفحة الشركة، يكون لديك نافذة زمنية مدتها 24 ساعة من تلك اللحظة لإرسال أي رسائل للمستخدم، بما في ذلك الرسائل الترويجية.

1. إذا لم يرد المستخدم خلال 24 ساعة، يسمح لك فيسبوك بإرسال رسالة إضافية واحدة. قد تتضمن هذه الرسالة زرًا وعرضًا قويًا لجذب انتباه المشترك ودفعه إلى الرد.
2. إذا رد المستخدم خلال نافذة الـ 24 ساعة، تُفتح نافذة جديدة مدتها 24 ساعة.
   &#x20;يحدث هذا في كل مرة يرد فيها على رسالة من روبوت الدردشة.

لهذه القاعدة بعض الاستثناءات.
&#x20;مزيد من التفاصيل: [https://developers.facebook.com/docs/messenger-platform/policy/policy-overview\ <br>](https://developers.facebook.com/docs/messenger-platform/policy/policy-overview)أحدها هو **وسوم الرسائل** — وهو نوع مسموح من الرسائل يمكن إرساله حتى بعد انقضاء نافذة الـ 24 ساعة.\
\
هناك 16 نوعًا من وسوم الرسائل. وقد اخترنا استخدام **confirmed\_event\_update** – "تذكير بالحدث." في المستقبل، قد نضيف خيار اختيار نوع الرسالة التي تريد إرسالها.

{% hint style="danger" %}
أ**بعد 24 ساعة من آخر تفاعل للمستخدم**، يُسمح لك فقط بإرسال رسائل تتعلق بتذكيرات الأحداث — مثل تأكيد الحجوزات القادمة، أو الإخطار بتغييرات الجدول الزمني، أو تذكير المستخدمين بالمواعيد أو الفعاليات التي سجلوا فيها.

**يُحظر تمامًا إرسال أي نوع من المحتوى الترويجي بعد نافذة الـ 24 ساعة.**
\
قد يؤدي انتهاك هذه القاعدة إلى حظر صفحة فيسبوك الخاصة بك.
{% endhint %}

\
من مزايا هذا الحل أن البثوث لا تتطلب مراجعة.
&#x20;كما يتيح لك وسيلة للتحايل على قاعدة 24+1.

## كيفية العمل مع Facebook Pixel

{% hint style="success" %}
لتثبيت Pixel على صفحة الهبوط المصغرة الخاصة بنا، تحتاج إلى ربط نطاقك الخاص بها.
{% endhint %}

يتطلب فيسبوك استخدام نطاقات موثقة. للحصول على تعليمات مفصلة حول تثبيت Pixel، اقرأ HERE.

## كيفية إنشاء Carousel

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

{% hint style="success" %}
يمكن أن يتكون Carousel من بطاقتين إلى 10 بطاقات (شرائح).
{% endhint %}

لننظر إلى مثال على Carousel مكوّن من 3 بطاقات. لإنشاء البطاقات، تحتاج إلى إدخال ما يلي في حقل "Calculator".

p = \[
\
{"title": "TITLE", "description": "DESCRIPTION OF CARD 1", "image": "LINK TO IMAGE 1", "buttons": \[{"text": "BUTTON TEXT 1"}]},
\
{"title": "TITLE", "description": "DESCRIPTION OF CARD 2", "image": "LINK TO IMAGE 2", "buttons": \[{"text": "BUTTON TEXT 2"}]},
\
{"title": "TITLE", "description": "DESCRIPTION OF CARD 3", "image": "LINK TO IMAGE 3", "buttons": \[{"text": "BUTTON TEXT 3"}]}
\
]

r = send\_carousel(p, '')

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

{% hint style="info" %}
يرجى ملاحظة: يجب إدخال السطر **r = send\_carousel(p, '')** في سطر جديد في حقل إدخال الحاسبة.
{% endhint %}

{% hint style="danger" %} <mark style="color:red;">**يرجى الانتباه!**</mark>

عند إنشاء وصف بطاقة Carousel مثل

\
{"**title**": "TITLE", "**description**": "DESCRIPTION OF CARD 1", "**image**": "LINK TO IMAGE 1", "buttons":\[{"text":"BUTTON TEXT 1"}]} <br>

من المهم أن **تملأ** إما **title** <mark style="color:red;">**و**</mark> **معلمة الوصف أو معلمة الصورة**.
{% endhint %}

أولًا، عيّن مصفوفة تحتوي على العنوان والوصف والصورة والأزرار إلى المتغير p (يمكنك تسمية المتغير بشكل مختلف). ثم استخدمه في الطريقة send\_carousel(p, '').

يمكنك أيضًا استخدام الجدول لإدخال العناوين والروابط المطلوبة وما إلى ذلك ببساطة، ثم نسخ النتيجة إلى كتلتك.

في حقل "Response"، اترك #{None}.

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

{% hint style="info" %}
يمكنك إدراج روابط URL في أزرار بطاقات الـ carousel. عندما ينقر المستخدم على زر، سيتم تحويله إلى الرابط.
{% endhint %}

لإضافة رابط إلى زر على بطاقة، أدرجه في المصفوفة التالية:

p = \[
{
"title": "title",
"description": "DESCRIPTION OF CARD 1",
"image": "LINK TO IMAGE 1",
"buttons": \[
{
"text": "BUTTON TEXT 1",
"url": "LINK FOR BUTTON"
}
]
}
]

{% hint style="info" %}
معلمة إضافية اختيارية **payload** تمت إضافتها إلى أزرار بطاقات الـ carousel.
&#x20;لن تكون هذه المعلمة مرئية للمستخدم، لكنها تتيح لك تتبع وتحليل اختيار المستخدم.
{% endhint %}

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

لن تكون هذه المعلمة مرئية للمستخدم، لكنها تتيح لك تحليل اختياره:

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

يرجى الانتباه إلى طريقة استخدامها الصحيحة:\
p = \[
{
"title": "title",
"description": "DESCRIPTION OF CARD 1",
"image": "LINK TO IMAGE 1",
"buttons":\[{"text": "BUTTON TEXT 1", "payload": "1"}]
},
{
"title": "title",
"description": "DESCRIPTION OF CARD 2",
"image": "LINK TO IMAGE 2",
"buttons": \[{"text": "BUTTON TEXT 1", "payload": "2"}]
}, {
"title": "title",
"description": "DESCRIPTION OF CARD 3",
"image": "LINK TO IMAGE 3",
"buttons": \[{"text":"BUTTONTEXT 1"}]
}
]

معلمة payload اختيارية ويمكن حذفها، كما هو موضح في الشكل الخاص بالزر 3.


---

# 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/fysbwk-masnjr.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.