电报频道扩展
AgentOS 的双向电报 grammY。 。 。 .
它提供什么
telegramChannelSendMessagetelegramChannelSendMediatelegramChannel
运行时间状态
- 这是全程频道节目.
- 频道保持选入,因为它们可以连接,民意调查,或接收网络呼声.
- 打开它
createCuratedManifest({ channels: ['telegram'] })或自定义扩展列表.
需要的秘密
telegram.botToken
业务更新
一个Telegram Business账户可以连接一个bot到它的私人聊天,然后Telegram发送那个bot business_connection, (中文(简体) ), business_message, (中文(简体) ), edited_business_message 财务报告和审定财务报表 deleted_business_messages 更新。 为了保持一个机器人不聊天, 关闭业务更新:
createExtensionPack({ options: { botToken, dropBusinessUpdates: true } });
或设置 TELEGRAM_BUSINESS_UPDATES=off 在环境中,这就使得 dropBusinessUpdates 默认为 true (明确 dropBusinessUpdates: false 胜过它.
商业更新关闭:
- 投票时间长
getUpdatesa 一个allowed_updatesgrammY 的默认更新类型列表 (API_CONSTANTS.DEFAULT_UPDATE_TYPES) 少了四种商业类型,并且一个webhook以相同的列表注册,因此Telegram停止提供.chat_member, (中文(简体) ),message_reaction财务报告和审定财务报表message_reaction_count停止,因为他们是默认的. - 一个仍然到达的业务更新,一个在列表更改前排入的Telegram队列,在任何处理器运行前被删除. 该包最多一分钟写一个警告, 与计数和种类 从更新本身.
此列表导出为 TELEGRAM_BUSINESS_UPDATE_TYPES,以及 allowedUpdatesWithoutBusiness() 返回时 allowed_updates 列出发件人。 该列表来自 grammY API_CONSTANTS,grammY从1.21.1上输出,所以包依赖于 grammy ^1.21.1。 。 。 .
被拒绝的机器人标志
当Telegram拒绝bot 令牌(在任何Bot API 呼叫上为 401)时,适配器会发出一个 error 服务开始后停止投票:
adapter.on((event) => {
if (event.data?.code === 'auth_failed') {
// event.data is { code: 'auth_failed', channel: 'telegram' }: ask for a new token.
}
}, ['error']);
- 一开始,格拉姆的第一通电话(
getMe),或setWebhook答401:用这个错误开始拒绝. - 在投票期间,
getUpdates回答401:grammY结束其投票循环. - 在频道运行期间,任何其他呼叫回答401(发送,编辑,查询):服务停止并结束投票循环.
事件命名频道, 并带有没有符号和信件文本 。 当包激活时拒绝一个令牌, 在主机订阅前被拒绝, 所以一个订阅的处理器 error 事件结束后,它会得到一次, 就在它订阅之后。 服务会写一个警告. TelegramService 曝光情况 tokenRejected 财务报告和审定财务报表 onTokenRejected(handler),且包输出 CHANNEL_AUTH_FAILED_CODE 财务报告和审定财务报表 isTelegramTokenRejected(err)。 。 。 .
服务器出错(500起及上行)或被丢弃的连接不是被拒绝的代号: grammY再等3 s和民调,频道持续运行.
Bot API 服务器
包打来 https://api.telegram.org 除非另有说明 用一个 本地 Bot API 服务器,或测试服务器,通过地址而不附带斜线:
createExtensionPack({ options: { botToken, apiRoot: 'http://127.0.0.1:8081' } });
或设置 TELEGRAM_API_ROOT 在环境中。 选项胜过变量 。 机器人指使符是每个请求路径的一部分,所以只指向您运行的服务器.
真相来源
manifest.json定义导出的工具和消息通道描述符.src/包含适配器和工具执行.
释放
新版本发表于 架设层/剂-外延 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .