创建 Telegram 会话（手机号 / 二维码 / 恢复）
查看 Telegram 用户号消息 API 的全部接口 →创建授权用户账号会话，并取得其他接口所需的 sessionId。手机号模式提交 mode=phone 与完整国际号码 phoneNumber，随后轮询状态并提交 Telegram 应用内登录码；启用两步验证的账号还需提交云密码。二维码模式提交 mode=qr，打开 qrPageUrl 或查看 qrImage，在 Telegram 设置 → 设备 → 连接桌面设备中扫码。恢复模式提交 mode=restore 与已有 sessionId。登录完成后保留返回的稳定 sessionId。可通过 proxy 指定 SOCKS5 连接地址。
API 功能
三种登录方式 支持手机号验证码、二维码与已有会话恢复
两步验证提示 根据 twoFactorRequired 继续提交云密码
可复用会话标识 登录后保存 sessionId，后续接口使用同一标识
可选连接代理 通过 proxy 参数配置该会话的 SOCKS5 地址
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
POST
/api/project/telegram-messaging/create-session API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/telegram-messaging/create-session?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"{\"mode\":\"qr\",\"deviceName\":\"My Bot\"}"}'
curl -X POST 'https://api.opendata-api.com/api/project/telegram-messaging/create-session?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"{\"mode\":\"qr\",\"deviceName\":\"My Bot\"}"}' 查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 连接已授权的 Telegram 用户账号
- 为客服系统提供扫码登录流程
- 使用已保存的会话标识恢复账号连接