> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Asana

接待员可将来电者的请求转为团队的 Asana 任务，也可告知来电者工作进展。创建任务需通过 [Zapier](/docs/zh/reception-ai/integrations/zapier)，因为 Asana 的 API 要求将任务字段嵌套在 webhook 工具无法发送的 `data` 对象中。读取任务则使用 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)。

## 创建任务

### 连接 Zapier

如果尚未连接，请在 Reception.ai 中连接 [Zapier](/docs/zh/reception-ai/integrations/zapier)。

### 添加 Asana 操作

在 Zapier MCP 服务器中添加 Asana **Create Task** 操作，并连接 Asana 账户。将工作区和项目设为固定值，让 AI 填写任务名称、备注和截止日期。

### 分配工具

在 Reception.ai 中，打开 Zapier 集成的 **Tools** 标签页，选择 **Refresh tools**，然后将 Asana 操作分配给 **Client**（接待员）。

### 测试

通过请求回电来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。任务会显示在项目中。

## 查看项目的未完成任务

### 创建个人访问令牌

在 Asana 中，依次打开 **My settings** → **Apps** → **Manage Developer Apps**，然后创建个人访问令牌。该令牌可查看你能查看的所有内容，因此可考虑使用仅有该项目访问权限的账户创建令牌。

### 查找项目 ID

在浏览器中打开项目。URL 中 `/project/` 后面的长数字就是项目 ID。

### 创建 webhook 工具

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

| 字段         | 值                                                                                                       |
| ---------- | ------------------------------------------------------------------------------------------------------- |
| **名称**     | `list_open_jobs`                                                                                        |
| **描述**     | “列出项目中的未完成工作。来电者询问其工作状态时使用。”                                                                            |
| **方法**     | GET                                                                                                     |
| **URL**    | `https://app.asana.com/api/1.0/projects/PROJECT_ID/tasks`                                               |
| **请求标头**   | `Authorization`：`Bearer ` 后接令牌                                                                          |
| **查询参数**   | `completed_since`（字符串，必填）：“始终使用精确值 `now`。”  `opt_fields`（字符串，必填）：“始终使用精确值 `name,due_on,assignee.name`。” |
| **分配给智能体** | **Receptionist**                                                                                        |

选择 **Enable**。

`completed_since=now` 让 Asana 仅返回未完成任务。按客户姓名命名任务，这样接待员就能在列表中找到来电者的任务。

## 故障排除

| 问题                          | 检查项                                                |
| --------------------------- | -------------------------------------------------- |
| Asana 操作未显示在 Reception.ai 中 | 在 Zapier 中添加操作后，请在 Zapier 集成中选择 **Refresh tools**。 |
| 任务列表出现 401                  | 标头必须为 `Bearer ` 后接有效令牌。                            |
| 任务列表出现 404                  | 检查项目 ID，以及令牌所属账户是否可查看该项目。                          |
| Asana 表示结果过大                | 超大型项目需要分页，而该工具不支持分页。请仅保留活跃工作。                      |