چطور یک بات تلگرام بسازیم و به انجیر وصلش کنیم

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

چرا بات، نه شماره‌ی شخصی

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

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

چیزی که لازم دارید

  • یک حساب تلگرام (همان حساب شخصی خودتان کافی است؛ بات جدا از آن ساخته می‌شود)
  • یک حساب انجیر (ثبت‌نام رایگان است)
  • یک اسم برای بات و یک نام کاربری که آخرش bot باشد

قدم اول: بات را در BotFather بساز

در تلگرام دنبال @BotFather بگردید. همانی که تیک آبی دارد. چت را باز کنید و بنویسید /newbot.

ساخت بات در BotFather

دو چیز از شما می‌پرسد:

۱. نام بات. همان اسمی که مشتری بالای چت می‌بیند. فارسی هم قبول است: «پشتیبانی فروشگاه من».

۲. نام کاربری. انگلیسی، بدون فاصله، و حتماً باید به bot ختم شود؛ مثل myshop_support_bot. این همان چیزی است که در نشانی t.me/myshop_support_bot می‌آید، پس کوتاه و قابل‌تایپ انتخابش کنید.

آخرش یک توکن می‌دهد؛ رشته‌ای شبیه 8123456789:AAH4k.... این توکن رمز بات شماست. هر کسی آن را داشته باشد می‌تواند به جای بات شما پیام بفرستد. جایی نفرستیدش و در گروه نگذاریدش.

قدم دوم: توکن را در انجیر ذخیره کن

در انجیر یک گردش‌کار بسازید و مرحله‌ی «بات تلگرام» را اضافه کنید. اولین چیزی که می‌خواهد یک اتصال است: روی «اتصال تازه» بزنید، اسمی برای اتصال بگذارید و توکن را در فیلد بچسبانید.

ساختن اتصال بات تلگرام در انجیر

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

قدم سوم: آزمایش کن

اگر گردش‌کارتان با تریگر «پیام جدید» شروع می‌شود، دکمه‌ی آزمایش را بزنید و از حساب شخصی‌تان به بات پیام بدهید. انجیر همان پیام را می‌گیرد و فیلدهایش را نشان می‌دهد: متن پیام، نام فرستنده، شناسه‌ی چت. از همین‌جا به بعد می‌توانید در مرحله‌های بعدی به آن‌ها ارجاع بدهید.

دکمه‌ی آزمایش برای همین است که شکل داده را ببینید؛ لازم نیست بعداً هم هر بار پیام واقعی بسازید.

یک بات، یک گردش‌کار فعال

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

هر بات فقط به آخرین گردش‌کار منتشرشده پیام می‌دهد

پس یا همه‌ی کارها را در یک گردش‌کار جمع کنید (با شرط، بر اساس متن پیام)، یا برای کار دوم یک بات دوم بسازید. ساختن بات دوم رایگان و یک‌دقیقه‌ای است.

چند نکته‌ی عملی

  • بات نمی‌تواند اول پیام بدهد. تا کسی یک بار به بات پیام نداده باشد، بات نمی‌تواند به او چیزی بفرستد. برای همین دکمه‌ی «شروع» و نشانی t.me/... مهم است؛ آن را در سایت و صفحه‌ی تماس بگذارید.
  • در گروه، شناسه با منفی شروع می‌شود. اگر می‌خواهید بات در گروه تیم خبر بدهد، اول بات را عضو گروه کنید، بعد شناسه‌ی گروه را بردارید. دقت کنید که from.id شناسه‌ی فرستنده است نه گروه؛ شناسه‌ی گروه در chat.id است و منفی است. این دو را اشتباه گرفتن، رایج‌ترین دلیل خطای «چت پیدا نشد» است.
  • در گروه، بات همه‌ی پیام‌ها را نمی‌بیند. تلگرام به‌صورت پیش‌فرض حالت حریم خصوصی را روشن می‌گذارد و بات فقط پیام‌هایی را می‌بیند که با / شروع شوند یا پاسخ به خودش باشند. اگر می‌خواهید همه را ببیند، در BotFather دستور /setprivacy را بزنید و خاموشش کنید.
  • ظاهر بات را کامل کنید. با /setdescription، /setabout و /setuserpic در BotFather می‌توانید توضیح، معرفی کوتاه و عکس بات را بگذارید. مشتری قبل از زدن «شروع» همین‌ها را می‌بیند.
  • اگر توکن لو رفت، در BotFather دستور /revoke را بزنید؛ توکن قبلی باطل می‌شود و یک توکن تازه می‌گیرید. بعدش فقط کافی است اتصال را در انجیر با توکن جدید به‌روز کنید.

راهکار آماده

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

اگر مشتری‌هایتان در بله هستند، همین مسیر آنجا هم هست: چطور یک بات بله بسازیم و به انجیر وصلش کنیم.