Tools

التفاعلات

يمكن للوكيل إضافة تفاعلات الرموز التعبيرية وإزالتها على الرسائل باستخدام أداة message مع إجراء react. يختلف سلوك التفاعل حسب القناة والنقل.

طريقة العمل

json

{  "action": "react",  "messageId": "msg-123",  "emoji": "thumbsup"}

يكون emoji مطلوبًا عند إضافة تفاعل.
اضبط emoji على سلسلة فارغة ("") لإزالة تفاعل/تفاعلات البوت.
اضبط remove: true لإزالة رمز تعبيري محدد (يتطلب emoji غير فارغ).
في القنوات التي تدعم تفاعلات الحالة، يتيح trackToolCalls: true على التفاعل لوقت التشغيل استخدام تلك الرسالة المتفاعل معها لتفاعلات تقدم الأدوات اللاحقة خلال الدور نفسه.

سلوك القناة

Discord and Slack

يزيل emoji الفارغ كل تفاعلات البوت على الرسالة.
يزيل remove: true الرمز التعبيري المحدد فقط.

Google Chat

يزيل emoji الفارغ تفاعلات التطبيق على الرسالة.
يزيل remove: true الرمز التعبيري المحدد فقط.

Nextcloud Talk

إضافة التفاعلات فقط: يكون emoji مطلوبًا ويجب ألا يكون فارغًا.
إزالة التفاعلات غير مدعومة بعد؛ تُرفض الاستدعاءات مع remove: true (أو emoji فارغ) بخطأ واضح بدلًا من تجاهلها بصمت بلا أثر.
يتطلب تسجيل بوت Talk بميزة reaction (راجع وثائق قناة Nextcloud Talk).

Telegram

يزيل emoji الفارغ تفاعلات البوت.
يزيل remove: true التفاعلات أيضًا لكنه لا يزال يتطلب emoji غير فارغ للتحقق من صحة الأداة.

WhatsApp

يزيل emoji الفارغ تفاعل البوت.
يُطابِق remove: true داخليًا إلى رمز تعبيري فارغ (مع استمرار طلب emoji في استدعاء الأداة).
لدى WhatsApp خانة تفاعل بوت واحدة لكل رسالة؛ تستبدل تحديثات تفاعل الحالة تلك الخانة بدلًا من تكديس عدة رموز تعبيرية.

Zalo Personal (zalouser)

يتطلب emoji غير فارغ.
يزيل remove: true تفاعل الرمز التعبيري المحدد ذاك.

Feishu/Lark

استخدم أداة feishu_reaction مع الإجراءات add وremove وlist.
تتطلب الإضافة/الإزالة emoji_type؛ وتتطلب الإزالة أيضًا reaction_id.

Signal

تتحكم channels.signal.reactionNotifications في إشعارات التفاعلات الواردة: يعطلها "off"، ويصدر "own" (الافتراضي) أحداثًا عندما يتفاعل المستخدمون مع رسائل البوت، ويصدر "all" أحداثًا لكل التفاعلات.

iMessage

التفاعلات الصادرة هي tapbacks في iMessage (love وlike وdislike وlaugh وemphasize وquestion).
تتحكم channels.imessage.reactionNotifications في إشعارات tapback الواردة: يعطلها "off"، ويصدر "own" (الافتراضي) أحداثًا عندما يتفاعل المستخدمون مع الرسائل التي ألّفها البوت، ويصدر "all" أحداثًا لكل tapbacks من المرسلين المصرح لهم.

مستوى التفاعل

يتحكم إعداد reactionLevel لكل قناة في مدى اتساع استخدام الوكيل للتفاعلات. تكون القيم عادةً off أو ack أو minimal أو extensive.

Telegram reactionLevel — channels.telegram.reactionLevel
WhatsApp reactionLevel — channels.whatsapp.reactionLevel

اضبط reactionLevel على القنوات الفردية لضبط مدى نشاط تفاعل الوكيل مع الرسائل على كل منصة.

ذات صلة

إرسال الوكيل — أداة message التي تتضمن react
القنوات — إعداد خاص بكل قناة

Was this useful?

On this page

On this page