跳到导航

Telegram 频道用户名、链接和消息 ID 应该怎么填?

Telegram 频道按纯用户名传,例如 example,不带 @,也不带链接前缀。一条消息由频道用户名加消息链接里的整数 post_id 定位:https://t.me/example/123 中 channel 是 example,post_id 是 123。只有 fetch_channel_info 还接受 @durov 或完整频道链接。

channel 接受什么?

频道资料动作 fetch_channel_info 接受 durov、@durov 和 https://t.me/durov,三种写法都会自动规范化。消息列表、消息详情、评论和搜索的 channel 都传不带 @、不带链接前缀、也不带消息路径的频道用户名。批量资料 telegram.web.batch_channel_info 的 channels 是一个逗号分隔字符串,一次最多 20 个用户名,不是 JSON 数组。

一条消息的 ID 是什么?

例如 https://t.me/example/123 中 channel 是 example,post_id 是整数 123。单条详情 telegram.web.fetch_post_detail 和评论 telegram.web.fetch_post_comments 都要求 channel 和 post_id。消息 ID 只在一个频道内唯一,所以保存和去重都用 channel + post_id;一个频道的 123 号消息和另一个频道的 123 号消息是两条不同的消息。

对示例链接 https://t.me/example/123,消息详情请求体如下。`example` 仅用于演示请求格式,请将 example 替换为目标永久链接中的频道用户名。

{"action":"telegram.web.fetch_post_detail","params":{"channel":"example","post_id":123}}

要读评论讨论,保留同一个 channel 和 post_id,改用评论动作。评论请求是另一笔计费调用,不是详情动作上的一个参数:

{"action":"telegram.web.fetch_post_comments","params":{"channel":"example","post_id":123,"limit":20}}

每条来源记录同时保存永久链接、频道用户名和整数消息 ID,并遵守以下规则:

  • 频道展示名不是用户名。
  • 转发消息上显示的链接不能证明原消息由哪个频道发布。
  • 私有邀请链接不是频道用户名,邀请链接里的数字不带来任何访问权限。
  • 某条消息缺失时,不要把消息 ID 加一去补。历史任务使用列表动作返回的游标,并单独设定请求上限。

查询一条消息时会同时取回评论吗?

不会。telegram.web.fetch_post_detail 不会调用评论动作。评论要单独调用 telegram.web.fetch_post_comments,limit 为 1–100,默认 50,没有 before 或 after 参数。不要把消息列表的游标传给评论动作,也不要把评论记录当作频道发布的消息。

例如活动频道转发了一条产品公告。资料表先记转发所在的频道和转发消息 ID。需要引用发布方时,打开转发指向的原消息,把原频道和原消息 ID 另记一条。两条记录的数字相同时,用频道用户名区分两条消息。

分页规则 · 频道消息归档