@frogbotai/piece-telegram-bot

通过FrogBot发送Telegram Bot API请求并接收bot更新.

使用量

import { createTelegramBot } from '@frogbotai/piece-telegram-bot';

export const telegramBot = createTelegramBot({
  auth: { botToken: process.env.TELEGRAM_BOT_TOKEN! },
  webhookSecret: process.env.TELEGRAM_WEBHOOK_SECRET!,
  botUsername: 'frogbot',
});

设置

1. 创建机器人 瓶装父亲 并复制其机器人标志.
2. 选择只包含字母、数字、下划线或连字符的 Webhook 密钥 。 保持安静.
3. 登记册 https://<your-host>/api/webhooks/<piece-instance-slug> 与电报 setWebhook 方法并传递与 secret_token。 。 。 .
4. 添加 message, (中文(简体) ), edited_message, (中文(简体) ), channel_post, (中文(简体) ), edited_channel_post,以及 callback_query 改为 allowed_updates中添加 newUpdate。 。 。 .
5. 当机器人必须收到普通的组信息时,以 BotFather 禁用隐私模式 。 将机器人添加到每个组或频道中,并带有读取和回复所需的权限.
6. 在代理商身上挂载实例 channels: [telegramBot] 并明确配置代理服务器 access 允许打算匿名的参与者回电.

Telegram不使用webhook挑战握手. 青蛙Bot 验证每一次交货 X-Telegram-Bot-Api-Secret-Token 头曰. 设定 allowedUserIds 将频道对话限制在已知的Telegram用户ID; 省略或空值允许每个Telegram用户到达bot,但须遵守您青蛙Bot代理访问规则.

允许列表不会认证青蛙Bot 用户 。 Telegram 频道身份总是返回 null,因此默认代理访问甚至拒绝允许上市用户. 对于故意的公职人员, access: () => true 允许每个代理入境点匿名使用。 对于受限访问,使用检查预定通道和参与者的回调 req.context.channel; 保留 allowedUserIds 配置为 Telegram 侧过滤器 .

Telegram允许每个瓶子符号一个webhook. 频道适配器和 newUpdate 共享上面的实例; 不注册单独的订阅 URL。 直接信息、团体和每个论坛专题仍然是单独的谈话.

启动按钮( E)/start),而其他直接消息命令则以命令文本和参数完整地到达代理. 组命令发往 @<botUsername> 使用与普通消息相同的引用和对话路由.

行动

触发器