سفارشی‌سازی ربات گفتگو
این راهنما نشان می‌دهد چگونه می‌توانید برنامهٔ ربات سمت ارائه‌دهنده را بدون ترک Control Center بازآرایی کنید.
پیش‌نیازها
بخش با عنوان “پیش‌نیازها”- نقش
ownerیاadminدر فضای کاری - یک ارائه‌دهندهٔ متصل. سطر سفارشی‌سازی ربات تنها زمانی ظاهر می‌شود که فضای کاری متصل باشد
- برنامه‌ای که Control Center بتواند مدیریتش کند. برای Slack این یعنی اتصال یک توکن نوسازی پیکربندی برنامه (
xoxe-…) نگه می‌دارد؛ اگر نداشته باشد، سطر همین را می‌گوید و غیرفعال می‌ماند
آنچه می‌توانید تغییر دهید
بخش با عنوان “آنچه می‌توانید تغییر دهید”| فیلد | معنا | محدودیت |
|---|---|---|
| نام برنامه | نحوهٔ فهرست‌کردن برنامه توسط ارائه‌دهنده | 1–35 نویسه |
| نام ربات (آنچه اعضا بعد از @ تایپ می‌کنند) | آنچه اعضا بعد از @ تایپ می‌کنند |
1–80 نویسه |
| شرح کوتاه | یک خط که ارائه‌دهنده نشان می‌دهد | حداکثر 140 نویسه |
| آنچه ربات می‌گوید می‌تواند انجام دهد | بالای یک DM با ربات نشان داده می‌شود | حداکثر 300 نویسه |
| فرمان اسلش | فرمانی که اعضا فراخوانی می‌کنند، بدون اسلش | با حروف کوچک، فقط a–z 0–9 _ -، بریده‌شده در 32 نویسه |
| پیام‌های مستقیم | اینکه ربات تجربهٔ DM/عامل را عرضه می‌کند یا نه | روشن یا خاموش |
Control Center چهار فیلد متنی را پیش از فراخوانی ارائه‌دهنده اعتبارسنجی می‌کند، بنابراین به‌جای یک invalid_manifest مبهم از سروری که نمی‌توانید ببینید، پیام «the app name must be between 1 and 35 characters» را می‌گیرید. فرمان رد نمی‌شود بلکه به‌نجار می‌شود: اسلش ابتدایی حذف می‌شود، بقیه با حروف کوچک نوشته می‌شود، هر چیزی بیرون از a–z 0–9 _ - انداخته می‌شود و نتیجهٔ خالی به cc بازمی‌گردد.
ویرایش ربات
بخش با عنوان “ویرایش ربات”- به تنظیمات ← فضای کاری ← عمومی بروید و تا کارت پل‌های گفتگو پایین بیایید
- روی بلوک ارائه‌دهنده، روی سفارشی‌سازی ربات کلیک کنید
- دیالوگ با مقادیر زندهٔ برنامه باز می‌شود که از ارائه‌دهنده بازخوانی شده‌اند — پس چیزی که کسی در رابط خود Slack عوض کرده، همان چیزی است که از آن شروع می‌کنید
- آنچه لازم دارید را ویرایش کنید و ذخیره کنید
خواندن آن مقادیر زنده در سمت Slack هزینهٔ یک چرخش توکن دارد؛ به همین دلیل آن سطر یک کلیک عمدی است، نه چیزی که صفحه هنگام بارگذاری انجام دهد.
نوشتن، تغییرات شما را روی تعریف کنونی برنامه می‌نشاند. هر چیزی که Control Center مدل نمی‌کند — یک فرمان اسلش دوم که در Slack افزوده‌اید، یک گام گردش‌کار، یک تنظیم بی‌ربط — دست‌نخورده می‌ماند. اسکوپ‌ها و رویدادها ادغام می‌شوند، هرگز کم نمی‌شوند.
پس از ذخیره، Control Center هویت ربات را دوباره بازخوانی می‌کند تا نام در تنظیمات با نام در برنامهٔ گفتگو یکی باشد.
نصب مجدد هنگام تغییر مجوزها
بخش با عنوان “نصب مجدد هنگام تغییر مجوزها”وقتی ذخیره‌کردنی مجوزها را تغییر می‌دهد، دیالوگ باز می‌ماند و می‌گوید «Slack مجوزهای برنامه را عوض کرد. برای اعمال، برنامه را دوباره نصب کنید.»، همراه با دکمه‌ای نصب مجدد برنامه که صفحهٔ نصب آن برنامه در تیم Slack را باز می‌کند. در خود Slack این مسیر Install App → Reinstall to Workspace است.
تغییر نام فرمان اسلش
بخش با عنوان “تغییر نام فرمان اسلش”فرمان اسلش را تغییر دهید و ذخیره کنید. پل سپس دستورالعمل‌ها را با هر فرمانی می‌نویسد که آخرین بار با آن فراخوانی شده است، بنابراین متن راهنما و دستورالعمل‌های پیوند از تغییر نام پیروی می‌کنند، نه اینکه فرمانی را نام ببرند که دیگر وجود ندارد.
تغییر نام، رشته‌های پل‌شدهٔ موجود را نمی‌شکند: کلید رشته‌ها گفتگوست، نه فرمان.
چیزهایی که Control Center تغییر نمی‌دهد
بخش با عنوان “چیزهایی که Control Center تغییر نمی‌دهد”- تنظیمات ساختاری. انتقال (Socket Mode)، اسکوپ‌های لازم و اشتراک‌های رویداد اعمال می‌شوند، نه اینکه به انتخاب گذاشته شوند. برنامه‌ای که بتوان از یک صفحهٔ تنظیمات به سکوتش واداشت، یک تیکت پشتیبانی است، نه یک قابلیت
- آیکون ربات. تنها تنظیمات خود برنامهٔ ارائه‌دهنده می‌تواند آن را تغییر دهد و دیالوگ همین را می‌گوید
- مهاجرت‌های قابلیت خود ارائه‌دهنده. برنامه‌ای که از پیش روی شکل دستیار قدیمی Slack است همان را نگه می‌دارد؛ این دیالوگ یک شرح را ویرایش می‌کند و برنامه‌ای را مهاجرت نمی‌دهد
عیب‌یابی
بخش با عنوان “عیب‌یابی”سطر سفارشی‌سازی ربات اصلاً وجود ندارد
بخش با عنوان “سطر سفارشی‌سازی ربات اصلاً وجود ندارد”فضای کاری هنوز متصل نشده است. سطر تنها زمانی ظاهر می‌شود که بلوک ارائه‌دهنده یک اتصال زنده نشان دهد. راه‌اندازی یکپارچه‌سازی Slack را ببینید.
سطر سفارشی‌سازی ربات غیرفعال است
بخش با عنوان “سطر سفارشی‌سازی ربات غیرفعال است”اتصال هیچ اعتبارنامهٔ مدیریت برنامه‌ای ندارد — زیرنویس سطر می‌گوید «Control Center برای ویرایش ربات به توکن پیکربندی برنامه نیاز دارد. دوباره وصل شوید و یکی را شامل کنید.» برای Slack، یک جفت توکن پیکربندی برنامه در api.slack.com/apps بسازید و با توکن نوسازی پرشده دوباره وصل شوید. این برای برنامه‌ای که دستی ساخته شده یا از طریق Create in Slack ساخته شده انتظار می‌رود، چون Slack هرگز گزارش نمی‌دهد کدام برنامه را ساخته است.
«Control Center does not know which app to edit»
بخش با عنوان “«Control Center does not know which app to edit»”اتصال ذخیره‌شده هیچ شناسهٔ برنامه‌ای حمل نمی‌کند — معمولاً برنامه‌ای که پیش از ثبت یک شناسه، دستی وصل شده است. فضای کاری را دوباره وصل کنید، یا برنامه را از Control Center بسازید.
نام جدید ربات در گفتگو ظاهر نشده است
بخش با عنوان “نام جدید ربات در گفتگو ظاهر نشده است”ارائه‌دهنده‌ها فرادادهٔ برنامه را کوتاه‌مدت کش می‌کنند. اگر نام پس از یک دقیقه هنوز کهنه است، بررسی کنید که آیا ذخیره از شما خواسته برنامه را دوباره نصب کنید.