@apicity/telegram

中文文档
0.26.0发布于 2026/11/05MITTypeScriptES Module近 30 天下载 4752

电报 提供Bot API,用于发送信息,媒体,民意调查,以及丰富的信息.

中文使用文档
文档目录142 节
  1. 安装
  2. 快速启动
  3. 设置
  4. API 参考
  5. 添加 Sticker 选项
  6. 回话查询
  7. 回答ChatJoin 请求查询
  8. 回答嘉宾查询
  9. 回答内置查询
  10. 回答预检查查询
  11. 解答测试
  12. 回答WebApp查询
  13. 批准ChatJoin请求
  14. 建议核准
  15. banChat 成员
  16. banChat 发音
  17. 关闭
  18. 关闭论坛
  19. 一般论坛图示
  20. 转换 GiftTo星
  21. 复制信
  22. 副本
  23. 创建 ChatInviteLink 链接
  24. 创建 Chat 订阅InviteLink
  25. 创建论坛图
  26. 创建语音链接
  27. 创建NewStickerSet
  28. 递减ChatJoin 请求
  29. 已建议
  30. 删除全部信件反应
  31. 删除商业信息
  32. 删除ChatPhoto
  33. 删除 ChatStickerSet 服务器
  34. 删除论坛图
  35. 删除信件
  36. 删除信件反应
  37. 删除
  38. 删除我的指令
  39. 删除 Sticker from Set
  40. 删除StickerSet
  41. 删除故事
  42. 删除网易
  43. 编辑ChatInviteLink
  44. 编辑Chat 订阅InviteLink
  45. 编辑论坛图
  46. 编辑一般论坛图
  47. 编辑
  48. 编辑信件检查列表
  49. 编辑MessageLiveLocation
  50. 编辑媒体
  51. 编辑Message Reply Markup
  52. 编辑Message 文本
  53. 编辑故事
  54. 编辑用户星订阅
  55. 导出ChatInviteLink
  56. 转发
  57. 转发
  58. 获得易碎食品
  59. 获得商业账户
  60. 获取商业账户星报
  61. 获取商务连接
  62. 获取聊天
  63. 获取聊天管理员
  64. 获取ChatGifts
  65. 获取聊天成员
  66. 获取Chat MemberCount
  67. 获取 ChatMenu 按钮
  68. 获取 Custom EmojiSticers 客户
  69. 获取文件
  70. 获取论坛
  71. 获得高分数
  72. 管理Bot 访问安排
  73. 获得管理盒
  74. 带我
  75. 获取我的命令
  76. 获取我的过失管理者权利
  77. 获取我的描述
  78. 获取我的Name
  79. 获取 MyShort 描述
  80. 获取我的星光旗
  81. 获取星际交易
  82. 获取StickerSet
  83. 获取更新
  84. 获取用户聊天室
  85. 获取用户选择
  86. 获取用户个人通讯
  87. 获取用户ProfileAudios
  88. 获取用户ProfilePhotos
  89. 获取 Webhook 信息
  90. 礼品订阅
  91. 隐藏一般论坛图案
  92. 离开聊天
  93. 日志出
  94. pinChat 图像
  95. 邮编
  96. 推动聊天成员
  97. 读取商务信息
  98. 偿还星际支付
  99. 删除商务账户ProfilePhoto
  100. 删除查特验证
  101. 删除我的ProfilePhoto
  102. 删除用户验证
  103. 重新打开论坛
  104. 重新打开一般论坛
  105. 替换 Managed BotToken
  106. 替换 StickerInSet
  107. 调出故事
  108. 限制聊天成员
  109. 取消 ChatInviteLink 链接
  110. 保存已准备的内存
  111. 保存已准备的键盘按钮
  112. 发送动画
  113. 发送奥迪奥
  114. 发送聊天动作
  115. 发送ChatJoin 请求WebApp
  116. 发送检查列表
  117. 发送联系
  118. 发送目录
  119. 发送文档
  120. 发送Game
  121. 发送图像
  122. 发送发票
  123. 发送LivePhoto
  124. 发送地址
  125. 发送媒体组
  126. 发送消息
  127. 发送信稿
  128. 发送PaidMedia
  129. 发送图片
  130. 发送Poll
  131. 发送 RichMessage
  132. 发送 RichMessage 草稿
  133. 发送Sticker
  134. 发送窗口
  135. 发送视频
  136. 发送视频注释
  137. 发送声音
  138. 商业账户Bio
  139. 商业账户设置
  140. 设置商业账户Name
  141. 设置商业账户ProfilePhoto
  142. 设置商业账户用户名

@ apicity/ 电报

npm dependencies TypeScript docs

电报 提供Bot API,用于发送信息,媒体,民意调查,以及丰富的信息.

运行时间依赖性 :

  • zod@^4.6.6 - 请求在每一个 POST 端点上附加计划 .schema

安装

npm install @apicity/telegram
# or
pnpm add @apicity/telegram

快速启动

import { createTelegram } from "@apicity/telegram";

const telegram = createTelegram({ botToken: process.env.TELEGRAM_BOT_KEY! });

设置

此套件使用Telegram Bot API 令牌. 在这回购中, TELEGRAM_BOT_KEY 从 1Password 中解析 @apicitylogbot。 。 。 .

import { createTelegram } from "@apicity/telegram";

const telegram = createTelegram({
  botToken: process.env.TELEGRAM_BOT_KEY!,
});

await telegram.sendMessage({
  chat_id: "@your_channel_or_chat_id",
  text: "hello from @apicity/telegram",
});

const photo = new Blob(["image bytes"], { type: "image/png" });
await telegram.sendPhoto({
  chat_id: "@your_channel_or_chat_id",
  photo,
  caption: "uploaded from @apicitylogbot",
});

页:1

  • chat_id 可以是数字聊天id或用户名,例如 @channelname。 。 。 .
  • photo, (中文(简体) ), video, (中文(简体) ), audio, (中文(简体) ), thumbnail,以及 cover 接受电报 file_id,一个 HTTP URL,一个 attach://... 参考文献,或 a Blob。 。 。 .
  • Blob 有效载荷作为 multipart/form-data; 使用字符串有效载荷 application/json。 。 。 .
  • 已录制的例子 : 红外博物令牌、 Webhook 秘密令牌、 付款 有效载荷、护照数据、Telegram文件标识符和Blob字节.

API 参考

180组的180个终点. 每个方法都映射出上游的 URL 路径 .

添加 Sticker 选项

POST telegram.addStickerToSet

POST https://api.telegram.org/bot{token}/addStickerToSet

成本等级 : cheap

上游区域

const res = await telegram.addStickerToSet({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

回话查询

POST telegram.answerCallbackQuery

POST https://api.telegram.org/bot{token}/answerCallbackQuery

成本等级 : cheap

上游区域

const res = await telegram.answerCallbackQuery({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

回答ChatJoin 请求查询

POST telegram.answerChatJoinRequestQuery

POST https://api.telegram.org/bot{token}/answerChatJoinRequestQuery

成本等级 : cheap

上游区域

const res = await telegram.answerChatJoinRequestQuery({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

回答嘉宾查询

POST telegram.answerGuestQuery

POST https://api.telegram.org/bot{token}/answerGuestQuery

成本等级 : cheap

上游区域

const res = await telegram.answerGuestQuery({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

回答内置查询

POST telegram.answerInlineQuery

POST https://api.telegram.org/bot{token}/answerInlineQuery

成本等级 : cheap

上游区域

const res = await telegram.answerInlineQuery({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

回答预检查查询

POST telegram.answerPreCheckoutQuery

POST https://api.telegram.org/bot{token}/answerPreCheckoutQuery

成本等级 : cheap

上游区域

const res = await telegram.answerPreCheckoutQuery({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

解答测试

POST telegram.answerShippingQuery

POST https://api.telegram.org/bot{token}/answerShippingQuery

成本等级 : cheap

上游区域

const res = await telegram.answerShippingQuery({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

回答WebApp查询

POST telegram.answerWebAppQuery

POST https://api.telegram.org/bot{token}/answerWebAppQuery

成本等级 : cheap

上游区域

const res = await telegram.answerWebAppQuery({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

批准ChatJoin请求

POST telegram.approveChatJoinRequest

POST https://api.telegram.org/bot{token}/approveChatJoinRequest

成本等级 : cheap

上游区域

const res = await telegram.approveChatJoinRequest({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

建议核准

POST telegram.approveSuggestedPost

POST https://api.telegram.org/bot{token}/approveSuggestedPost

成本等级 : cheap

上游区域

const res = await telegram.approveSuggestedPost({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

banChat 成员

POST telegram.banChatMember

POST https://api.telegram.org/bot{token}/banChatMember

成本等级 : cheap

上游区域

const res = await telegram.banChatMember({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

banChat 发音

POST telegram.banChatSenderChat

POST https://api.telegram.org/bot{token}/banChatSenderChat

成本等级 : cheap

上游区域

const res = await telegram.banChatSenderChat({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

关闭

POST telegram.close

POST https://api.telegram.org/bot{token}/close

成本等级 : cheap

上游区域

const res = await telegram.close({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

关闭论坛

POST telegram.closeForumTopic

POST https://api.telegram.org/bot{token}/closeForumTopic

成本等级 : cheap

上游区域

const res = await telegram.closeForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

一般论坛图示

POST telegram.closeGeneralForumTopic

POST https://api.telegram.org/bot{token}/closeGeneralForumTopic

成本等级 : cheap

上游区域

const res = await telegram.closeGeneralForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

转换 GiftTo星

POST telegram.convertGiftToStars

POST https://api.telegram.org/bot{token}/convertGiftToStars

成本等级 : cheap

上游区域

const res = await telegram.convertGiftToStars({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

复制信

POST telegram.copyMessage

POST https://api.telegram.org/bot{token}/copyMessage

成本等级 : cheap

上游区域

const res = await telegram.copyMessage({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

副本

POST telegram.copyMessages

POST https://api.telegram.org/bot{token}/copyMessages

成本等级 : cheap

上游区域

const res = await telegram.copyMessages({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

POST telegram.createChatInviteLink

POST https://api.telegram.org/bot{token}/createChatInviteLink

成本等级 : cheap

上游区域

const res = await telegram.createChatInviteLink({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

POST telegram.createChatSubscriptionInviteLink

POST https://api.telegram.org/bot{token}/createChatSubscriptionInviteLink

成本等级 : cheap

上游区域

const res = await telegram.createChatSubscriptionInviteLink({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

创建论坛图

POST telegram.createForumTopic

POST https://api.telegram.org/bot{token}/createForumTopic

成本等级 : cheap

上游区域

const res = await telegram.createForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

POST telegram.createInvoiceLink

POST https://api.telegram.org/bot{token}/createInvoiceLink

成本等级 : cheap

上游区域

const res = await telegram.createInvoiceLink({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

创建NewStickerSet

POST telegram.createNewStickerSet

POST https://api.telegram.org/bot{token}/createNewStickerSet

成本等级 : cheap

上游区域

const res = await telegram.createNewStickerSet({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

递减ChatJoin 请求

POST telegram.declineChatJoinRequest

POST https://api.telegram.org/bot{token}/declineChatJoinRequest

成本等级 : cheap

上游区域

const res = await telegram.declineChatJoinRequest({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

已建议

POST telegram.declineSuggestedPost

POST https://api.telegram.org/bot{token}/declineSuggestedPost

成本等级 : cheap

上游区域

const res = await telegram.declineSuggestedPost({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除全部信件反应

POST telegram.deleteAllMessageReactions

POST https://api.telegram.org/bot{token}/deleteAllMessageReactions

成本等级 : cheap

上游区域

const res = await telegram.deleteAllMessageReactions({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除商业信息

POST telegram.deleteBusinessMessages

POST https://api.telegram.org/bot{token}/deleteBusinessMessages

成本等级 : cheap

上游区域

const res = await telegram.deleteBusinessMessages({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除ChatPhoto

POST telegram.deleteChatPhoto

POST https://api.telegram.org/bot{token}/deleteChatPhoto

成本等级 : cheap

上游区域

const res = await telegram.deleteChatPhoto({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除 ChatStickerSet 服务器

POST telegram.deleteChatStickerSet

POST https://api.telegram.org/bot{token}/deleteChatStickerSet

成本等级 : cheap

上游区域

const res = await telegram.deleteChatStickerSet({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除论坛图

POST telegram.deleteForumTopic

POST https://api.telegram.org/bot{token}/deleteForumTopic

成本等级 : cheap

上游区域

const res = await telegram.deleteForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除信件

POST telegram.deleteMessage

POST https://api.telegram.org/bot{token}/deleteMessage

成本等级 : cheap

上游区域

const res = await telegram.deleteMessage({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除信件反应

POST telegram.deleteMessageReaction

POST https://api.telegram.org/bot{token}/deleteMessageReaction

成本等级 : cheap

上游区域

const res = await telegram.deleteMessageReaction({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除

POST telegram.deleteMessages

POST https://api.telegram.org/bot{token}/deleteMessages

成本等级 : cheap

上游区域

const res = await telegram.deleteMessages({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除我的指令

POST telegram.deleteMyCommands

POST https://api.telegram.org/bot{token}/deleteMyCommands

成本等级 : cheap

上游区域

const res = await telegram.deleteMyCommands({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除 Sticker from Set

POST telegram.deleteStickerFromSet

POST https://api.telegram.org/bot{token}/deleteStickerFromSet

成本等级 : cheap

上游区域

const res = await telegram.deleteStickerFromSet({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除StickerSet

POST telegram.deleteStickerSet

POST https://api.telegram.org/bot{token}/deleteStickerSet

成本等级 : cheap

上游区域

const res = await telegram.deleteStickerSet({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除故事

POST telegram.deleteStory

POST https://api.telegram.org/bot{token}/deleteStory

成本等级 : cheap

上游区域

const res = await telegram.deleteStory({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除网易

POST telegram.deleteWebhook

POST https://api.telegram.org/bot{token}/deleteWebhook

成本等级 : cheap

上游区域

const res = await telegram.deleteWebhook({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

POST telegram.editChatInviteLink

POST https://api.telegram.org/bot{token}/editChatInviteLink

成本等级 : cheap

上游区域

const res = await telegram.editChatInviteLink({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

POST telegram.editChatSubscriptionInviteLink

POST https://api.telegram.org/bot{token}/editChatSubscriptionInviteLink

成本等级 : cheap

上游区域

const res = await telegram.editChatSubscriptionInviteLink({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑论坛图

POST telegram.editForumTopic

POST https://api.telegram.org/bot{token}/editForumTopic

成本等级 : cheap

上游区域

const res = await telegram.editForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑一般论坛图

POST telegram.editGeneralForumTopic

POST https://api.telegram.org/bot{token}/editGeneralForumTopic

成本等级 : cheap

上游区域

const res = await telegram.editGeneralForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑

POST telegram.editMessageCaption

POST https://api.telegram.org/bot{token}/editMessageCaption

成本等级 : cheap

上游区域

const res = await telegram.editMessageCaption({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑信件检查列表

POST telegram.editMessageChecklist

POST https://api.telegram.org/bot{token}/editMessageChecklist

成本等级 : cheap

上游区域

const res = await telegram.editMessageChecklist({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑MessageLiveLocation

POST telegram.editMessageLiveLocation

POST https://api.telegram.org/bot{token}/editMessageLiveLocation

成本等级 : cheap

上游区域

const res = await telegram.editMessageLiveLocation({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑媒体

POST telegram.editMessageMedia

POST https://api.telegram.org/bot{token}/editMessageMedia

成本等级 : cheap

上游区域

const res = await telegram.editMessageMedia({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑Message Reply Markup

POST telegram.editMessageReplyMarkup

POST https://api.telegram.org/bot{token}/editMessageReplyMarkup

成本等级 : cheap

上游区域

const res = await telegram.editMessageReplyMarkup({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑Message 文本

POST telegram.editMessageText

POST https://api.telegram.org/bot{token}/editMessageText

成本等级 : cheap

上游区域

const res = await telegram.editMessageText({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑故事

POST telegram.editStory

POST https://api.telegram.org/bot{token}/editStory

成本等级 : cheap

上游区域

const res = await telegram.editStory({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

编辑用户星订阅

POST telegram.editUserStarSubscription

POST https://api.telegram.org/bot{token}/editUserStarSubscription

成本等级 : cheap

上游区域

const res = await telegram.editUserStarSubscription({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

POST telegram.exportChatInviteLink

POST https://api.telegram.org/bot{token}/exportChatInviteLink

成本等级 : cheap

上游区域

const res = await telegram.exportChatInviteLink({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

转发

POST telegram.forwardMessage

POST https://api.telegram.org/bot{token}/forwardMessage

成本等级 : cheap

上游区域

const res = await telegram.forwardMessage({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

转发

POST telegram.forwardMessages

POST https://api.telegram.org/bot{token}/forwardMessages

成本等级 : cheap

上游区域

const res = await telegram.forwardMessages({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获得易碎食品

POST telegram.getAvailableGifts

POST https://api.telegram.org/bot{token}/getAvailableGifts

成本等级 : cheap

上游区域

const res = await telegram.getAvailableGifts({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获得商业账户

POST telegram.getBusinessAccountGifts

POST https://api.telegram.org/bot{token}/getBusinessAccountGifts

成本等级 : cheap

上游区域

const res = await telegram.getBusinessAccountGifts({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取商业账户星报

POST telegram.getBusinessAccountStarBalance

POST https://api.telegram.org/bot{token}/getBusinessAccountStarBalance

成本等级 : cheap

上游区域

const res = await telegram.getBusinessAccountStarBalance({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取商务连接

POST telegram.getBusinessConnection

POST https://api.telegram.org/bot{token}/getBusinessConnection

成本等级 : cheap

上游区域

const res = await telegram.getBusinessConnection({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取聊天

POST telegram.getChat

POST https://api.telegram.org/bot{token}/getChat

成本等级 : cheap

上游区域

const res = await telegram.getChat({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取聊天管理员

POST telegram.getChatAdministrators

POST https://api.telegram.org/bot{token}/getChatAdministrators

成本等级 : cheap

上游区域

const res = await telegram.getChatAdministrators({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取ChatGifts

POST telegram.getChatGifts

POST https://api.telegram.org/bot{token}/getChatGifts

成本等级 : cheap

上游区域

const res = await telegram.getChatGifts({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取聊天成员

POST telegram.getChatMember

POST https://api.telegram.org/bot{token}/getChatMember

成本等级 : cheap

上游区域

const res = await telegram.getChatMember({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取Chat MemberCount

POST telegram.getChatMemberCount

POST https://api.telegram.org/bot{token}/getChatMemberCount

成本等级 : cheap

上游区域

const res = await telegram.getChatMemberCount({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取 ChatMenu 按钮

POST telegram.getChatMenuButton

POST https://api.telegram.org/bot{token}/getChatMenuButton

成本等级 : cheap

上游区域

const res = await telegram.getChatMenuButton({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取 Custom EmojiSticers 客户

POST telegram.getCustomEmojiStickers

POST https://api.telegram.org/bot{token}/getCustomEmojiStickers

成本等级 : cheap

上游区域

const res = await telegram.getCustomEmojiStickers({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取文件

POST telegram.getFile

POST https://api.telegram.org/bot{token}/getFile

成本等级 : cheap

上游区域

const res = await telegram.getFile({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取论坛

POST telegram.getForumTopicIconStickers

POST https://api.telegram.org/bot{token}/getForumTopicIconStickers

成本等级 : cheap

上游区域

const res = await telegram.getForumTopicIconStickers({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获得高分数

POST telegram.getGameHighScores

POST https://api.telegram.org/bot{token}/getGameHighScores

成本等级 : cheap

上游区域

const res = await telegram.getGameHighScores({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

管理Bot 访问安排

POST telegram.getManagedBotAccessSettings

POST https://api.telegram.org/bot{token}/getManagedBotAccessSettings

成本等级 : cheap

上游区域

const res = await telegram.getManagedBotAccessSettings({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获得管理盒

POST telegram.getManagedBotToken

POST https://api.telegram.org/bot{token}/getManagedBotToken

成本等级 : cheap

上游区域

const res = await telegram.getManagedBotToken({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

带我

POST telegram.getMe

POST https://api.telegram.org/bot{token}/getMe

成本等级 : cheap

上游区域

const res = await telegram.getMe({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取我的命令

POST telegram.getMyCommands

POST https://api.telegram.org/bot{token}/getMyCommands

成本等级 : cheap

上游区域

const res = await telegram.getMyCommands({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取我的过失管理者权利

POST telegram.getMyDefaultAdministratorRights

POST https://api.telegram.org/bot{token}/getMyDefaultAdministratorRights

成本等级 : cheap

上游区域

const res = await telegram.getMyDefaultAdministratorRights({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取我的描述

POST telegram.getMyDescription

POST https://api.telegram.org/bot{token}/getMyDescription

成本等级 : cheap

上游区域

const res = await telegram.getMyDescription({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取我的Name

POST telegram.getMyName

POST https://api.telegram.org/bot{token}/getMyName

成本等级 : cheap

上游区域

const res = await telegram.getMyName({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取 MyShort 描述

POST telegram.getMyShortDescription

POST https://api.telegram.org/bot{token}/getMyShortDescription

成本等级 : cheap

上游区域

const res = await telegram.getMyShortDescription({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取我的星光旗

POST telegram.getMyStarBalance

POST https://api.telegram.org/bot{token}/getMyStarBalance

成本等级 : cheap

上游区域

const res = await telegram.getMyStarBalance({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取星际交易

POST telegram.getStarTransactions

POST https://api.telegram.org/bot{token}/getStarTransactions

成本等级 : cheap

上游区域

const res = await telegram.getStarTransactions({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取StickerSet

POST telegram.getStickerSet

POST https://api.telegram.org/bot{token}/getStickerSet

成本等级 : cheap

上游区域

const res = await telegram.getStickerSet({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取更新

POST telegram.getUpdates

POST https://api.telegram.org/bot{token}/getUpdates

成本等级 : cheap

上游区域

const res = await telegram.getUpdates({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取用户聊天室

POST telegram.getUserChatBoosts

POST https://api.telegram.org/bot{token}/getUserChatBoosts

成本等级 : cheap

上游区域

const res = await telegram.getUserChatBoosts({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取用户选择

POST telegram.getUserGifts

POST https://api.telegram.org/bot{token}/getUserGifts

成本等级 : cheap

上游区域

const res = await telegram.getUserGifts({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取用户个人通讯

POST telegram.getUserPersonalChatMessages

POST https://api.telegram.org/bot{token}/getUserPersonalChatMessages

成本等级 : cheap

上游区域

const res = await telegram.getUserPersonalChatMessages({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取用户ProfileAudios

POST telegram.getUserProfileAudios

POST https://api.telegram.org/bot{token}/getUserProfileAudios

成本等级 : cheap

上游区域

const res = await telegram.getUserProfileAudios({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取用户ProfilePhotos

POST telegram.getUserProfilePhotos

POST https://api.telegram.org/bot{token}/getUserProfilePhotos

成本等级 : cheap

上游区域

const res = await telegram.getUserProfilePhotos({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

获取 Webhook 信息

POST telegram.getWebhookInfo

POST https://api.telegram.org/bot{token}/getWebhookInfo

成本等级 : cheap

上游区域

const res = await telegram.getWebhookInfo({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

礼品订阅

POST telegram.giftPremiumSubscription

POST https://api.telegram.org/bot{token}/giftPremiumSubscription

成本等级 : cheap

上游区域

const res = await telegram.giftPremiumSubscription({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

隐藏一般论坛图案

POST telegram.hideGeneralForumTopic

POST https://api.telegram.org/bot{token}/hideGeneralForumTopic

成本等级 : cheap

上游区域

const res = await telegram.hideGeneralForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

离开聊天

POST telegram.leaveChat

POST https://api.telegram.org/bot{token}/leaveChat

成本等级 : cheap

上游区域

const res = await telegram.leaveChat({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

日志出

POST telegram.logOut

POST https://api.telegram.org/bot{token}/logOut

成本等级 : cheap

上游区域

const res = await telegram.logOut({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

pinChat 图像

POST telegram.pinChatMessage

POST https://api.telegram.org/bot{token}/pinChatMessage

成本等级 : cheap

上游区域

const res = await telegram.pinChatMessage({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

邮编

POST telegram.postStory

POST https://api.telegram.org/bot{token}/postStory

成本等级 : cheap

上游区域

const res = await telegram.postStory({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

推动聊天成员

POST telegram.promoteChatMember

POST https://api.telegram.org/bot{token}/promoteChatMember

成本等级 : cheap

上游区域

const res = await telegram.promoteChatMember({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

读取商务信息

POST telegram.readBusinessMessage

POST https://api.telegram.org/bot{token}/readBusinessMessage

成本等级 : cheap

上游区域

const res = await telegram.readBusinessMessage({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

偿还星际支付

POST telegram.refundStarPayment

POST https://api.telegram.org/bot{token}/refundStarPayment

成本等级 : cheap

上游区域

const res = await telegram.refundStarPayment({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除商务账户ProfilePhoto

POST telegram.removeBusinessAccountProfilePhoto

POST https://api.telegram.org/bot{token}/removeBusinessAccountProfilePhoto

成本等级 : cheap

上游区域

const res = await telegram.removeBusinessAccountProfilePhoto({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除查特验证

POST telegram.removeChatVerification

POST https://api.telegram.org/bot{token}/removeChatVerification

成本等级 : cheap

上游区域

const res = await telegram.removeChatVerification({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除我的ProfilePhoto

POST telegram.removeMyProfilePhoto

POST https://api.telegram.org/bot{token}/removeMyProfilePhoto

成本等级 : cheap

上游区域

const res = await telegram.removeMyProfilePhoto({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

删除用户验证

POST telegram.removeUserVerification

POST https://api.telegram.org/bot{token}/removeUserVerification

成本等级 : cheap

上游区域

const res = await telegram.removeUserVerification({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

重新打开论坛

POST telegram.reopenForumTopic

POST https://api.telegram.org/bot{token}/reopenForumTopic

成本等级 : cheap

上游区域

const res = await telegram.reopenForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

重新打开一般论坛

POST telegram.reopenGeneralForumTopic

POST https://api.telegram.org/bot{token}/reopenGeneralForumTopic

成本等级 : cheap

上游区域

const res = await telegram.reopenGeneralForumTopic({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

替换 Managed BotToken

POST telegram.replaceManagedBotToken

POST https://api.telegram.org/bot{token}/replaceManagedBotToken

成本等级 : cheap

上游区域

const res = await telegram.replaceManagedBotToken({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

替换 StickerInSet

POST telegram.replaceStickerInSet

POST https://api.telegram.org/bot{token}/replaceStickerInSet

成本等级 : cheap

上游区域

const res = await telegram.replaceStickerInSet({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

调出故事

POST telegram.repostStory

POST https://api.telegram.org/bot{token}/repostStory

成本等级 : cheap

上游区域

const res = await telegram.repostStory({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

限制聊天成员

POST telegram.restrictChatMember

POST https://api.telegram.org/bot{token}/restrictChatMember

成本等级 : cheap

上游区域

const res = await telegram.restrictChatMember({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

POST telegram.revokeChatInviteLink

POST https://api.telegram.org/bot{token}/revokeChatInviteLink

成本等级 : cheap

上游区域

const res = await telegram.revokeChatInviteLink({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

保存已准备的内存

POST telegram.savePreparedInlineMessage

POST https://api.telegram.org/bot{token}/savePreparedInlineMessage

成本等级 : cheap

上游区域

const res = await telegram.savePreparedInlineMessage({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

保存已准备的键盘按钮

POST telegram.savePreparedKeyboardButton

POST https://api.telegram.org/bot{token}/savePreparedKeyboardButton

成本等级 : cheap

上游区域

const res = await telegram.savePreparedKeyboardButton({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送动画

POST telegram.sendAnimation

POST https://api.telegram.org/bot{token}/sendAnimation

成本等级 : cheap

上游区域

const res = await telegram.sendAnimation({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送奥迪奥

POST telegram.sendAudio

POST https://api.telegram.org/bot{token}/sendAudio

成本等级 : cheap

上游区域

const res = await telegram.sendAudio({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送聊天动作

POST telegram.sendChatAction

POST https://api.telegram.org/bot{token}/sendChatAction

成本等级 : cheap

上游区域

const res = await telegram.sendChatAction({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送ChatJoin 请求WebApp

POST telegram.sendChatJoinRequestWebApp

POST https://api.telegram.org/bot{token}/sendChatJoinRequestWebApp

成本等级 : cheap

上游区域

const res = await telegram.sendChatJoinRequestWebApp({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送检查列表

POST telegram.sendChecklist

POST https://api.telegram.org/bot{token}/sendChecklist

成本等级 : cheap

上游区域

const res = await telegram.sendChecklist({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送联系

POST telegram.sendContact

POST https://api.telegram.org/bot{token}/sendContact

成本等级 : cheap

上游区域

const res = await telegram.sendContact({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送目录

POST telegram.sendDice

POST https://api.telegram.org/bot{token}/sendDice

成本等级 : cheap

上游区域

const res = await telegram.sendDice({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送文档

POST telegram.sendDocument

POST https://api.telegram.org/bot{token}/sendDocument

成本等级 : cheap

上游区域

const res = await telegram.sendDocument({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送Game

POST telegram.sendGame

POST https://api.telegram.org/bot{token}/sendGame

成本等级 : cheap

上游区域

const res = await telegram.sendGame({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送图像

POST telegram.sendGift

POST https://api.telegram.org/bot{token}/sendGift

成本等级 : cheap

上游区域

const res = await telegram.sendGift({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送发票

POST telegram.sendInvoice

POST https://api.telegram.org/bot{token}/sendInvoice

成本等级 : cheap

上游区域

const res = await telegram.sendInvoice({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送LivePhoto

POST telegram.sendLivePhoto

POST https://api.telegram.org/bot{token}/sendLivePhoto

成本等级 : cheap

上游区域

const res = await telegram.sendLivePhoto({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送地址

POST telegram.sendLocation

POST https://api.telegram.org/bot{token}/sendLocation

成本等级 : cheap

上游区域

const res = await telegram.sendLocation({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送媒体组

POST telegram.sendMediaGroup

POST https://api.telegram.org/bot{token}/sendMediaGroup

成本等级 : cheap

上游区域

const res = await telegram.sendMediaGroup({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送消息

POST telegram.sendMessage

POST https://api.telegram.org/bot{token}/sendMessage

成本等级 : cheap

上游区域

const res = await telegram.sendMessage({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送信稿

POST telegram.sendMessageDraft

POST https://api.telegram.org/bot{token}/sendMessageDraft

成本等级 : cheap

上游区域

const res = await telegram.sendMessageDraft({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送PaidMedia

POST telegram.sendPaidMedia

POST https://api.telegram.org/bot{token}/sendPaidMedia

成本等级 : cheap

上游区域

const res = await telegram.sendPaidMedia({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送图片

POST telegram.sendPhoto

POST https://api.telegram.org/bot{token}/sendPhoto

成本等级 : cheap

上游区域

const res = await telegram.sendPhoto({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送Poll

POST telegram.sendPoll

POST https://api.telegram.org/bot{token}/sendPoll

成本等级 : cheap

上游区域

const res = await telegram.sendPoll({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送 RichMessage

POST telegram.sendRichMessage

POST https://api.telegram.org/bot{token}/sendRichMessage

成本等级 : cheap

上游区域

const res = await telegram.sendRichMessage({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送 RichMessage 草稿

POST telegram.sendRichMessageDraft

POST https://api.telegram.org/bot{token}/sendRichMessageDraft

成本等级 : cheap

上游区域

const res = await telegram.sendRichMessageDraft({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送Sticker

POST telegram.sendSticker

POST https://api.telegram.org/bot{token}/sendSticker

成本等级 : cheap

上游区域

const res = await telegram.sendSticker({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送窗口

POST telegram.sendVenue

POST https://api.telegram.org/bot{token}/sendVenue

成本等级 : cheap

上游区域

const res = await telegram.sendVenue({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送视频

POST telegram.sendVideo

POST https://api.telegram.org/bot{token}/sendVideo

成本等级 : cheap

上游区域

const res = await telegram.sendVideo({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送视频注释

POST telegram.sendVideoNote

POST https://api.telegram.org/bot{token}/sendVideoNote

成本等级 : cheap

上游区域

const res = await telegram.sendVideoNote({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

发送声音

POST telegram.sendVoice

POST https://api.telegram.org/bot{token}/sendVoice

成本等级 : cheap

上游区域

const res = await telegram.sendVoice({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

商业账户Bio

POST telegram.setBusinessAccountBio

POST https://api.telegram.org/bot{token}/setBusinessAccountBio

成本等级 : cheap

上游区域

const res = await telegram.setBusinessAccountBio({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

商业账户设置

POST telegram.setBusinessAccountGiftSettings

POST https://api.telegram.org/bot{token}/setBusinessAccountGiftSettings

成本等级 : cheap

上游区域

const res = await telegram.setBusinessAccountGiftSettings({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

设置商业账户Name

POST telegram.setBusinessAccountName

POST https://api.telegram.org/bot{token}/setBusinessAccountName

成本等级 : cheap

上游区域

const res = await telegram.setBusinessAccountName({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

设置商业账户ProfilePhoto

POST telegram.setBusinessAccountProfilePhoto

POST https://api.telegram.org/bot{token}/setBusinessAccountProfilePhoto

成本等级 : cheap

上游区域

const res = await telegram.setBusinessAccountProfilePhoto({ /* ... */ });

资料来源: packages/provider/telegram/src/telegram.ts

设置商业账户用户名

POST telegram.setBusinessAccountUsername

POST https://api.telegram.org/bot{token}/setBusinessAccountUsername

成本等级 : cheap

上游区域

const res = await telegram.setBusinessAccountUsername({ /* ... */ });

资料来源:[`包装/p

版本与发布记录

@apicity/telegram 共发布 81 个版本,首次发布于 2026/06/07;过去 12 个月发布了 81 个版本。

版本发布日期距今
0.26.0latest2026/11/051 天前
0.25.02026/11/033 天前
0.24.12026/11/024 天前
0.24.02026/11/014 天前
0.23.12026/11/015 天前
0.23.02026/11/015 天前

关于 @apicity/telegram 的常见问题

@apicity/telegram 是什么?

电报 提供Bot API,用于发送信息,媒体,民意调查,以及丰富的信息.

如何安装 @apicity/telegram?

在项目目录运行 npm install @apicity/telegram,或使用 pnpm add / yarn add / bun add。

@apicity/telegram 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@apicity/telegram 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@apicity/telegram 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@apicity/telegram 可以商用吗?

@apicity/telegram 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@apicity/telegram 的下载量有多少?

根据 npm 官方下载统计,@apicity/telegram 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,752 次,日均约 158 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@apicity/telegram 还在维护吗?

最新版本 0.26.0 发布于 2026/11/05(1 天前);至今共发布 81 个版本,其中过去 12 个月发布了 81 个;首次发布于 2026/06/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。