API پیام‌رسان بله در پیام‌هاب
پشتیبانی از پیام‌رسان بله (Bale) در پیام‌هاب فعال است. می‌توانید حساب انسانی بله را با شماره موبایل و کد یک‌بارمصرف متصل کنید و ارسال و دریافت پیام را از پنل یا REST API مدیریت کنید.
اتصال حساب بله با شماره و OTP
در بخش حساب‌های بله شماره را وارد می‌کنید، کد تأیید را تحویل می‌گیرید و پس از تأیید، سشن حساب به‌شکل امن ذخیره می‌شود. این اتصال Account API است و پیام‌ها با هویت همان حساب انسانی ارسال می‌شوند.
ارسال پیام به شماره موبایل
گیرنده می‌تواند شماره موبایل مانند 09123456789 یا
+989123456789 باشد. پیام‌هاب شماره را در بله به مخاطب و شناسه داخلی
تبدیل می‌کند. همچنین ارسال به @username، شناسه کاربر و شناسه عددی
چت پشتیبانی می‌شود.
ارسال تکی و انبوه با API
برای هر پروژه یک کلید API مستقل با پیشوند ba_ بسازید و آن را در
هدر Bearer قرار دهید. endpointهای ارسال تکی و انبوه، اطلاعات حساب، گزارش ارسال
و پیام‌های ورودی در دسترس‌اند.
curl -X POST https://peyamhub.ir/bale/api/v1/send \
-H "Authorization: Bearer ba_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"09123456789","text":"سلام از پیام‌هاب"}'دریافت پیام و وب‌هوک
listener بله پیام‌های جدید را به‌صورت زنده دریافت و در پنل ثبت می‌کند. می‌توانید
یک URL امن HTTPS تعریف کنید تا هر پیام ورودی با درخواست POST به برنامه، CRM یا
فروشگاه شما تحویل شود. در صورت تعیین Secret، بدنه با HMAC-SHA256 امضا و مقدار
امضا در هدر X-PayamHub-Signature ارسال می‌شود.
امکانات فعال بله
- اتصال حساب انسانی با شماره موبایل و OTP.
- ارسال پیام به شماره، نام کاربری و شناسه چت.
- ارسال تکی و انبوه با پنل یا REST API.
- کلید API اختصاصی برای هر پروژه یا حساب.
- دریافت زنده پیام‌ها و آرشیو پیام ورودی.
- وب‌هوک HTTPS با امضای HMAC-SHA256.
- گزارش موفقیت، خطا و شناسه پیام.
- مستندات فارسی و نمونه کد cURL، Python و PHP.
نکات پایداری و حریم خصوصی
اتصال حساب انسانی بله بر Web RPC غیررسمی استوار است و ممکن است با تغییرات بله نیازمند به‌روزرسانی شود. ارسال ناخواسته یا با نرخ بالا می‌تواند حساب را محدود کند؛ فقط برای مخاطبانی پیام بفرستید که رضایت و ارتباط معتبر با کسب‌وکار شما دارند.
یک پنل برای روبیکا، اینستاگرام و بله
روبیکا، اینستاگرام و بله اکنون در پیام‌هاب فعال‌اند. برای هر پیام‌رسان حساب‌ها، کلیدها، گزارش‌ها و جریان دریافت پیام مستقل است، اما همه از یک داشبورد مدیریت می‌شوند.