اتصال ایجنت به ربات تلگرام یا بله
باز کردن در ایجنتومکاربرد
ساعت یازده شب مشتری هنوز می‌خواهد بداند فر مشکی هم دارد یا نه، و ندا خیلی وقت است رفته خانه. برای دستیار پشتیبانی یک ربات تلگرام یا بلهٔ مخصوص بسازید تا هر کسی، شب یا روز، مستقیم با آن گفت‌وگو کند.
پیش از شروع
- ابتدا ایجنت را ذخیره کنید. تا ذخیره نشده باشد، در بخش «کانال‌ها» نوشته می‌شود «برای اتصال ربات، ابتدا این ایجنت را ذخیره کنید.»
- ربات را با ربات‌ساز رسمی همان پیام‌رسان (تلگرام یا بله) بسازید و توکن آن را محرمانه نگه دارید. نام ربات‌ساز زیر فیلد «توکن ربات» نوشته شده است.
- از یک ایجنت سفارشی ذخیره‌شده در فضای کاری فعلی خود استفاده کنید و مجوز مدیریت ایجنت‌ها را داشته باشید.
مراحل
- «ایجنت‌ها» را باز کنید، ایجنت را در «ایجنت‌های من» پیدا و انتخاب کنید. در پنجره‌ای که باز می‌شود «اقدامات ایجنت» (سه نقطه) و بعد «ویرایش ایجنت» را بزنید.
- «کانال‌ها» را باز کنید و برگهٔ «Telegram» یا «Bale» را انتخاب کنید. برگه‌های «وب‌سایت» و «API» فقط پیش‌نمایش‌اند و برای اتصال این ایجنت قابل استفاده نیستند.
- لینک عمومی ربات را در «لینک ربات» بگذارید. نام کاربری ربات در لینک باید با توکن مطابقت داشته باشد.
- توکن را در «توکن ربات» وارد کنید. توکن رمزگذاری می‌شود و دوباره نمایش داده نمی‌شود، پس هر بار که دوباره وصل می‌کنید باید آن را از نو وارد کنید.
- اختیاری: «پیام خوشامدگویی (/start)» را تا ۱٬۰۰۰ کاراکتر بنویسید. اگر خالی بماند، هر مخاطب پیام خوشامد پیش‌فرض را به زبان خودش می‌بیند.
- دربارهٔ «اجازهٔ استفاده از ابزارهای افزونه‌ای انتخاب‌شده برای ایجنت» تصمیم بگیرید. با روشن بودن آن، مخاطبان ربات می‌توانند از ابزارهای افزونه‌ای که برای این ایجنت انتخاب شده‌اند استفاده کنند. فقط ابزارهایی حساب می‌شوند که یکی‌یکی با «انتخاب ابزارها» در بخش «افزونه‌ها»ی ایجنت انتخاب کرده‌اید: افزونه‌ای که روی «همه‌ی ابزارها فعال است» مانده باشد هیچ ابزاری در اختیار مخاطبان نمی‌گذارد. هر فراخوانی ابزار افزونه که مخاطب راه بیندازد همچنان منتظر تأیید شما در ایجنتوم می‌ماند، چون ابزارهای افزونه هیچ‌وقت فقط‌خواندنی به حساب نمی‌آیند. اگر تا ۲ دقیقه کسی تأیید نکند، آن فراخوانی ناموفق می‌شود. فقط برای ابزارهایی روشنش کنید که برای مخاطب عمومی بی‌خطرند.
- «اتصال ربات» را بزنید. نشان وضعیت ابتدا «در حال اتصال» و بعد «متصل» می‌شود. ربات را باز کنید و پیامی برای آزمایش بفرستید.
- برای توقف ربات «قطع اتصال» را بزنید. برای تغییر لینک، توکن، پیام خوشامد یا ابزارها، آن‌ها را ویرایش و «ذخیره و اتصال مجدد» را بزنید.
نتیجهٔ مورد انتظار
وضعیت «متصل» است و نام و نام کاربری ربات، پیوند باز کردن آن و زمان «آخرین به‌روزرسانی دریافتی» نمایش داده می‌شود. هر کسی که به ربات پیام بدهد می‌تواند با ایجنت گفت‌وگو کند. هر مخاطب تاریخچه و حافظهٔ جداگانه دارد و هزینهٔ مصرف به حساب فضای کاری شما می‌رود. این اتصال از اتصال شخصی خودتان به تلگرام در ایجنتوم جداست.
رفع مشکل
| مشکل | راه‌حل |
|---|---|
| «اتصال ربات» غیرفعال است | هم «لینک ربات» و هم «توکن ربات» را پر کنید. |
| خطا می‌گوید لینک و توکن به ربات‌های متفاوتی تعلق دارند | لینک همان رباتی را بگذارید که توکن را صادر کرده است. |
| خطا می‌گوید توکن معتبر نیست | کل توکن را دوباره از ربات‌ساز کپی کنید. توکن شامل رقم، دونقطه و حروف است. |
| «ربات تأیید نشد. توکن آن را بررسی کنید و دوباره تلاش کنید.» | مطمئن شوید توکن مال رباتی است که هنوز وجود دارد، آن را دوباره از ربات‌ساز کپی کنید و باز «اتصال ربات» را بزنید. |
| خطا می‌گوید این ربات، ربات رسمی پلتفرم است | ربات خودتان را بسازید. ربات رسمی را نمی‌شود به یک ایجنت جداگانه وصل کرد. |
| خطا می‌گوید این ربات یا کانال ایجنت در جای دیگری متصل است | عضو دیگری از فضای کاری کانال این ایجنت را وصل کرده یا ربات به ایجنت دیگری وصل است. ابتدا اتصال آن را همان‌جا قطع کنید یا ربات دیگری به کار ببرید. |
| نشان «مشکل در اتصال» است | پیام زیر آن را بخوانید، توکن یا لینک را درست کنید و «ذخیره و اتصال مجدد» را بزنید. |
| وضعیت «متصل» است ولی ربات جواب نمی‌دهد | نشان وضعیت ثابت نمی‌کند که پیام‌ها پاسخ داده می‌شوند. پیامی آزمایشی بفرستید و «آخرین به‌روزرسانی دریافتی» را ببینید. |
| ربات یک پیام ثابت جواب می‌دهد یا وصل نمی‌شود | حالت حریم خصوصی داده‌ها برای فضای کاری یا پروژه روشن است و ربات‌های تلگرام و بله آنجا خاموش‌اند. استفاده از حالت حریم خصوصی داده‌ها را ببینید. |