ساخت پل ارتباطی سروش و فیلترهای دریافت

در این آموزش کوتاه قصد داریم پل ارتباطی پیام‌رسان سروش را که به‌تازگی بستر ربات آن تکمیل و راه‌اندازی شده ایجاد کنیم و مراحل آن را توضیح دهیم. برای این کار وارد بخش ربات‌ها می‌شویم و به ربات خود مراجعه می‌کنیم. به بخش پل‌های ارتباطی می‌رویم و یک پل ارتباطی جدید ایجاد می‌کنیم. نوع پل را سروش انتخاب می‌کنیم. دربارهٔ فیلترهای دریافت می‌توانید ربات را محدود به برخی انواع گفتگو کنید. می‌تواند محدود به خصوصی، گروه، کانال یا هر چند مورد از این‌ها در کنار هم باشد. این موضوع به کارکرد ربات شما بستگی دارد که نیاز دارید داخل کانال نیز فعالیت کند، داخل گروه نیز فعالیت کند یا خصوصی. توجه داشته باشید که هر کدام از این موارد را اگر تیک بزنید و ربات داخل آن کانال یا گروه نیز مدیر شده باشد قرار است پیام‌ها را دریافت کند و دریافت این پیام‌ها برای شما داخل پنل صهبات هزینه خواهد داشت. هر پیام دریافتی یک امتیاز از امتیازات ربات کم خواهد کرد. بنابراین اگر نیازی ندارید ربات داخل گروه یا کانال یا گفتگوی خصوصی فعالیت خاصی داشته باشد حتماً توجه کنید و تیک آن‌ها را بردارید.

فیلتر بر اساس شناسه (فهرست مجاز و فهرست مسدود)

در کنار فیلتر نوع گفتگو، در به‌روزرسانی جدید ربات‌ساز صهبات فیلتری بر اساس شناسه نیز افزوده شده است. اینجا می‌توانید شناسهٔ کاربر اعم از کانال، گروه یا خصوصی را که داخل صهبات به قسمت کاربران ربات اضافه شده بیاورید یا نام کاربری آن را وارد کنید و تعیین کنید وارد فهرست مجاز پل ارتباطی شود یا وارد فهرست مسدود آن شود؛ یعنی اگر از این شناسه پیامی آمد آن را دریافت نکند. فعلاً به فیلتر بر اساس شناسه نیاز نداریم.

تنظیمات وضعیت پل (ارسال و دریافت)

وضعیت پل بخشی است که تعیین می‌کنید ربات فقط دریافت‌کنندهٔ پیام باشد، یا فقط ارسال‌کننده، یا هر دو را انجام دهد. قطعاً اگر می‌خواهید ربات به‌صورت تعاملی کار کند — یعنی برای مثال دستور /start را دریافت کند و در قبال آن پاسخی نیز ارسال کند — باید این مورد را روی ارسال و دریافت بگذارید. موارد دیگر وضعیت پل برای شرایطی استفاده می‌شود که فرضاً می‌خواهید کانال فقط مبدأ باشد، یعنی فقط از آن پیام دریافت شود؛ یا می‌خواهید کانال حتماً مقصد باشد تا ربات فقط پیام را ارسال کند و اگر داخل آن کانال پستی گذاشته شد به کانال‌های دیگر منتقل نشود. اما معمولاً برای ربات‌ها — چه ربات انتقال پست که خودش مقصد و مبدأ را تشخیص می‌دهد و چه ربات‌های تعاملی دیگر — وضعیت پل را به‌صورت ارسال و دریافت در نظر می‌گیریم.

دریافت توکن از بات‌فادر سروش

عنوان پل را یک عنوان دلخواه تعیین می‌کنیم و برای قسمت آدرس توکن پل باید به پیام‌رسان سروش مراجعه کنیم. وارد پیام‌رسان سروش می‌شویم. می‌توانید از قسمت جستجو بات‌فادر را جستجو کنید یا اگر ظاهر نشد همین شناسه را که اینجا هست داخل یک گفتگوی شخصی بفرستید و سپس روی آن بزنید و وارد بات‌فادر شوید. داخل بات‌فادر شروع را می‌زنیم. ساخت بات جدید، یک عنوان انتخاب می‌کنیم. شناسه را می‌نویسیم. ربات ساخته شد و توکن آن نیز دریافت شد. اگر روی توکن بزنید آن را رونوشت می‌کند و اکنون به پنل صهبات بازمی‌گردیم برای وارد کردن آدرس توکن پل. اینجا جایگذاری می‌کنیم.

تنظیمات ذخیره‌سازی پیام‌ها

اکنون به بخش آخر رسیدیم که ذخیرهٔ پیام‌ها تا چند ساعت است. اینجا تنظیم می‌کنیم صهبات تا چند ساعت پیام‌های ارسالی و دریافتی ربات از این پل را داخل سرور صهبات نگه دارد. این نگهداری و ذخیرهٔ پیام‌ها ارتباطی به نگهداری و ذخیرهٔ پیام‌ها داخل پیام‌رسان ندارد و هر پیامی که آنجا فرستاده می‌شود کاملاً جدا از سرورها و پنل صهبات است. نگهداری پیام‌ها در صهبات بیشتر از ۲۳ ساعت به‌ازای نگهداری هر پیام به مدت یک روز یک امتیاز کسر خواهد کرد. نکتهٔ دیگر این است که عدد صفر به معنی ذخیره به‌صورت نامحدود است. پیشنهاد صهبات این است که ذخیرهٔ پیام را حتماً ۱ تا ۲۳ ساعت در نظر بگیرید تا هزینهٔ اضافه نداشته باشد و اگر نیاز دارید برخی پیام‌ها حتماً ذخیره شوند — مانند پیام ثبت‌نام به مدیر یا پیام‌های دریافت‌شده از کاربر — آن‌ها را داخل پیام‌رسان آرشیو کنید. برای مثال در جلسهٔ چهارم نحوهٔ ارسال اطلاعات دریافت‌شده به مدیر به‌طور کامل توضیح داده شده است. در این صورت اطلاعات و فایل‌هایی که ربات دریافت می‌کند می‌تواند بلافاصله به مدیر، کانال یا گروه خاصی فرستاده شود و همان‌جا به‌صورت آرشیو ذخیره شود.

راه‌اندازی نهایی و آزمایش ربات

اکنون کلید ایجاد پل ارتباطی را می‌زنیم و پل ارتباطی ایجاد شد. اگر شناسهٔ ربات نیز ظاهر شود یعنی پل ارتباطی به‌درستی شناخته و ایجاد شده است. از پیش یک فرآیند شروع ساده ایجاد کرده‌ایم. فرآیند شروع یا همان استارت را معمولاً به‌صورت منوی ساده می‌سازیم و آموزش کامل فرآیندهای منوی ساده، ایجاد کلیدها و موارد مرتبط با آن‌ها را در جلسهٔ اول دورهٔ آموزشی کامل توضیح داده‌ایم. فقط یک‌بار فرآیند را مرور می‌کنیم. وارد قسمت ویرایش می‌شویم. اگر دستوری نداشته باشید باید دستور را ایجاد کنید. آدرس دستور اسلش استارت است و اگر اسلش استارت دریافت شد چه پاسخی بدهد؟ پاسخ به‌صورت یک پیام متنی به این صورت خواهد بود. اینجا از پلاگین date نیز استفاده کرده‌ایم که در جلسهٔ دوم دورهٔ آموزشی پلاگین‌ها به‌طور کامل توضیح داده شده است. پس از این پیام متنی قرار است سه کلید نشان داده شود. اکنون به پیام‌رسان سروش می‌رویم و به ربات پیامی می‌دهیم. بلافاصله پاسخ داد. ربات به‌درستی کار می‌کند.