> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

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

> 调用 Telegram 列表、详情、评论与搜索接口时在 channel 中传入纯频道用户名、在 post_id 中传入整数消息 ID，并以 channel + post_id 作为唯一消息键。

Telegram 频道按纯用户名传，例如 `example`，不带 `@`，也不带链接前缀。一条消息由频道用户名加消息链接里的整数 `post_id` 定位：[https://t.me/example/123](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](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\`](https://t.me/example/123，消息详情请求体如下。`example`) 仅用于演示请求格式，请将 `example` 替换为目标永久链接中的频道用户名。

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

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

```json
{"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 另记一条。两条记录的数字相同时，用频道用户名区分两条消息。

[分页规则](/zh/faq/telegram-pagination) · [频道消息归档](/zh/guides/telegram-channel-archive)