跳到导航

Monday.com

通过 webhook 工具在通话期间创建和查找 Monday.com 项目。

接待员可以在 Monday.com 看板中添加项目,例如新的潜在客户或回电请求,也可以按名称查找项目。Monday.com 的 API 使用 GraphQL:每个请求都是包含一个 query 字段的 POST,因此每个工具都会为接待员提供可填充的查询模板。

开始前

值查找位置
API token头像 → Developers → My access tokens
Board ID看板 URL 中 /boards/ 后的数字

该令牌将以你的身份运行,并拥有你对所有看板的访问权限。

创建项目

前往 Integrations,选择 Add integration,然后选择 Webhook Tool。

字段值
Namecreate_monday_item
Description“将回电请求添加到团队看板。每当承诺会跟进来电者时使用。”
MethodPOST
URLhttps://api.monday.com/v2
Request HeadersAuthorization:API 令牌,无需 Bearer
Body Parametersquery(字符串,必填),使用下方描述
Assign to agentsReceptionist

为 query 使用以下描述,并将 1234567890 替换为看板 ID:

A GraphQL mutation in exactly this form, changing only ITEM_NAME:
mutation { create_item(board_id: 1234567890, item_name: "ITEM_NAME") { id } }
ITEM_NAME is the caller's name, phone number, and request, without double quotes.

选择 Enable。

查找项目

使用相同的方法、URL 和请求头创建第二个 webhook 工具。

字段值
Namefind_monday_item
Description“按精确名称在看板中查找来电者的项目。当来电者询问已有任务时使用。”
Body Parametersquery(字符串,必填),使用下方描述
A GraphQL query in exactly this form, changing only ITEM_NAME:
query { items_page_by_column_values(board_id: 1234567890, limit: 5, columns: [{column_id: "name", column_values: ["ITEM_NAME"]}]) { items { name column_values { text column { title } } } } }

通过回电请求测试接待员,然后在第二次对话中询问该项目。

限制

创建工具仅设置项目名称。填充状态、日期或人员列需要在 GraphQL 查询中写入 JSON 值,接待员难以稳定地完成。若要设置列,请通过 Zapier 使用 Monday.com 的 Create Item 操作。

故障排除

问题检查项
Not Authenticated请求头必须只包含令牌,不要加 Bearer。
Parse error on ...接待员修改了查询结构。请让 query 描述更严格,或缩短项目名称。
未找到项目查找会精确匹配完整的项目名称。
Board not found检查看板 ID,并确认令牌所有者可查看该看板。