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
  • واکنش‌های خروجی tapbackهای iMessage هستند (love، like، dislike، laugh، emphasize و question).
  • اعلان‌های tapback ورودی با channels.imessage.reactionNotifications کنترل می‌شوند: "off" آن‌ها را غیرفعال می‌کند، "own" (پیش‌فرض) وقتی کاربران به پیام‌های نوشته‌شده توسط ربات واکنش نشان می‌دهند رویداد منتشر می‌کند، و "all" برای همه tapbackها از فرستندگان مجاز رویداد منتشر می‌کند.

سطح واکنش

پیکربندی reactionLevel برای هر کانال کنترل می‌کند که عامل تا چه اندازه گسترده از واکنش‌ها استفاده کند. مقدارها معمولا off، ack، minimal یا extensive هستند.

برای تنظیم اینکه عامل در هر پلتفرم با چه میزان فعالیت به پیام‌ها واکنش نشان دهد، reactionLevel را روی کانال‌های جداگانه تنظیم کنید.

مرتبط

Was this useful?
On this page

On this page