Tools

واکنش‌ها

عامل با کنش react از ابزار message، واکنش‌های ایموجی را اضافه و حذف می‌کند. رفتار بسته به کانال متفاوت است.

نحوهٔ کار

json
{  "action": "react",  "messageId": "msg-123",  "emoji": "thumbsup"}
  • هنگام افزودن واکنش، emoji الزامی است.
  • برای حذف واکنش(های) ربات در کانال‌هایی که از این قابلیت پشتیبانی می‌کنند، emoji را روی رشتهٔ خالی ("") تنظیم کنید.
  • برای حذف یک ایموجی مشخص، remove: true را تنظیم کنید (emoji باید خالی نباشد).
  • در کانال‌های دارای واکنش‌های وضعیت، تنظیم trackToolCalls: true روی یک واکنش به محیط اجرا اجازه می‌دهد در همان نوبت، از پیام واکنش‌داده‌شده برای واکنش‌های بعدیِ پیشرفت ابزار دوباره استفاده کند.

رفتار کانال‌ها

Discord و Slack
  • emoji خالی همهٔ واکنش‌های ربات روی پیام را حذف می‌کند.
  • remove: true فقط ایموجی مشخص‌شده را حذف می‌کند.
Nextcloud Talk
  • فقط افزودن واکنش پشتیبانی می‌شود: emoji الزامی است و نباید خالی باشد.
  • حذف واکنش هنوز به فراخوانی حذف متصل نشده است؛ به‌جای آنکه remove: true بی‌سروصدا هیچ کاری نکند، با خطایی صریح رد می‌شود.
  • ربات Talk باید با قابلیت reaction ثبت شده باشد (به مستندات کانال Nextcloud Talk مراجعه کنید).
Telegram
  • emoji خالی واکنش‌های ربات را حذف می‌کند.
  • remove: true نیز واکنش‌ها را حذف می‌کند، اما برای اعتبارسنجی ابزار همچنان به emoji غیرخالی نیاز دارد.
WhatsApp
  • emoji خالی واکنش ربات را حذف می‌کند.
  • remove: true در داخل به ایموجی خالی نگاشت می‌شود (در فراخوانی ابزار همچنان به emoji نیاز دارد).
  • WhatsApp برای هر پیام یک جایگاه واکنش ربات دارد؛ ارسال واکنشی جدید به‌جای انباشتن چند ایموجی، واکنش قبلی را جایگزین می‌کند.
Zalo Personal (zalouser)
  • برای افزودن و حذف، emoji باید غیرخالی باشد.
  • remove: true همان واکنش ایموجی مشخص را حذف می‌کند.
Feishu/Lark
  • از همان کنش react سایر کانال‌ها استفاده می‌کند (افزودن/حذف/فهرست‌کردن از طریق شناسه‌های واکنش پیام)، نه ابزاری جداگانه.
  • افزودن به emoji غیرخالی نیاز دارد (به یک emoji_type در Feishu نگاشت می‌شود؛ برای مثال SMILE، THUMBSUP و HEART).
  • remove: true به emoji غیرخالی نیاز دارد و واکنش خود ربات را که با آن نوع ایموجی مطابقت دارد حذف می‌کند.
  • emoji خالی همراه با clearAll: true همهٔ واکنش‌های ربات روی پیام را حذف می‌کند.
Signal
  • اعلان‌های واکنش ورودی با channels.signal.reactionNotifications کنترل می‌شوند: "off" آن‌ها را غیرفعال می‌کند، "own" (پیش‌فرض) هنگامی که کاربران به پیام‌های ربات واکنش نشان می‌دهند رویداد منتشر می‌کند، "all" برای همهٔ واکنش‌ها رویداد منتشر می‌کند و "allowlist" فقط برای فرستندگان موجود در channels.signal.reactionAllowlist رویداد منتشر می‌کند.
iMessage
  • واکنش‌های خروجی، پاسخ‌های لمسی iMessage هستند (love، like، dislike، laugh، emphasize و question)؛ برای افزودن واکنش، emoji باید به یکی از این انواع نگاشت شود.
  • remove: true بدون یک نوع پاسخ لمسی شناخته‌شده، همهٔ انواع پاسخ لمسی را حذف می‌کند؛ همراه با یک نوع شناخته‌شده، فقط همان مورد را حذف می‌کند.

سطح واکنش

تنظیم reactionLevel برای هر کانال، دفعات ارسال واکنش‌های خود عامل را محدود می‌کند. مقادیر: off، ack، minimal یا extensive.

مرتبط

Was this useful?
On this page

On this page