Skip to content

Telegram 触发节点#

¥Telegram Trigger node

Telegram 是一个基于云的即时通讯和 VoIP 服务。用户可以发送消息并交换照片、视频、贴纸、音频以及任何类型的文件。在此页面，你可以找到 Telegram 触发器节点可以响应的事件列表以及更多资源的链接。

¥Telegram is a cloud-based instant messaging and voice over IP service. Users can send messages and exchange photos, videos, stickers, audio, and files of any type. On this page, you'll find a list of events the Telegram Trigger node can respond to and links to more resources.

Credentials

你可以在 此处 中找到此节点的身份验证信息。

¥You can find authentication information for this node here.

Examples and templates

有关使用示例和模板以帮助你入门，请参阅 n8n 的 Telegram 触发器集成 页面。

¥For usage examples and templates to help you get started, refer to n8n's Telegram Trigger integrations page.

事件#

¥Events

  • *：除 "聊天成员"、"消息反应" 和 "消息反应计数" 之外的所有更新（由于 Telegram API 的默认行为，这些更新会产生大量调用）。

¥*: All updates except "Chat Member", "Message Reaction", and "Message Reaction Count" (default behavior of Telegram API as they produces a lot of calls of updates).

  • 业务连接：当机器人连接到企业账户或断开连接，或者用户编辑了与机器人的现有连接时触发。

¥Business Connection: Trigger when the bot is connected to or disconnected from a business account, or a user edited an existing connection with the bot.

  • 业务消息：收到来自已连接企业账户的新消息时触发。

¥Business Message: Trigger on a new message from a connected business account.

  • 回调查询：当收到新的回调查询时触发。

¥Callback Query: Trigger on new incoming callback query.

  • 通道帖子：当收到任何类型的通道帖子（包括文本、图片、贴纸等）时触发。

¥Channel Post: Trigger on new incoming channel post of any kind — including text, photo, sticker, and so on.

  • 聊天加成：聊天推广被添加或更改时触发。机器人必须是聊天管理员才能接收这些更新。

¥Chat Boost: Trigger when a chat boost is added or changed. The bot must be an administrator in the chat to receive these updates.

  • 聊天加入请求：发送加入聊天的请求时触发。机器人必须拥有聊天中的 can_invite_users 管理员权限才能接收这些更新。

¥Chat Join Request: Trigger when a request to join the chat is sent. The bot must have the can_invite_users administrator right in the chat to receive these updates.

  • 聊天成员：聊天成员状态更新时触发。机器人必须是聊天管理员。

¥Chat Member: Trigger when a chat member's status is updated. The bot must be an administrator in the chat.

  • 选择的内联结果：当发送用户选择的内联查询结果时触发。请参阅 Telegram 的 API 文档（反馈收集 版本），了解如何为你的机器人启用这些更新。

¥Chosen Inline Result: Trigger when the result of an inline query chosen by a user is sent. Please see Telegram's API documentation on feedback collection for details on how to enable these updates for your bot.

  • 已删除的业务消息：已连接商家账号中的消息被删除时触发。

¥Deleted Business Messages: Trigger when messages are deleted from a connected business account.

  • 已编辑的商业消息：已连接商家账号发送的消息更新时触发。

¥Edited Business Message: Trigger on new version of a message from a connected business account.

  • 已编辑的通道帖子：机器人已知的通道帖子被编辑成新版本时触发。

¥Edited Channel Post: Trigger on new version of a channel post that is known to the bot is edited.

  • 已编辑的消息：机器人已知的通道帖子被编辑成新版本时触发。

¥Edited Message: Trigger on new version of a channel post that is known to the bot is edited.

  • 内联查询：当收到新的内联查询时触发。

¥Inline Query: Trigger on new incoming inline query.

  • 消息：当收到任何类型的消息（包括文本、图片、贴纸等）时触发。

¥Message: Trigger on new incoming message of any kind — text, photo, sticker, and so on.

  • 消息已接收用户更改对消息的反应时触发。机器人必须是聊天管理员。机器人设置的响应不会收到更新。

¥Message Reaction: Trigger when a reaction to a message is changed by a user. The bot must be an administrator in the chat. The update isn't received for reactions set by bots.

  • 消息反应计数：当匿名消息的回复发生变化时触发。机器人必须是聊天管理员。更新会分组，并且可能会延迟几分钟发送。

¥Message Reaction Count: Trigger when reactions to a message with anonymous reactions are changed. The bot must be an administrator in the chat. The updates are grouped and can be sent with delay up to a few minutes.

  • 我的聊天成员：当聊天中机器人的聊天成员状态更新时触发。对于私密聊天，仅当用户屏蔽或解除屏蔽机器人时才会收到此更新。

¥My Chat Member: Trigger when the bot's chat member status is updated in a chat. For private chats, this update is received only when the bot is blocked or unblocked by the user.

  • 池投票状态更新时触发。机器人仅接收已停止投票和由机器人发送的投票的更新。

¥Poll: Trigger on new poll state. Bots only receive updates about stopped polls and polls which are sent by the bot.

  • 投票答案：当用户在非匿名投票中更改答案时触发。机器人只能接收由其自身发送的投票中的新投票。

¥Poll Answer: Trigger when user changes their answer in a non-anonymous poll. Bots only receive new votes in polls that were sent by the bot itself.

  • 预检查询：收到新的预结账查询时触发。包含完整的结账信息。

¥Pre-Checkout Query: Trigger on new incoming pre-checkout query. Contains full information about checkout.

  • 已购买付费媒体：用户通过机器人发送的非空有效负载购买付费媒体时触发。

¥Purchased Paid Media: Trigger when a user purchases paid media with a non-empty payload sent by the bot in a non-channel chat.

  • 移除聊天推广：聊天中移除推广时触发。机器人必须是聊天管理员才能接收这些更新。

¥Removed Chat Boost: Trigger when a boost is removed from a chat. The bot must be an administrator in the chat to receive these updates.

  • 发货查询：收到新的发货查询时触发。仅适用于价格灵活的发票。

¥Shipping Query: Trigger on new incoming shipping query. Only for invoices with flexible price.

某些事件可能需要额外的权限，请参阅 Telegram API 文档 了解更多信息。

¥Some events may require additional permissions, see Telegram's API documentation for more information.

选项#

¥Options

  • 下载图片/文件：是否下载附件中的图片或文件以包含在输出数据中。

¥Download Images/Files: Whether to download attached images or files to include in the output data.

  • 图片大小：启用“下载图片/文件”功能后，你可以配置要下载的图片大小。默认下载大型镜像。

    ¥Image Size: When you enable Download Images/Files, this configures the size of image to download. Downloads large images by default.

  • 仅限聊天 ID：仅触发具有所列聊天 ID 的事件。你可以包含多个以逗号分隔的聊天 ID。

¥Restrict to Chat IDs: Only trigger for events with the listed chat IDs. You can include multiple chat IDs separated by commas.

  • 仅限用户 ID：仅触发具有所列用户 ID 的事件。你可以包含多个以逗号分隔的用户 ID。

¥Restrict to User IDs: Only trigger for events with the listed user IDs. You can include multiple user IDs separated by commas.

相关资源#

¥Related resources

n8n 提供 Telegram 的应用节点。你可以找到节点文档 此处。

¥n8n provides an app node for Telegram. You can find the node docs here.

在 n8n 网站上查看 示例工作流及相关内容。

¥View example workflows and related content on n8n's website.

有关其 API 的详细信息，请联系 Telegram API 文档。

¥Refer to Telegram's API documentation for details about their API.

常见问题#

¥Common issues

有关常见问题或建议的解决方案，请参阅 常见问题。

¥For common questions or issues and suggested solutions, refer to Common issues.