> 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.

# JobNimbus

使用下方的 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)，接待员可以将新来电者添加到 JobNimbus，作为潜在客户工作流中的联系人，并记录其电话号码、地址和需求，方便团队跟进。

## 开始前

1. 在 JobNimbus 中，选择右上角的个人资料图标，然后依次选择 **Settings** → **API**，创建新的 API 密钥。
2. 选择可创建联系人且权限仅满足所需范围的 **Access Profile**。该密钥会保留创建时此配置文件拥有的权限。
3. 复制完整 API 密钥，而非 **Key ID**。JobNimbus 只会显示一次。

该工具会在 `Authorization` 请求标头中以 `Bearer YOUR_API_KEY` 的形式发送密钥。

> **Warning**
>
> API 密钥可访问 JobNimbus 数据。请妥善保存，切勿分享。新密钥会在一年后过期，因此请在此之前创建替代密钥。

还需要新潜在客户应进入的联系人工作流和状态的准确名称，即 JobNimbus 设置中显示的名称，例如 `Customer` 和 `Lead`。

## 创建工具

前往 **Integrations**，选择 **Add integration**，再选择 **Webhook Tool**，然后填写以下字段。

| 字段         | 值                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **名称**     | `create_jobnimbus_contact`                                                                                                                                                                                                                                                                                                                                                                             |
| **描述**     | "当来电者需要服务且此前未使用过我们的服务时，将其作为新潜在客户添加到 CRM。"                                                                                                                                                                                                                                                                                                                                                              |
| **方法**     | POST                                                                                                                                                                                                                                                                                                                                                                                                   |
| **URL**    | `https://app.jobnimbus.com/api1/contacts`                                                                                                                                                                                                                                                                                                                                                              |
| **请求标头**   | `Authorization`：`Bearer YOUR_API_KEY`                                                                                                                                                                                                                                                                                                                                                                  |
| **正文参数**   | `first_name`（字符串，必填）：“来电者的名字。”  `last_name`（字符串，必填）：“来电者的姓氏。”  `record_type_name`（字符串，必填）：“始终使用准确值 `Customer`。”  `status_name`（字符串，必填）：“始终使用准确值 `Lead`。”  `mobile_phone`（字符串，必填）：“来电者的电话号码，仅限数字。”  `email`（字符串）：“来电者提供时填写其邮箱地址。”  `address_line1`（字符串）：“需要服务的街道地址。”  `city`（字符串）：“该地址所在城市。”  `state_text`（字符串）：“州，使用两个字母的代码。”  `zip`（字符串）：“邮政编码。”  `description`（字符串，必填）：“来电者需要什么服务、何时有空，以及他们告知的其他信息。” |
| **分配给智能体** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                       |

将 `Customer` 和 `Lead` 替换为自己的工作流和状态名称。

选择 **Enable**，然后以需要屋顶检查的新来电者身份 [测试接待员](/docs/zh/reception-ai/receptionist/testing)。联系人会以潜在客户状态显示在 JobNimbus 中。

> **Tip**
>
> 添加一条 [流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)，要求接待员先收集完整地址，再添加来电者。

## 限制

* 搜索 JobNimbus 联系人需要 JSON 搜索筛选器，因此该工具无法查找来电者。回访来电者可能会被重复添加。
* 工作、任务和备注通过嵌套字段关联联系人，而 webhook 工具无法发送这些字段。因此，联系人的描述会保存通话详情。

如需按邮箱查找来电者并创建与其联系人关联的工作，请通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 使用 JobNimbus 的 **Find Contact by Email**、**Create Contact** 和 **Create Job** 操作。

## 故障排除

| 问题                     | 检查内容                                                    |
| ---------------------- | ------------------------------------------------------- |
| JobNimbus 返回 401 或 403 | 标头值必须是 `Bearer` 后接完整 API 密钥，而非 **Key ID**。检查密钥是否已过期。    |
| 工作流或状态错误               | `record_type_name` 和 `status_name` 必须与联系人工作流及其某个状态完全匹配。 |
| 403 且提示权限消息            | 密钥的 **Access Profile** 无法创建联系人。请使用具有此权限的配置文件创建新密钥。      |
| 联系人没有地址                | 在描述中要求接待员先询问完整地址，再添加来电者。                                |