🪄 第 1 步 — 管理员配置插件（只需做一次）
这个步骤由站点管理员完成：
登录 Paymenter 管理后台
进入 扩展 → Paymenter‑For‑Telegram
填写以下信息：
Telegram Bot Token
在 Telegram 机器人 BotFather 里创建的机器人的 TOKEN（格式类似 123456789:ABC‑DEF…）
Webhook Secret
一个随机字符串，用于安全地接收 Telegram 推送通知
Bot Username（可选）
用于生成一键绑定按钮（例如 my_bot，不带 @）
Default Group/Channel Chat ID（可选）
如果你希望通知推送到群组/频道，则填群/频道的 Chat ID
点击 保存设置
记住管理员界面会显示一个 Webhook URL（例如 https://你的域名/telegram/webhook/xxxxx）
📌 只有配置成功后，前台用户才能绑定和接收通知
第 2 步 — 让插件能接收到 Telegram 消息（管理员）
Telegram 需要知道你的服务器在哪里，以便推送消息到你的网站：
Telegram 的 webhook 只能通过 POST 推送更新，所以必须设置正确的 webhook。
执行下面命令（只需管理员做一次）：
curl curl https://api.telegram.org/bot<你的BOT_TOKEN>/setWebhook?url=https://你的域名/telegram/webhook/<Webhook Secret>
你也可以用浏览器访问 Telegram API 做同样的设置
例如：
https://api.telegram.org/bot<你的BOT_TOKEN>/setWebhook?url=https://你的域名/telegram/webhook/<Webhook Secret>
⚠️ 注意：这个 URL 必须是 HTTPS / 有有效证书，Telegram 才会发送消息到你的服务器。
🔑 第 3 步 — 用户如何绑定 Telegram（前台）
用户登录 Paymenter 后：
进入个人 Dashboard
左侧菜单点击 Telegram
点击 生成绑定按钮
弹出窗口里出现一个按钮：打开 Telegram 并绑定
点击按钮，会在新标签页打开 Telegram 机器人对话
在 Telegram 里点击 Start / 开始 或者让机器人发送消息 /start <token>
这个 token 是你在步骤 3 生成的唯一绑定标识
绑定完成后：
✅ 页面会显示 “已绑定”
✅ 后端会记录该用户的 Telegram Chat ID
✅ 之后你就能收到通知了
🔔 第 4 步 — 选择你要接收哪些通知
在 Telegram 页面里你也可以设置“通知偏好”（只对私聊有效）：
勾选你想要的，点击保存设置即可
需要管理员先在 Telegram 设置 Webhook：
https://你的域名/telegram/webhook/<Webhook Secret>
说明
绑定依赖 Telegram Webhook：你的站点必须能被 Telegram 访问到（HTTPS + 公网）。
Webhook Secret / Bot Token 在「后台 → Extensions → Paymenter-For-Telegram」里配置。
群/频道通知可在扩展设置里填写 Default Chat ID（支持 -100... 或 @channelusername）。
相关通知模板
🎫 工单有新回复
工单ID: {ticket_id}
内容: {message}
✅ 服务已开通
服务ID: {service_id}
产品: {product_name}
⛔ 服务已暂停
服务ID: {service_id}
产品: {product_name}
♻️ 服务已恢复
服务ID: {service_id}
产品: {product_name}
🗑️ 服务已删除
服务ID: {service_id}
产品: {product_name}
➕ 库存新增
产品: {product_name}
新增数量: {added_count}
当前库存: {current_stock}
🛒 库存售出
产品: {product_name}
剩余库存: {current_stock}
⚠️ 库存不足警告
产品: {product_name}
当前库存: {current_stock}
请及时补充！