开发者文档

欢迎来到 AG-SaaS TGBot 开发者中心。本平台旨在提供最灵活、最高效的 Telegram 机器人扩展方案。无论您是想实现简单的关键词回复，还是复杂的自动化业务逻辑，都能在这里找到答案。

插件基础结构

所有的自定义插件都存放于 /plugins 目录下。每个插件是一个独立的 .php 文件。系统会自动扫描并解析头部的元数据注释。

<?php
/**
 * Plugin Name: 智能欢迎助手
 * Description: 自动为新加入群组的用户发送欢迎语。
 * Category: 社交增强
 */

// 插件逻辑在此编写...

常用 Hooks 接口

插件系统提供了丰富的上下文钩子。您可以直接通过变量访问当前消息的详情：

• $bot: 当前处理消息的机器人模型实例。
• $update: Telegram 官方 SDK 的 Update 对象。
• $message: 简化的消息内容对象。
• $chatId: 当前聊天的 ID。

示例：回复特定指令

if ($message->getText() === '/ping') {
    $telegram->sendMessage([
        'chat_id' => $chatId,
        'text' => 'Pong! 🏓'
    ]);
}

Webhook 扩展

您可以为任何机器人配置外部 Webhook。AG-SaaS 会作为代理层，在验证安全性后将处理后的结构化数据转发至您的目标 URL。

转发数据格式 (JSON)

{
    "bot_id": 1,
    "bot_name": "MyBot",
    "chat_id": "123456",
    "user_id": "7890",
    "text": "Hello World",
    "raw_update": { ... }
}