# كيفية إنشاء روبوت دردشة على تيك توك

تتضمن MaviBot تكاملًا مع TikTok — إحدى أكثر المنصات الاجتماعية ديناميكية وشعبية في العالم. وهذا يمثل فصلًا جديدًا لمنظومتنا. يُعد TikTok، حيث يتفاعل ملايين المستخدمين يوميًا، مركز التواصل الحديث والاتجاهات والصيغ التفاعلية الجديدة. يتيح هذا التكامل للشركات والمشاريع التواصل مع جمهور أصغر سنًا على مستوى جديد تمامًا.

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

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

* الخطوات المطلوبة لتفعيل التكامل
* عمليات الاستدعاء المتاحة
* الأذونات التي يجب منحها

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

{% hint style="warning" %}
من المهم ملاحظة أن تكامل TikTok غير متاح في جميع البلدان، وهو يعتمد على مناطق اقتصادية محددة تدعم فيها المنصة هذه الميزات رسميًا. سنوضح أين يمكن إعداده فورًا وأين قد تنطبق قيود.

تخضع واجهة برمجة تطبيقات مراسلة TikTok حاليًا لاختبار تجريبي مفتوح في منطقة آسيا والمحيط الهادئ، وأمريكا اللاتينية، والشرق الأوسط، وأفريقيا (METAP)، وأمريكا الشمالية (باستثناء الولايات المتحدة). يجب أن يكون الحساب المتصل مسجلًا في إحدى هذه المناطق.

إذا أرسل مستخدم من الولايات المتحدة أو المنطقة الاقتصادية الأوروبية (EEA) أو سويسرا أو المملكة المتحدة رسالة، فلن يتم استلامها بسبب قيود TikTok.

[راجع وثائق TikTok الرسمية للحصول على التفاصيل.](https://business-api.tiktok.com/portal/docs?id=1832184145137922)
{% endhint %}

{% hint style="success" %}
يرجى الانتباه!

لإنشاء وإعداد روبوت دردشة لـ TikTok، يُرجى الرجوع إلى قسم "كيفية إنشاء روبوت دردشة للأعمال".

تغطي مواصفات زر TikTok [هنا](#knopki).
{% endhint %}

إن دمج TikTok مع MaviBot هو أكثر من مجرد تحديث تقني—إنه فرصة للوجود في طليعة التواصل مع الجمهور، واستخدام أكثر قنوات الترويج سخونة، والتفاعل مع المستخدمين في المكان الذي يقضون فيه وقتهم.

### كيفية تجهيز حسابك للتكامل

لنبدأ بأهم خطوة—إعداد الاتصال بشكل صحيح.

قبل توصيل حسابك، يجب عليك التبديل إلى حساب أعمال.

الخطوة 1: انتقل إلى قسم **"الإعدادات والخصوصية"** .

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

الخطوة 2: ثم انتقل إلى قسم "الحساب".

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

الخطوة 3: انقر على **"التبديل إلى حساب أعمال"**.

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

الخطوة 4: أدخل تفاصيل نشاطك التجاري.

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

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

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

تم! أصبح حسابك الآن جاهزًا للاتصال بـ MaviBot.

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

## كيفية توصيل حسابك بـ MaviBot

انتقل إلى قسم **"الرسائل"** وانقر على زر **TikTok** .

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

بعد ذلك، سجّل الدخول إلى حساب TikTok الخاص بك في النافذة التي تظهر.

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

ومنح MaviBot الوصول إلى حسابك.

{% hint style="danger" %}
مهم!

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

يمكنك ترك جميع الأذونات الأخرى أو رفضها وفقًا لتقديرك الخاص.

إذا قمت لاحقًا بإلغاء أي من الأذونات الضرورية لعمل روبوت الدردشة بشكل صحيح، فلن تتمكن من إعادة تفعيلها إلا من خلال إعدادات TikTok نفسها.
{% endhint %}

بعد ذلك ستتم إعادة توجيهك تلقائيًا إلى **"الرسائل"** القسم في MaviBot، حيث سترى إشعارًا يؤكد نجاح التكامل.

## خصوصيات TikTok

1. لكي تتمكن من مراسلة المستخدم، يجب أن يبدأ المحادثة أولًا.
2. يمكنك إرسال ما يصل إلى 10 رسائل خلال فترة 48 ساعة بعد تلقي رسالة من مستخدم TikTok.\
   \&#xNAN;*مثال: إذا تلقيت رسالة واحدة من مستخدم، فيمكنك إرسال ما يصل إلى 10 رسائل خلال الـ48 ساعة التالية. وإذا أرسل المستخدم نفسه رسالة أخرى لاحقًا، فستبدأ نافذة جديدة مدتها 48 ساعة، مما يتيح لك إرسال 10 رسائل أخرى إلى ذلك المستخدم.*
3. لا يمكن أن تحتوي الرسالة على نص وصورة في الوقت نفسه.
4. يتوفر إرسال واستقبال مرفقات الصور عبر واجهة برمجة التطبيقات فقط إذا كان كلٌّ من المرسل والمستقبل موجودين في بلدان تدعم الصور في الرسائل الخاصة. مشاركة الصور غير متاحة في جميع البلدان.
5. الحد الأقصى لحجم مرفق الصورة هو 3 ميغابايت.
6. يمكن أن تحتوي الرسالة الواحدة على مرفق واحد فقط.

## عمليات الاستدعاء

tiktok\_client\_new\_comment \<video\_id>: \<comment\_text> - ترك مستخدم تعليقًا على مقطع الفيديو الخاص بك.

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

tiktok\_client\_share\_post \<shared\_video\_id> \<url> - أرسل مستخدم فيديو في الرسائل المباشرة للحساب المتصل.

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

## متغيرات العميل المخزنة

tiktok\_comment\_id - معرف التعليق. يتم حفظه عندما يعلّق مستخدم على مقطع الفيديو الخاص بك ويُستخدم للرد على ذلك التعليق.

tiktok\_comment\_video\_id - معرف الفيديو الذي تم التعليق عليه. يتم حفظه عندما يعلّق مستخدم على مقطع الفيديو الخاص بك ويُستخدم للرد على التعليق.

tiktok\_is\_follower - يصبح True إذا كان المستخدم يتابع حسابك.

tiktok\_conversation\_id - معرف المحادثة. يتم إنشاؤه بعد أن يرسل المستخدم رسالة في الدردشة. مطلوب لإرسال الرسائل؛ لا تحذفه!

## الأزرار

الحد الأقصى لعدد الأزرار في رسالة واحدة هو 3.

يدعم TikTok نوعين من الأزرار: زر استدعاء وزر "افتراضي" (URL). <mark style="color:$danger;">**H**</mark><mark style="color:$danger;">**ومع ذلك، لا يمكن أن تحتوي الرسالة الواحدة إلا على أزرار من نوع واحد.**</mark>

مثال 1.

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

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

مثال 2.

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

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

**النتيجة**

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

**يرجى الانتباه!**

***رسائل الأزرار غير متاحة على TikTok Desktop.*** في دردشة سطح المكتب، سترى إشعارًا كهذا:

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

ومع ذلك، في تطبيق الهاتف المحمول، ستظهر الرسالة ***بشكل صحيح***:

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

نص العرض على الزر والنص المرسل إلى الروبوت عند النقر متطابقان. يتم إنشاء الزر باستخدام البيانات من حقل "نص رسالة الرد" أو "URL" في إعدادات الزر.

1. تظهر أزرار الاستدعاء كأزرار عادية. وعند النقر عليها، ترسل رسالة في الدردشة نيابةً عن المستخدم، تتضمن نص الزر. الحد الأقصى للطول هو 20 حرفًا.
2. تظهر أزرار URL كرابط. ومع ذلك، فإن سلوكها هو نفسه سلوك أزرار الاستدعاء. حاليًا، لا يدعم TikTok إنشاء أزرار تفتح صفحة ويب على عنوان URL المحدد عند النقر. الحد الأقصى للطول هو 40 حرفًا.

{% hint style="success" %}
تعرّف على المزيد حول استخدام [أزرار الاستدعاء](/doc/ar/chatbot/builder/alazrar.md#how-to-add-a-callback-button-facebook-telegram) في MaviBot هنا.
{% endhint %}

## الوظائف

كيفية الرد على تعليق:

tiktok\_create\_comment(text, comment\_video\_id, comment\_id) - ينشر ردًا على التعليق المحدد.

<table><thead><tr><th width="276.55859375">المعلمة</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> text</td><td>معلمة مطلوبة، نص التعليق</td></tr><tr><td>comment_video_id</td><td>معرّف الفيديو الذي تم نشر التعليق عليه. هذه معلمة اختيارية؛ إذا لم يتم توفيرها، فسيتم أخذ القيمة من <em>عميل tiktok_comment_video_id</em> المتغير.</td></tr><tr><td>comment_id</td><td>معرّف التعليق المطلوب الرد عليه. هذه معلمة اختيارية؛ إذا لم يتم توفيرها، فسيتم استخدام القيمة من <em>عميل tiktok_comment_id</em> المتغير.</td></tr></tbody></table>


---

# 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/tyk-twk/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.