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

چرا بله

بخشی از مشتری‌های ایرانی، مخصوصاً در شهرهای کوچک‌تر و در کسب‌وکارهایی که با بانک و خدمات داخلی سر و کار دارند، تلگرام ندارند ولی بله دارند. بله پیام‌رسان داخلی است، بدون فیلتر باز می‌شود و بات (که خودش اسمش را «بازو» گذاشته) دقیقاً همان کاری را می‌کند که بات تلگرام می‌کند.

ساختن بازو در بله رایگان است و مثل تلگرام از راه BotFather انجام می‌شود. این راهنما بازو را می‌سازد، به انجیر وصلش می‌کند و تفاوت‌هایش با تلگرام را می‌گوید.

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

• یک حساب بله (با شماره‌ی موبایل ایرانی، از ble.ir)
• یک حساب انجیر (ثبت‌نام رایگان است)
• یک اسم برای بازو و یک نام کاربری که آخرش bot باشد

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

در خود بله دنبال @botfather بگردید و چتش را باز کنید. بنویسید /newbot.

اول نام بازو را می‌خواهد (همانی که مشتری بالای چت می‌بیند، فارسی هم اشکالی ندارد) و بعد نام کاربری انگلیسی که به bot ختم شود.

آخرش توکن را می‌دهد؛ چیزی شبیه 1234567890:xxxxxxxx. این توکن رمز بازوی شماست. هر کسی آن را داشته باشد می‌تواند به جای شما پیام بفرستد، پس جایی نفرستیدش.

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

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

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

فیلد دوم، «توکن پرداخت کیف پول»، فقط وقتی لازم است که بخواهید از مشتری پول بگیرید. آن را هم از همان @botfather می‌گیرید (بازو را انتخاب کنید، بعد گزینه‌ی پرداخت). توکن پرداخت با توکن بازو فرق دارد و جای هم استفاده نمی‌شوند. اگر فقط پیام می‌فرستید، خالی بگذاریدش.

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

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

تفاوت‌هایی که باید بدانید

• یک بازو، یک گردش‌کار فعال. مثل تلگرام، بله هم برای هر بازو فقط یک نشانی نگه می‌دارد. ولی انجیر اینجا اجازه نمی‌دهد بی‌صدا خراب شود: اگر بخواهید گردش‌کار دومی را با همان بازو روشن کنید، با یک خطای صریح جلویتان را می‌گیرد. یا گردش‌کار اول را خاموش کنید، یا برای کار دوم یک بازوی دوم بسازید.
• بازو اول پیام نمی‌دهد. تا کسی یک بار به بازو پیام نداده باشد یا بازو را به گروه اضافه نکرده باشید، نمی‌توانید به او چیزی بفرستید.
• شناسه‌ی چت را از کجا بیاوریم. اگر شناسه‌ی کسی را لازم دارید، یک مرحله‌ی «فراخوانی دلخواه API» اضافه کنید و getUpdates را صدا بزنید؛ شناسه‌ی فرستنده زیر message.from.id است.
• لینک پرداخت بله، لینک معمولی نیست. چیزی که بله می‌دهد داخل خود بله باز می‌شود؛ نمی‌شود آن را پیامک کرد یا در ایمیل گذاشت. اگر مدل کارتان «لینک پرداخت برای مشتری بفرست» است، برای بیرون از بله باید از درگاه معمولی استفاده کنید.
• عدد اول توکن، شناسه‌ی خود بازوست. فرستادن پیام به آن خطا نمی‌دهد ولی هیچ‌کس چیزی نمی‌بیند. اگر پیام‌ها «موفق» می‌روند و کسی دریافت نمی‌کند، اول همین را چک کنید.

راهکار آماده

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

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