# الخط

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

<div data-with-frame="true"><figure><img src="/files/70ed762ff2630985afd86c0cf7133d7426592f70" alt="" width="188"><figcaption></figcaption></figure></div>

## **الاتصال**

لإعداد التكامل بنجاح، ستحتاج إلى إكمال بضع خطوات مطلوبة:

* **معرّف الأعمال** — تم إنشاؤه في [مركز أعمال LINE](https://account.line.biz/login)
* **الحساب الرسمي على LINE** — تم إنشاؤه عبر مدير الحساب الرسمي على LINE.

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

* **Messenger API** — ستحتاج إلى تفعيله في إعدادات الحساب الرسمي الخاص بك.

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

بعد ذلك، انتقل إلى قسم إعدادات الرد وتأكد من تفعيل Webhooks — بدون ذلك لن تتمكن LINE من إرسال الأحداث إلى MaviBot.

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

### معرّف القناة وسر القناة

انتقل إلى قسم Messaging API — هنا توجد المعلمتان الأساسيتان.

* **معرّف القناة**
* **سر القناة**

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

**وهما مطلوبان لربط بوتك بـ MaviBot.**

### ربط LINE بـ MaviBot

**الآن لننتقل إلى ربط LINE بـ MaviBot:**

* افتح **القنوات** قسمًا في MaviBot.
* اختر **LINE**.
* الصق **معرّف القناة** و **سر القناة**.
* انقر **تم**.

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

إذا كانت التفاصيل صحيحة، فسيتصل البوت فورًا.

### المتغيرات

**عندما يرسل مستخدم رسالة إلى بوتك، يخزّن MaviBot تلقائيًا البيانات الأساسية في المتغيرات:**

* **line\_source\_type** — يمكن أن يكون أحد ثلاثة أنواع: *user* (محادثة مباشرة)، *group* (محادثة جماعية)، *room* (نوع قديم من المحادثات الجماعية).
* **line\_quote\_token** — رمز للرد على رسالة محددة. يخزّن MaviBot دائمًا الرمز من أحدث رسالة واردة. يمكن استخدامه في [`line_send_message()`](/doc/ar/chatbot/ttbyqat-almraslh/line_chatbot/api.md).
* **line\_request** — حمولة الويب هوك الكاملة، المحفوظة عند تفعيل المتغير `save_webhook` .
* **خط العرض**, **خط الطول** — الإحداثيات، المحفوظة عندما يرسل المستخدم موقعًا.
* **line\_address** — عنوان قابل للقراءة، محفوظ عندما يشارك المستخدم موقعًا.

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

تتيح لك هذه المتغيرات بناء تدفقات مرنة وتقديم ردود مخصصة للغاية.

## الأحداث التي ترسلها LINE إلى MaviBot

عمليات الاستدعاء المحتملة:

* **line\_follow** — أضاف المستخدم البوت كصديق / ألغى حظره
* **line\_sticker** — تم إرسال ملصق
* **client\_unsubscribed** — حظر المستخدم البوت
* **line\_join** — تمت إضافة البوت إلى محادثة جماعية
* **line\_leave** — غادر البوت محادثة جماعية
* **line\_memberJoined** — انضم عضو جديد إلى المحادثة الجماعية
* **line\_memberLeft** — غادر أحد الأعضاء المحادثة الجماعية

يمكن استخدام كل حدث للأتمتة — التحيات، والمحفزات، والتسجيل.

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

## **مرفقات LINE**&#x20;

تدعم LINE ثلاثة أنواع من الوسائط:

* **الصور**
* **مقاطع الفيديو**
* **الرسائل الصوتية/الصوت**

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

{% hint style="warning" %}

#### يرجى ملاحظة!

تفرض LINE حدًا صارمًا: يمكنك إرسال **ما لا يزيد عن 5 عناصر في الوقت نفسه**.

* **كل مرفق** يُحتسب كـ **عنصر واحد**.
* **نص الرسالة** يُعد أيضًا عنصرًا منفصلًا.
* **مجموعة أزرار** هي عنصر منفصل آخر.

لذا إذا أرسلت **وسائط + نص + أزرار**، فضع **حد 5 عناصر** في الاعتبار.
{% endhint %}

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

## أزرار الإجراءات

#### **لوحة المفاتيح (الردود السريعة)**&#x20;

تظهر فوق حقل الإدخال. بحد أقصى **13 زرًا**.

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

#### **الأزرار في النص**

تُعرض أسفل الرسالة. بحد أقصى **4 أزرار**، ويمكن أن يحتوي نص الرسالة أيضًا على ما يصل إلى **160 حرفًا**.

<div data-with-frame="true"><figure><img src="/files/84c5481c050f29450262de06b94a17cf584b444a" alt="" width="346"><figcaption></figcaption></figure></div>

{% hint style="success" %}

#### يرجى ملاحظة!

**أنواع الأزرار المتاحة**

* **افتراضي**
* **زر استدعاء**
* **طلب تحديد الموقع الجغرافي** *(لوحة المفاتيح فقط)*
  {% endhint %}

## **الاتصال بمجموعة**&#x20;

للسماح بإضافة بوتك إلى المحادثات الجماعية، تحتاج إلى تفعيل هذه الميزة في **مدير الحساب الرسمي على LINE**

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


---

# 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/line_chatbot.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.