使用 PHP 连接 Monday.com API：自动化潜在客户与交易创建教程

<?php
// config.php

// 您的 Monday.com API 密钥
// 请替换为您的实际 API 密钥
$token = '[YOUR API KEY]'; 

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

// HTTP 请求头，指定内容类型为 JSON 并包含授权令牌
$headers = ['Content-Type: application/json', 'Authorization: ' . $token];

// 定义您的看板 ID，可以根据需要添加多个
$boards = array(
    "boardName1" => 1918282734, // 示例看板1 ID
    "boardName2" => 1987654321, // 示例看板2 ID
    "testBoard"  => 6376637288  // 您的测试看板 ID
);

// 如果您需要指定某个组（Group）ID，可以在这里定义
// "testGroup"  => 6376637288 
?>

<?php
// create_lead.php
include('config.php'); // 引入配置信息

if ($_SERVER["REQUEST_METHOD"] == "POST") {
    // 1. 从表单获取输入值
    $companyName    = $_POST['companyName'] ?? 'Unnamed Company'; // 公司名称
    $firstName      = $_POST['firstName'] ?? '';                 // 姓氏
    $lastName       = $_POST['lastName'] ?? '';                  // 名字
    $contactEmail   = $_POST['contactEmail'] ?? '';              // 联系邮箱
    $contactPhone   = $_POST['contactPhone'] ?? '';              // 联系电话
    $projectState   = $_POST['projectState'] ?? '';              // 项目状态/地区
    $contactWebSite = $_POST['contactWebSite'] ?? '';            // 网站 (注意：URL列可能需要特殊处理)
    $projectMessage = $_POST['projectMessage'] ?? '';            // 项目信息/留言

    // 从配置中获取目标看板 ID
    // 假设我们要将数据发送到 'testBoard'
    $boardId = $boards['testBoard']; 

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

    // 2. 构建 GraphQL 变异查询
    // 注意：`create_item` 变异的 `board_id` 参数直接在查询字符串中，
    // 而 `itemName` 和 `columnVals` 通过变量传递。
    $query = 'mutation ($itemName: String!, $columnVals: JSON!) { 
                create_item (board_id: ' . $boardId . ', item_name:$itemName, column_values:$columnVals) { 
                    id 
                    name
                } 
            }';

    // 3. 构造 GraphQL 变量
    // `columnVals` 是一个 JSON 字符串，包含所有列的值。
    // 请务必将以下列 ID 替换为您的 Monday.com 看板中实际的列 ID。
    // 例如：'status' -> 'status_1', 'date4' -> 'date_column', 'text__1' -> 'text_column' 等。
    $vars = [
        'itemName'        => $companyName, // 新项的名称，通常是公司名或主要联系人
        'columnVals'      => json_encode([
            // 状态列：需要一个包含 'label' 的数组
            'status'        => [ 
                'label' => 'New Lead' // 例如：'New Lead', 'Contacted' 等
            ], 
            // 日期列：需要一个包含 'date' 的数组，格式为 YYYY-MM-DD
            'date4' => [ // 假设您的日期列 ID 是 'date4'
                'date' => $todaysDate
            ],
            // 文本列：直接传递字符串
            'text__1' => $firstName,    // 假设您的名字列 ID 是 'text__1'
            'text5__1' => $lastName,    // 假设您的姓氏列 ID 是 'text5__1'
            // 邮箱列：需要一个包含 'email' 和 'text' 的数组
            'email__1' => [ // 假设您的邮箱列 ID 是 'email__1'
                'email' => $contactEmail,
                'text' => $contactEmail // 邮箱列的显示文本
            ],
            // 电话列：需要一个包含 'phone' 和 'countryShortName' 的数组
            'phone__1' => [ // 假设您的电话列 ID 是 'phone__1'
                'phone' => $contactPhone,
                'countryShortName' => 'US' // 国家简称，例如 'US', 'CN'
            ],
            // 文本列
            'text7__1' => $projectState, // 假设您的项目状态列 ID 是 'text7__1'
            // 长文本列
            'long_text4__1' => $projectMessage // 假设您的长文本列 ID 是 'long_text4__1'
            // 'link_column' => ['url' => $contactWebSite, 'text' => $contactWebSite] // URL 列可能需要特殊处理，原问题中提到此项未成功。
        ])
    ];

    // 4. 发送 API 请求
    // 使用 file_get_contents 结合 stream_context_create 发送 POST 请求
    $data = @file_get_contents($apiUrl, false, stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => $headers, // 包含授权和内容类型
            'content' => json_encode([
                'query' => $query,
                'variables' => $vars
            ]),
            'ignore_errors' => true // 即使 HTTP 状态码表示错误也读取响应
        ]
    ]));

    // 5. 处理 API 响应
    $responseContent = json_decode($data, true);
    echo json_encode($responseContent, JSON_PRETTY_PRINT); // 以美观的格式输出响应
  } else {
    // 如果不是 POST 请求，可以显示一个简单的表单或错误信息
    echo "请通过 POST 请求提交数据。";
    // 示例 HTML 表单（用于测试）
    echo '
    <form method="POST">
        <label>公司名称: <input type="text" name="companyName" value="测试公司"></label><br>
        <label>名字: <input type="text" name="firstName" value="张"></label><br>
        <label>姓氏: <input type="text" name="lastName" value="三"></label><br>
        <label>邮箱: <input type="email" name="contactEmail" value="zhangsan@example.com"></label><br>
        <label>电话: <input type="text" name="contactPhone" value="1234567890"></label><br>
        <label>项目状态: <input type="text" name="projectState" value="New York"></label><br>
        <label>网站: <input type="url" name="contactWebSite" value="https://example.com"></label><br>
        <label>留言: <textarea name="projectMessage">这是一个测试留言。</textarea></label><br>
        <button type="submit">创建潜在客户</button>
    </form>
    ';
  }
?>

<?php
// 示例 cURL 请求（替代 file_get_contents 部分）
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['query' => $query, 'variables' => $vars]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); // $headers 数组需要调整为 ['Content-Type: application/json', 'Authorization: Bearer ' . $token]

$data = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 继续处理 $data
?>

{
    "data": {
        "create_item": {
            "id": "1234567890",
            "name": "测试公司"
        }
    },
    "account_id": 987654321
}