使用 PHP cURL 连接 Monday.com API 创建潜在客户或交易

<?php
  // Monday.com API 访问令牌
  // 请替换为您的实际 API 密钥
  $token = '[YOUR API KEY]'; 

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

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

  // 常用的看板 ID 映射，方便通过名称引用
  $boards = array(
    "boardName1" => 1918282734,
    "boardName2" => 1987654321,
    "boardName3" => 4567123890,
    "testBoard"  => 6376637288 // 示例测试看板 ID
  );
?>

mutation ($itemName: String!, $columnVals: JSON!) {
  create_item (board_id: [YOUR_BOARD_ID], item_name: $itemName, column_values: $columnVals) {
    id
  }
}

<?php
// 引入配置文件，获取 API 密钥、端点和请求头
include('config.php');

// 确保请求方法为 POST
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'] ?? '';

    // 从 config.php 获取目标看板 ID
    // 假设 'testBoard' 是我们想要创建项的看板
    $boardId = $boards['testBoard']; 

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

    // 2. 构建 GraphQL 突变查询字符串
    // board_id 直接拼接，itemName 和 columnVals 作为变量传递
    $query = 'mutation ($itemName: String!, $columnVals: JSON!) { 
                create_item (board_id:'. $boardId . ', item_name:$itemName, column_values:$columnVals) { 
                  id 
                } 
              }';

    // 3. 准备 GraphQL 变量
    // columnVals 需要是一个 JSON 字符串，其中包含列的 ID 和对应的值
    $vars = [
        'itemName'        => $companyName, // 项的名称，通常是公司名或主要联系人
        'columnVals'      => json_encode([
            // 状态列 (Status Column)
            // 'label' 对应 Monday.com 状态列的标签文本
            'status'        => [
                'label' => 'New Lead' 
             ], 
            // 日期列 (Date Column)
            // 'date4' 是日期列的 ID，'date' 字段是日期值
            'date4' => [
                'date' => $todaysDate
            ],
            // 文本列 (Text Column)
            // 'text__1' 是文本列的 ID
            'text__1' => $firstName, // 名
            'text5__1' => $lastName, // 姓
            // 电子邮件列 (Email Column)
            // 'email__1' 是电子邮件列的 ID，需要 'email' 和 'text' 字段
            'email__1' => [
                'email' => $contactEmail,
                'text' => $contactEmail // 'text' 字段通常与 'email' 相同
            ],
            // 电话列 (Phone Column)
            // 'phone__1' 是电话列的 ID，需要 'phone' 和 'countryShortName' 字段
            'phone__1' => [
                'phone' => $contactPhone,
                'countryShortName' => 'US' // 国家简称，例如 'US', 'CN'
            ],
            // 另一个文本列
            'text7__1' => $projectState, // 项目状态或地区
            // 长文本列 (Long Text Column)
            // 'long_text4__1' 是长文本列的 ID
            'long_text4__1' => $projectMessage // 项目消息或备注
            // 注意：链接列（URL Column）的处理可能更复杂，示例中未完全实现
            // 'link_column_id' => ['url' => $contactWebSite, 'text' => $contactWebSite] 
            // 如果上述链接列不工作，请查阅 Monday.com 最新 API 文档
        ])
    ];

    // 4. 发送 POST 请求到 Monday.com API
    // 使用 file_get_contents 结合 stream_context_create 模拟 POST 请求
    $data = @file_get_contents($apiUrl, false, stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => $headers, // 从 config.php 获取的请求头
            'content' => json_encode([
                'query' => $query,
                'variables' => $vars
            ]),
            'ignore_errors' => true // 忽略 HTTP 错误，以便始终读取响应体
        ]
    ]));

    // 5. 解析 API 响应并输出
    $responseContent = json_decode($data, true);
    echo json_encode($responseContent);
  } else {
    // 如果不是 POST 请求，可以返回错误或显示一个表单
    echo json_encode(['error' => '请通过 POST 方法提交数据。']);
  }
?>