کانال‌ها: Telegram، WhatsApp، VK

بات در GetMyBot می‌تواند هم‌زمان در چند پیام‌رسان کار کند — Telegram، WhatsApp و VK. رفتار را یک بار می‌سازید (واکنش‌ها، شرط‌ها، اقدام‌ها)، و پلتفرم آن را به همان کانالی که رویداد از آن آمده تحویل می‌دهد. به این ترتیب یک سازنده به همهٔ کانال‌ها سرویس می‌دهد و لازم نیست برای هر کانال جداگانه راه‌اندازی شود.

کانال چیست

کانال یک بستر تحویل متصل‌شده است: یک بات مشخص Telegram، یک شمارهٔ WhatsApp Business یا یک اجتماع VK. یک بات GetMyBot می‌تواند چند کانال داشته باشد. واکنش‌ها مشترک‌اند: وقتی مشترک در WhatsApp می‌نویسد، رویداد با همان واکنش‌های Telegram پردازش می‌شود و پاسخ به WhatsApp بازمی‌گردد.

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

کانال اصلی (primary_channel)

هر بات یک کانال اصلی (primary_channel) دارد — بستری که بات پیش از هر چیز با آن شناخته می‌شود. معمولاً Telegram است، اما می‌توان بات را مستقیماً به‌عنوان بات WhatsApp یا VK و بدون Telegram ساخت. کانال اصلی هنگام ایجاد تعیین می‌شود و در فهرست بات‌ها دیده می‌شود؛ بقیهٔ کانال‌ها بعداً به بات افزوده می‌شوند.

ماتریس قابلیت‌های کانال‌ها

در زیر آمده که هر کانال کدام قابلیت‌های پیام‌رسان را پشتیبانی می‌کند. ماتریس به‌روز را API به شکل ماشین‌خوان می‌دهد: GET /api/channels/capabilities.

Telegram — کانال مرجع با مجموعهٔ کامل قابلیت‌ها: دکمه‌های inline و صفحه‌کلید reply، callback (فشردن دکمه ← واکنش)، واکنش‌های ایموجی، deep-link /start، ویرایش و حذف و بازارسال پیام‌ها، reply به‌عنوان محرک، رویدادهای اعضا، دسترسی‌ها و مدیریت. قالب‌بندی متن — Plain / HTML / Markdown. قالب، فهرست، carousel و پنجرهٔ نشست ندارد (در Telegram لازم نیستند).

WhatsApp (از طریق WhatsApp Cloud API) — با ویژگی خاص خود: دکمه‌های inline، callback، واکنش‌های ایموجی، deep-link /start، قالب‌های پیام، فهرست‌ها (interactive list) و پنجرهٔ نشست ۲۴ ساعته. قالب‌بندی — Plain / Markdown. صفحه‌کلید reply، ویرایش، حذف و بازارسال پیام‌ها، reply به‌عنوان محرک، رویدادهای اعضا، دسترسی/مدیریت و carousel را پشتیبانی نمی‌کند. جزئیات بیشتر در صفحهٔ WhatsApp.

VK — پیام‌ها و پیوست‌ها، دکمه‌های inline و صفحه‌کلید reply، callback، واکنش‌های ایموجی، deep-link /start، ویرایش و حذف پیام‌ها، بازارسال، رویدادهای اعضا، مسدودسازی/رفع مسدودسازی. قالب‌بندی — فقط متن ساده (HTML/Markdown هنگام رندر حذف می‌شود). قالب WhatsApp، فهرست، carousel و پنجرهٔ نشست در VK وجود ندارد.

مشترک میان همهٔ کانال‌ها: دکمه‌های inline، callback، واکنش‌های ایموجی و deep-link /start. carousel را هنوز هیچ کانالی پشتیبانی نمی‌کند.

چگونه یک کانال متصل کنیم

کانال‌ها در صفحهٔ بات‌ها (/app/bots) افزوده می‌شوند.

  1. بات‌ها را باز کنید و بات موردنظر را بیابید.
  2. روی «افزودن کانال» در کارت بات کلیک کنید.
  3. پلتفرم را انتخاب کنید — Telegram، WhatsApp یا VK.
  4. مشخصات کانال را وارد کنید (برای Telegram — توکن، برای WhatsApp — مجموعهٔ مشخصات Meta، برای VK — مشخصات اجتماع).
  5. روی «بررسی» کلیک کنید — پلتفرم اعتبارنامه‌ها را نزد پیام‌رسان بررسی می‌کند.
  6. روی «اتصال» کلیک کنید.

برای WhatsApp و VK پس از اتصال، کانال یک آدرس webhook پیدا می‌کند (آیکون 🔗). این آدرس باید در سمت پلتفرم ثبت شود (در اپلیکیشن Meta برای WhatsApp، در تنظیمات اجتماع برای VK) تا رویدادهای ورودی به بات برسند. نحوهٔ انجام آن برای WhatsApp — در WhatsApp ← پیکربندی webhook.

بیشتر بخوانید