> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Xero

接待员可以检查来电者是否已是 Xero 组织中的联系人，并将新来电者添加为联系人，方便之后发送报价单或发票。Xero 的 API 只接受每 30 分钟过期一次的 OAuth 登录令牌，因此 webhook 工具无法直接连接。Reception 通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 连接。

> **Warning**
>
> Xero 保存财务记录。请勿添加用于创建或发送发票、账单、付款或贷项通知单的操作。
> 来电者可能会诱导接待员填写错误的金额或收件人。请自行在 Xero 中创建发票。

## 设置

### 连接 Zapier

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

### 添加 Xero 操作

在 [mcp.zapier.com](https://mcp.zapier.com) 的 Zapier MCP 服务器中，从 **Xero** 应用添加[以下操作](#actions)，并在 Zapier 提示时登录 Xero。对于每个字段，请按列表设为固定值或由 AI 填写。

这些操作可以执行你登录的 Xero 用户有权执行的所有操作。建议使用一个拥有可管理联系人的最低权限角色的专用用户。

### 分配工具

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

### 测试

先以提供企业名称的现有客户身份[测试接待员](/docs/zh/reception-ai/receptionist/testing)，然后再以新来电者身份测试。新联系人会显示在 Xero 的 **Contacts** 下。

## 操作

### 查找来电者

| 字段               | 值                                  |
| ---------------- | ---------------------------------- |
| **Zapier 操作**    | **Find Contact**                   |
| **在 Zapier 中设置** | **Organization**：Xero 组织。按联系人姓名搜索。 |
| **由 AI 填写**      | 联系人姓名：来电者的企业名称或全名。                 |
| **分配给**          | **Client**                         |

Xero 按姓名或账号查找联系人，不能按电话号码查找，因此接待员必须询问账户登记的姓名。

### 添加来电者

| 字段               | 值                                                |
| ---------------- | ------------------------------------------------ |
| **Zapier 操作**    | **Find or Create Contact**                       |
| **在 Zapier 中设置** | **Organization**，并按联系人姓名搜索。账号代码、税号、银行账户和付款条款请留空。 |
| **由 AI 填写**      | **Contact Name**、主要联系人的名字、姓氏和邮箱、电话号码及地址。         |
| **分配给**          | **Client**                                       |

请使用 **Find or Create Contact**，不要使用 **Create/Update Contact**。**Create/Update Contact** 会更改现有联系人，因此如果来电者提供了其他客户的姓名，可能会覆盖该客户的电话号码或邮箱。

> **Tip**
>
> 添加一个[流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)，让接待员先询问来电者的企业名称，
> 并在添加联系人前进行搜索。

> **Warning**
>
> **Find Contact** 会返回联系人中保存的所有内容。请添加一条
> [规则](/docs/zh/reception-ai/receptionist/rules-and-procedures)，要求接待员绝不向来电者复述联系人的详细信息、
> 余额或发票，仅用这些信息识别来电者。

## 限制

* 接待员无法按电话号码查询来电者。它需要联系人在 Xero 中保存时使用的准确名称。
* 接待员无法创建发票或报价单。请在通话中收集信息，然后自行根据联系人创建发票。
* 接待员每运行一次操作，都会消耗 Zapier 套餐中的任务额度。Zapier 目前每次成功通话计为 2 个任务；失败通话不计入。套餐额度用完后，操作会停止，直到额度重置。

## 故障排除

| 问题                        | 检查内容                                              |
| ------------------------- | ------------------------------------------------- |
| Reception.ai 中未显示 Xero 操作 | 在 Zapier 中添加操作后，在 Zapier 集成中选择 **Refresh tools**。 |
| 操作显示 **Changed**，且未被使用    | 你在 Zapier 中编辑了它。请在 **Tools** 标签页中选择 **Update**。   |
| 未找到已知来电者                  | Xero 按保存的联系人姓名匹配。请询问来电者其发票上的企业名称。                 |
| 联系人被添加到错误组织               | 在 Zapier 中将 **Organization** 设为固定值。               |
| Zapier 停止连接 Xero          | 在 Zapier 中重新连接 Xero 账户。Xero 会终止长期未使用的连接。          |