如何使用PHP curl对接monday.com接口创建线索或商机？

前置准备 #

• 先获取要写入的线索/商机所属工作板（board）ID，你可以先用你提供的示例代码调用获取board列表，找到对应业务板块的ID
• 获取该工作板下需要填充的自定义字段的列ID（column id），你可以执行以下查询获取指定board的所有字段结构：

query {
  boards(ids: "你的boardID") {
    columns {
      id
      title
      type
    }
  }
}

返回结果里就能对应上每个字段的显示名和实际传参用的ID。

完整cURL实现代码 #

替换对应参数即可直接使用：

<?php
// 配置参数
$token = '替换为你自己的有效API Token';
$apiUrl = 'https://api.monday.com/v2';
$targetBoardId = '替换为你的线索/商机工作板ID';
// 要创建的线索信息，键对应你拿到的列ID，值对应要写入的内容
$leadData = [
    // 示例：name是工作板内置的条目名称字段
    'name' => '张三-XX公司线索',
    // 示例：下面是自定义列的ID和值，换成你自己的列ID
    'text8' => '张三', // 联系人姓名字段
    'text9' => 'XX科技有限公司', // 公司名称字段
    'phone' => '138XXXXXXX', // 联系电话字段
    'email' => 'zhangsan@example.com', // 邮箱字段
    'numeric0' => '100000' // 意向金额字段
];

// 构造GraphQL Mutation（创建条目用的查询语句）
$columnValues = json_encode($leadData, JSON_UNESCAPED_UNICODE);
$query = <<<GRAPHQL
mutation {
  create_item (
    board_id: {$targetBoardId},
    item_name: "{$leadData['name']}",
    column_values: '{$columnValues}'
  ) {
    id
    name
  }
}
GRAPHQL;

// 初始化cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: ' . $token
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['query' => $query]));
// 本地调试可临时开启忽略SSL验证，生产环境建议删除以下两行
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

// 执行请求并处理响应
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$responseData = json_decode($response, true);
// 打印返回结果，创建成功会返回新生成的item id
var_dump($responseData);
?>

注意事项 #

• 如果你要创建商机（deal），只需要把$targetBoardId换成商机对应的工作板ID，同时调整$leadData里的列ID和对应值即可
• 不同类型的列传参格式有要求，比如日期列要传"YYYY-MM-DD"格式，下拉选择列要传选项的实际值而非显示名，传参前建议先核对列类型对应格式
• API Token需要有对应工作板的写入权限，否则会返回权限错误

内容的提问来源于stack exchange，提问作者Momin Iqbal