GetMyBot 知识库

渠道:Telegram、WhatsApp 和 VK

把 Telegram、WhatsApp 与 VK 接入同一项目,了解各渠道的功能差异和回复去向。

本页内容

一个 GetMyBot 项目可以在 Telegram、WhatsApp 和 VK 回复用户。例如,同一条课程安排规则可用于三个平台,回复会回到用户发消息的渠道。各平台支持的按钮和动作不同,接入后应分别测试。

什么是渠道

渠道是具体的消息入口:一台 Telegram 机器人、一个 WhatsApp Business 号码或一个 VK 社区。同一个项目可有多个渠道,它们共用反应规则。用户从 WhatsApp 发来消息时,也由这些规则处理,再从 WhatsApp 回复。构建器会隐藏不支持的设置或改用可用的形式;发布前请在每个渠道检查消息。

主要渠道 (primary_channel)

每个机器人都有一个主要渠道 primary_channel,即最主要的沟通平台。通常是 Telegram,但也可直接创建没有 Telegram 的 WhatsApp 或 VK 机器人。主要渠道在创建时确定,并显示于机器人列表;其他渠道可随后添加。

渠道功能对照

下列为各消息平台的能力。机器可读的最新能力表来自 GET /api/channels/capabilities。

**Telegram:**支持 inline 按钮、回复键盘、callback(按钮点击启动规则)、emoji 反应、/start 深链接、编辑/删除/转发消息、把回复当触发器、成员事件、权限与管理。照片轮播可在一条消息中用按钮切换。文字可用 Plain / HTML / Markdown。不需要 WhatsApp 模板、列表或会话窗口。

WhatsApp(WhatsApp Cloud API):支持 inline 按钮、callback、emoji 反应、/start 深链接,以及消息模板、交互式列表和24 小时会话窗口。文字可用 Plain / Markdown。不支持回复键盘、编辑/删除/转发消息、把回复当触发器、成员事件、权限管理或在一条消息中切换轮播卡片。参见 WhatsApp。

**VK:**支持消息与附件、inline 按钮与回复键盘、callback、emoji 反应、/start 深链接、编辑/删除/转发消息、成员事件、封禁/解除封禁、批准已提交的封闭社区入会申请,以及付费订阅 VK Donut 事件。仅支持纯文本,渲染时会去除 HTML/Markdown。不支持 WhatsApp 模板、列表、单消息轮播或会话窗口。

所有渠道共同支持 inline 按钮、callback、emoji 反应和 /start 深链接。支持照片的渠道都可使用照片轮播块。仅在每张照片都有适用 file_id 时,Telegram 才把卡片放在一条消息里切换;否则会像 WhatsApp、VK 一样逐张发照片。参见消息与按钮。

VK Donut

如果社区启用了 VK Donut,机器人会收到付费订阅的系统事件:

构建器中的事件键可用变量
VK Donut:新订阅donut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut:续订donut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut:到期donut_subscription_expired无
VK Donut:取消donut_subscription_cancelled无

{{event.donut_amount}} 是付款金额;{{event.donut_amount_without_fee}} 是扣除 VK 手续费后的金额。“到期”和“取消”没有金额,不能拿过去一次的付款金额充当本次金额。

这类事件关于订阅者,并非他发来的消息。因此不会标记私聊可用、解除封禁、更新“最近活动”或增加消息计数。如果平台还不认识这位订阅者,会先建立记录,以便设置标签和权限。

“付费俱乐部”的常见做法:

  1. 为新订阅和续订建立规则,用更改标签添加“俱乐部”标签,设 ttl_days = 31;发送封闭社区链接并请用户提交入会申请。
  2. 批准申请是提交申请之后的单独步骤。 更改权限 → 批准申请 (groups.approveRequest) 只能批准已经提交的申请。可在“我已申请”按钮触发的规则中执行,也可在随后一次续订事件中执行。
  3. 为标签到期 (label_expired) 建立规则,用更改权限 → 移除成员。即使没有收到 VK 的“到期”事件,标签到期时也会移除。参见触发器。
  4. 对取消和到期事件,更改标签以移除“俱乐部”;如需立即移除成员,再执行相应权限动作。

VK 权限动作中的聊天 (chat_id) 必须填写已连接社区的数字 ID,也就是渠道列表中显示的 VK 社区 ID。VK 只能管理这个社区,其他 ID 会在请求发往 VK 前被拒绝。要管理另一社区,请将其另接为渠道。

开启事件的方法:

  • **Long Poll:**接入渠道及平台每次启动时会自动订阅,已有社区无需操作。
  • **Callback API:**在社区设置的 Работа с API → Callback API → Типы событий → VK Donut 中启用表内四种事件。

连接渠道

在项目页面添加渠道:

  1. 找到目标项目,点击项目卡片上的添加渠道。
  2. 选择 Telegram、WhatsApp 或 VK。
  3. 输入凭据:Telegram 使用令牌,WhatsApp 使用 Meta 凭据,VK 使用社区凭据。
  4. 点击验证,让平台向消息服务核对凭据。
  5. 点击连接。

WhatsApp 和 VK 接入后会显示webhook 地址(🔗 图标)。还需要把它填入相应平台:WhatsApp 在 Meta 应用中,VK 在社区设置中。参见 WhatsApp 的 webhook 设置。

接下来

渠道凭据

Telegram 使用 BotFather 的完整令牌。VK 需要社区令牌及数字社区 ID;Callback API 还需密钥字符串和确认码。WhatsApp 需要 Phone Number ID、WhatsApp Business Account ID、拥有账号权限的访问令牌、webhook Verify Token 和 Meta 应用的 App Secret。

连接前核对凭据。更换密钥时,也要在服务提供商处更新对应设置:Verify Token 用于确认 webhook 地址,App Secret 用于校验入站事件签名,两者都不能代替 API 访问令牌。

入站事件与 webhook 地址

使用 VK Callback API 时,把 MyBot 显示的地址登记为社区服务器地址,并设置相同的密钥与确认码。Long Poll 不需要公开地址,也不需要这两项值。WhatsApp 需在 Meta 应用登记地址、填写相同的 Verify Token 并订阅消息事件。只有用于发消息的凭据,并不能让入站消息自动接通。

Instagram 和 Messenger 授权

连接向导会打开 Meta 授权页面。以管理目标 Facebook 页面或专业 Instagram 账号的身份登录,授予请求的权限,再选择要接入此项目的账号。向导会检查权限、webhook 订阅及投递准备状态;请先处理失败项再使用渠道。已有连接也可重新选择账号。