Telegram API 接入实战：用 gramjs 搭建你的第一个 Telegram 客户端

做 Telegram 相关开发（机器人、社群管理、数据运营），绕不开 Telegram 的 MTProto API。相比 Bot API 只能做机器人，MTProto 能拿到更完整的能力——读取消息、管理会话、批量操作。本文用 gramjs（Telegram MTProto 的 JS 实现）带你从零跑通。

一、为什么选 gramjs

• 基于 MTProto，能力比 Bot API 更全
• Node.js / 浏览器都能跑
• 社区活跃，文档相对齐全

二、准备工作

1. 到 https://my.telegram.org 登录，进入「API development tools」，拿到 api_id 和 api_hash
2. 安装依赖：npm install telegram

三、最小可运行示例

const { TelegramClient } = require('telegram');
const { StringSession } = require('telegram/sessions');

const apiId = YOUR_API_ID;
const apiHash = 'YOUR_API_HASH';
const session = new StringSession('');

(async () => {
  const client = new TelegramClient(session, apiId, apiHash, { connectionRetries: 5 });
  await client.start({
    phoneNumber: async () => '你的手机号',
    password: async () => '你的密码',
    phoneCode: async () => '收到的验证码',
    onError: (err) => console.log(err),
  });
  console.log('已登录，session:', client.session.save());
  const me = await client.getMe();
  console.log('当前账号:', me.username);
})();

四、常用能力

• client.getDialogs() 获取会话列表
• client.sendMessage() 发送消息
• client.getMessages() 读取历史消息
• 监听 newMessage 事件实现自动回复 / 线索捕获

五、从脚本到产品

脚本跑通后，真正落地成团队协作工具还要解决：多账号管理、登录态持久化、权限分配、数据看板……这些恰恰是 TGDesk（Telegram CRM）在做的事——把 gramjs 级别的底层能力封装成开箱即用的群管 / 客户管理界面，不用自己造轮子。

如果你也在用 gramjs 做 Telegram 开发，欢迎在评论区交流踩坑。