使用 PHP 与 monday.com API 交互：自动化创建线索与交易

<?php
// monday.com API 令牌
$token = '[YOUR_MONDAY_API_KEY]'; // 请替换为您的实际 API 令牌

// monday.com GraphQL API 端点
$apiUrl = 'https://api.monday.com/v2';

// HTTP 请求头，包含内容类型和授权信息
$headers = [
    'Content-Type: application/json',
    'Authorization: ' . $token
];

// 存储您的看板 ID，可以根据需要添加更多
$boards = [
    "testBoard"  => 1234567890, // 替换为您的实际看板 ID
    "boardName1" => 1918282734,
    "boardName2" => 1987654321,
    // ...更多看板
];

// 假设您可能还需要组 ID，尽管本教程主要关注看板中的项目创建
// "testGroup"  => 6376637288 // 示例组 ID
?>

query {
  boards(ids: [YOUR_BOARD_ID]) {
    columns {
      id
      title
      type
    }
  }
}

<?php
include('config.php'); // 包含配置信息

if ($_SERVER["REQUEST_METHOD"] == "POST") {
    // 1. 从表单获取输入值
    $companyName    = $_POST['companyName'] ?? '';
    $firstName      = $_POST['firstName'] ?? '';
    $lastName       = $_POST['lastName'] ?? '';
    $contactEmail   = $_POST['contactEmail'] ?? '';
    $contactPhone   = $_POST['contactPhone'] ?? '';
    $projectState   = $_POST['projectState'] ?? '';
    $contactWebSite = $_POST['contactWebSite'] ?? ''; // 尽管链接列在原始问题中未成功，我们仍可以尝试传递
    $projectMessage = $_POST['projectMessage'] ?? '';

    // 2. 选择目标看板 ID
    // 假设我们想将线索添加到 config.php 中定义的 'testBoard'
    $boardId = $boards['testBoard'];

    // 3. 获取当前日期，用于日期列
    $todaysDate = date("Y-m-d");

    // 4. 构建 column_values JSON 字符串
    // 请确保这里的键（如 'status', 'date4', 'text__1' 等）与您 monday.com 看板中的实际列 ID 匹配
    $columnValsArray = [
        'status'        => [
            'label' => 'New Lead' // 设置状态为“新线索”
        ],
        'date4' => [ // 假设这是您的日期列 ID
            'date' => $todaysDate
        ],
        'text__1' => $firstName, // 假设这是您的名字文本列 ID
        'text5__1' => $lastName, // 假设这是您的姓氏文本列 ID
        'email__1' => [ // 假设这是您的邮箱列 ID
            'email' => $contactEmail,
            'text' => $contactEmail
        ],
        'phone__1' => [ // 假设这是您的电话列 ID
            'phone' => $contactPhone,
            'countryShortName' => 'US' // 根据需要调整国家代码
        ],
        'text7__1' => $projectState, // 假设这是您的项目状态文本列 ID
        'long_text4__1' => $projectMessage // 假设这是您的长文本消息列 ID
        // 'link__1' => [ // 链接列在原始问题中未成功，但结构通常如下
        //     'url' => $contactWebSite,
        //     'text' => $contactWebSite
        // ]
    ];

    // 将 PHP 数组编码为 JSON 字符串，作为 column_values 参数
    $columnValsJson = json_encode($columnValsArray);

    // 5. 构建 GraphQL 突变查询
    // 注意：这里的 $itemName 和 $columnVals 是 GraphQL 变量，不是 PHP 变量
    $query = 'mutation ($itemName: String!, $columnVals: JSON!) {
        create_item (
            board_id:' . $boardId . ',
            item_name:$itemName,
            column_values:$columnVals
        ) {
            id
            name
            column_values {
                id
                value
                text
            }
        }
    }';

    // 6. 定义 GraphQL 变量
    $vars = [
        'itemName'   => $companyName, // 新项目的名称
        'columnVals' => $columnValsJson // 包含所有列值的 JSON 字符串
    ];

    // 7. 准备 HTTP 请求内容
    $requestContent = json_encode([
        'query'     => $query,
        'variables' => $vars
    ]);

    // 8. 使用 stream_context_create 和 file_get_contents 发送 POST 请求
    $context = stream_context_create([
        'http' => [
            'method'  => 'POST',
            'header'  => $headers, // 从 config.php 获取的请求头
            'content' => $requestContent,
            'ignore_errors' => true // 允许获取错误响应体
        ]
    ]);

    $data = @file_get_contents($apiUrl, false, $context);

    // 9. 处理 API 响应
    $responseContent = json_decode($data, true);

    // 输出响应，用于调试或进一步处理
    header('Content-Type: application/json');
    echo json_encode($responseContent, JSON_PRETTY_PRINT);

} else {
    // 如果不是 POST 请求，可以显示一个简单的表单或者错误信息
    echo "请通过 POST 请求提交数据。";
    // 示例 HTML 表单 (仅用于测试目的)
    /*
    echo '<form method="POST">
        <input type="text" name="companyName" placeholder="公司名称" required><br>
        <input type="text" name="firstName" placeholder="名"><br>
        <input type="text" name="lastName" placeholder="姓"><br>
        <email type="email" name="contactEmail" placeholder="邮箱"><br>
        <input type="tel" name="contactPhone" placeholder="电话"><br>
        <input type="text" name="projectState" placeholder="项目状态"><br>
        <input type="url" name="contactWebSite" placeholder="公司网址"><br>
        <textarea name="projectMessage" placeholder="项目消息"></textarea><br>
        <button type="submit">创建线索</button>
    </form>';
    */
}
?>