`, (中文(简体) ), `Actions → inline keyboard rows`, (中文(简体) ), `Select → inline keyboard rows`, (中文(简体) ), `Image → photo`, (中文(简体) ), `Table → monospace grid`, (中文(简体) ), `Divider → ──────`。 。 。 .
电讯API限制通过 `TELEGRAM_LIMITS` 援助者们
| 限制 | 数值 | 元素 |
| --- | --- | --- |
| `messageText` | 4096 (英语) | 每个信件的字符 |
| `caption` | 第1024号 | 标题字符 |
| `callbackData` | 64国道 | 每个召回数据字节 |
| `buttonsPerRow` | 第8条 | 按钮/ 内置键盘行 |
| `buttonsPerMessage` | 100个 | 全部内置键盘按钮 |
| `buttonText` | 64国道 | 按钮标签字符 |
| `photosPerMessage` | 10个 | 每个消息的照片 |
### 通过块化编辑流出
通过的答复流 `ChunkedEditStream`:适配器设置占位符 消息并编辑它作为符号到达,按住每秒一次编辑。 当a 答覆接近 Telegram 的 4 096- Char 限制( ~ 400 000 个字符) 流 透明地薄荷表示第二个信息并继续——保留每个电报 信件在限制范围内,没有已冻结块边界的回流.
### 互动(相对第一)
每张电报 `callback_query` (内线键盘按钮点击) 被锁定 快速通过 `answerCallbackQuery` - 适配器的 - 对 - the 适配器的 `ackDeadlineMs` 是 3 个sso 客户端旋转器迅速清除, 远远在Telegram ~ 30 s 的有效性之内 窗口 `answerCallbackQuery`敲门后, `decodeInteraction` 摘录 谈话的钥匙和不透明的标识 手掌 `InteractionEvent` 改为 发动机。 无关的点击可解码到bot无害地忽略的事件.
### 通过 ActionStore 的 HITL
使用 `thread.awaitChoice()` 发布交互式内置键盘 并屏蔽到点击解决为止;解析的数值是点击的按钮的 调用数据。 代理中断( E)`on_interrupt`) 被运行的渲染器捕获 并发送到您的 `onInterrupt` 处理器,它会张贴一个拾取器;单击 通过 `thread.resume(value)`。 。 。 .
### `/start` → `onThreadStarted`
监听者截取电报 `/start` 命令在私人聊天和 火灾 `onThreadStarted`,让机器人张贴问候或配置 第一回合前的谈话.
### 输入/退出文件
输入文件附件(相片、音频、视频、文档)可下载 并作为多式AG-UI内容部件通过 `buildFileContentParts`。适配器可以通过 `thread.postFile({ bytes, filename })` (作为 `document`) (中文(简体) ).
### 内建
- `defaultTelegramTools` - 船舶 `lookup_telegram_user` 这样经纪人就可以 解决公众问题 `@username` 处理到用于@-mentions的Telegram用户代号. 工具调用 `getChat` 仅供公众使用 `@username` 控件; 不支持任意显示名称查询 返回未定义。 展开到 `tools`。 。 。 .
- `defaultTelegramContext` 标记程序,Markdown-vs-HTML指导,以及 telegram DM / 论坛主题 / 组合用户对话模式。 展开到 `context`。 。 。 .
### 通过 `setMyCommands`
`registerCommands(specs)` 电话 `bot.api.setMyCommands`,登记 在Telegram UI中可见命令菜单。 听者把每个机器人都转过来 命令到引擎的 `onCommand` 管理者.
## 入侵模式
| 模式 | 如何运作 |
| --- | --- |
| `polling` | **默认.** 格莱姆Y长波林. 不需要公开的 URL . |
| `webhook` | grammY webhook + 最小节点HTTP服务器. 要求数 `webhook.domain`。 。 。 . |
| `auto` | 网络浏览时 `VERCEL`编号 :`AWS_LAMBDA_FUNCTION_NAME`编号 :`NETLIFY` 已经设定,否则投票. |
## 反应
`message_reaction` 自动启用更新。 适配器输出 `TELEGRAM_ALLOWED_UPDATES` (它所订阅的完整更新类型列表)和 把它传给奶奶的长波 `start()` 电话.
**分组聊天 :** 机器人必须是一个 **管理员** 待收款项 `message_reaction` 事件。 私人聊天和频道工作,没有任何 额外权限.
**Webhook 部署 :** 将同一列表传递给 `setWebhook`数字 :
```ts
import { TELEGRAM_ALLOWED_UPDATES } from "@copilotkit/channels-telegram";
await bot.api.setWebhook(url, {
allowed_updates: [...TELEGRAM_ALLOWED_UPDATES],
});
```
## V1里没有什么
- **模块/ 本地形式提交** - Telegram没有模式表面;多步骤 形式必须是对话驱动的. `openModal` 决定 `{ ok: false }` 打开 这个适配器——发动机把方法关了,因为 `supportsModals` 实值 `false`。 。 。 .
- **原生电文** - 电报没有每个用户可见的信息; `supportsEphemeral` 实值 `false`启用 `thread.postEphemeral(user, ui, { fallbackToDM: true })` 派一个私人的DM作为后盾. **重新编辑需要用户拥有 之前用机器人开始的DM** (直接同意至少一条); 如果他们没有的话,DM `sendMessage` 呼叫会失败 `postEphemeral` 决定 `{ ok: false }` 而不是扔东西.
- **原生溪流** ——Telegram没有服务器推出流线;流线是 大约通过节奏 `editMessageText` 打电话.
- **持久( Redis/ DB) 对话存储** —— 说 `TelegramConversationStore` 实值 in-memory; 重新启动时会话和信件历史丢失.
- **多机器人安装** ——每个适配器实例一个bot令牌.
- **`