钉钉机器人基础框架

BOT_API/
├── index.php              # 主入口文件
├── inc/
│   ├── config.php         # 配置文件
│   └── function.php       # 函数库
├── plugins/               # 插件目录
│   ├── Hello World.php    # 示例插件
│   ├── GroupSign.php      # 群签到插件
│   ├── Weather_List.php   # 天气查询插件
│   ├── Hitokoto.php       # 一言插件
│   ├── Time.php           # 时间插件
│   └── Rand.php           # 随机数插件
├── Data/                  # 数据目录（自动创建）
│   ├── Log/               # 日志目录
│   │   ├── Chat/          # 聊天日志
│   │   └── Other/         # 其他日志
│   ├── Cron/              # 定时任务日志
│   └── num.txt            # 消息统计
├── themes/                # 主题目录
└── docs/                  # 文档目录

// 是否使用新版钉钉机器人（使用 sessionWebhook）
$Use_SessionWebhook = 'true';

// 钉钉机器人签名验证配置（重要安全功能）
$Enable_Sign_Verification = 'true';  // 生产环境强烈建议开启
$BOT_AppSecret = '你的机器人AppSecret';  // 从钉钉开发者后台获取

// 其他配置
$BOT_Sleep = 'false';
$API_Server = '你的API地址';
$API_Token = '你的API_Token';
$Cron_Token_Required = 'false';

// 使用传统配置模式
$Use_SessionWebhook = 'false';

// 钉钉机器人的Webhook地址
$BOT_Server = 'https://oapi.dingtalk.com/robot/send';

// 钉钉机器人的Access_Token
$BOT_Token = '你的access_token';

// 钉钉机器人的关键词
$BOT_Keyword = '你的关键词';

// 签名验证配置（可选但推荐）
$Enable_Sign_Verification = 'true';
$BOT_AppSecret = '你的机器人AppSecret';

// 其他配置
$BOT_Sleep = 'false';
$API_Server = '你的API地址';
$API_Token = '你的API_Token';
$Cron_Token_Required = 'false';

// 开启签名验证
$Enable_Sign_Verification = 'true';

// 设置机器人的AppSecret（从钉钉开发者后台获取）
$BOT_AppSecret = '你的机器人AppSecret';

# 每分钟执行一次
* * * * * curl "http://你的域名/?trigger_tasks=true"

# 每分钟执行一次
* * * * * curl "http://你的域名/?trigger_tasks=true&token=你的API_Token"

https://你的域名/

<?php
/*
* @Plugin Name：示例插件
* @Author：你的名字
* @Version：1.0.0
* @Modified for：钉钉机器人
*/

// 检查消息内容
if(isset($Data['text']['content'])) {
    $message = $Data['text']['content'];
    
    // 匹配关键词
    if(strpos($message, '你好') !== false) {
        // 使用新的发送函数（推荐）
        send_text('你好！我是机器人');
        
        // 或者发送Markdown消息
        send_markdown('问候', '**你好！** 我是机器人\n\n欢迎使用！');
    }
    
    // 处理其他命令
    if(strpos($message, '帮助') !== false) {
        $helpText = "# 机器人帮助\n\n";
        $helpText .= "- 发送「你好」获取问候\n";
        $helpText .= "- 发送「帮助」查看此信息\n";
        
        send_markdown('帮助信息', $helpText);
    }
}
?>

<?php
// 旧版插件写法仍然支持
if(isset($Data['text']['content'])) {
    $message = $Data['text']['content'];
    
    if(strpos($message, '你好') !== false) {
        // 旧版写法（仍然可用）
        http_post_json('text', '你好！我是机器人');
    }
}
?>

[2024-01-20 14:30:25] 用户昵称(用户ID): 消息内容

[2024-01-20 14:30:25] {"msgtype":"text","text":{"content":"消息内容"},...}

$BOT_Sleep = 'true';  // 开启延时