هاست ربات بله (پایتون، نود جی اس و PHP)

هاست ربات بله چابکان برای اجرای «بازو»ها در پیام‌رسان بله است؛ بازو اسمی است که بله روی ربات‌هایش گذاشته. بازو را با Python، Node.js، Go یا PHP می‌نویسید، کد را روی سرویس می‌گذارید؛ اگر می‌خواهید بازو داخل ایران اجرا شود، دیتاسنتر ایران را انتخاب کنید. شروع کار هم با ۱۰۰ هزار تومان اعتبار رایگان است.

ساخت ربات بله و گرفتن توکن

در خود اپ بله با @botfather گفتگو کنید و بازوی جدید بسازید. بله به هر بازو یک توکن یکتا می‌دهد که شکلش چیزی شبیه 123456789:abcd... است. همهٔ درخواست‌ها با همین توکن و روی HTTPS به این آدرس می‌روند:

https://tapi.bale.ai/bot<token>/METHOD_NAME

توکن را در بخش متغیرهای محیطی سرویس چابکان بگذارید، مثلاً با نام BALE_TOKEN، تا در کد و مخزن Git نماند.

راه‌اندازی ربات بله با پایتون

یک سرویس Python بسازید، requests را در requirements.txt بنویسید و این کد را با نام main.py در پوشهٔ /app بگذارید. با این نام، بازو بعد از هر ری‌استارت خودش اجرا می‌شود:

import os
import requests

API = f"https://tapi.bale.ai/bot{os.environ['BALE_TOKEN']}"
offset = 0

while True:
    data = requests.get(f"{API}/getUpdates", params={"offset": offset, "timeout": 30}).json()
    for update in data.get("result", []):
        offset = update["update_id"] + 1
        msg = update.get("message")
        if msg and msg.get("text") == "/start":
            requests.post(f"{API}/sendMessage", json={"chat_id": msg["chat"]["id"], "text": "Hello!"})

این روش (Long Polling) دامنه و SSL لازم ندارد. جزئیات ساخت سرویس پایتونی در صفحهٔ هاست پایتون آمده است.

فرق API بله با تلگرام

API بازوی بله بر پایهٔ API بات تلگرام ساخته شده و تغییراتش جزئی است، پس بیشتر کد تلگرامی با عوض کردن آدرس سرور کار می‌کند. چند فرق که موقع کدنویسی به آن می‌خورید:

• وب‌هوک فقط روی پورت‌های 443 و 88 کار می‌کند.
• بله ۲۰۰۰ پیام آخر را تا ۲۴ ساعت نگه می‌دارد؛ اگر بازو بیشتر از این خاموش بماند، پیام‌های قدیمی‌تر را از دست می‌دهد.
• پرداخت با کیف پول بله انجام می‌شود: با متد sendInvoice و توکن پرداختی که از @botfather می‌گیرید، پیام «درخواست پول» می‌فرستید. برای تست، توکن WALLET-TEST-1111111111111111 پولی جابه‌جا نمی‌کند.
• متدهایی مثل askReview (فرم رضایت‌سنجی) و inquireTransaction در کتابخانه‌های تلگرام نیستند و باید مستقیم با درخواست HTTP صدایشان بزنید.

اگر ربات را برای تلگرام هم دارید، راهنمای جدایش در هاست ربات تلگرام است.

دیتاسنتر ایران برای ربات بله

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