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

# Airtable

接待员可以在 Airtable 表格中查找来电者，并添加新记录，例如潜在客户或回电请求。查找功能使用 Airtable 的 API。新记录通过 Airtable 自动化添加，因为 API 要求字段采用 webhook 工具无法发送的嵌套方式。

## 查找记录

### 创建个人访问令牌

前往 [airtable.com/create/tokens](https://airtable.com/create/tokens)，创建具有 `data.records:read` 范围的令牌。在 **Access** 下，仅添加接待员所需的 base。

### 查找 base 和表格 ID

在浏览器中打开表格。URL 中包含以 `app` 开头的 base ID，以及以 `tbl` 开头的表格 ID。

### 创建 webhook 工具

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

| 字段         | 值                                                                                                                                |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **名称**     | `find_airtable_record`                                                                                                           |
| **描述**     | “在客户表中查找来电者。来电者咨询现有预约、订单或账户时使用。”                                                                                                 |
| **方法**     | GET                                                                                                                              |
| **URL**    | `https://api.airtable.com/v0/BASE_ID/TABLE_ID`                                                                                   |
| **请求标头**   | `Authorization`：`Bearer ` 后接令牌                                                                                                   |
| **查询参数**   | `filterByFormula`（字符串，必填）：“用于匹配来电者的 Airtable 公式，例如 `{Phone} = '+14155550123'`。使用字段名 Phone 和 Name。”  `maxRecords`（数字，必填）：“始终为 5。” |
| **分配给智能体** | **Receptionist**                                                                                                                 |

选择 **Enable**。

将描述中的 `Phone` 和 `Name` 替换为表格的字段名，这样接待员才能编写匹配的公式。

## 添加记录

### 创建自动化

在 base 中打开 **Automations**，选择 **Create automation**，然后选择 **When webhook received** 触发器。复制 webhook URL。并非所有 Airtable 套餐都提供 webhook 触发器。

### 创建 webhook 工具

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

| 字段         | 值                                                  |
| ---------- | -------------------------------------------------- |
| **名称**     | `add_airtable_record`                              |
| **描述**     | “来电者想要报价或回电时，保存新的潜在客户。”                            |
| **方法**     | POST                                               |
| **URL**    | 自动化的 webhook URL                                   |
| **正文参数**   | 每个要填写的字段一个，例如 `name`、`phone` 和 `request`（均为字符串，必填） |
| **分配给智能体** | **Receptionist**                                   |

### 发送示例并映射字段

通过发起会触发此工具的对话来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。在自动化中选择 **Test trigger** 以加载请求，然后添加 **Create record** 操作，并将每个正文参数映射到相应字段。

### 启用自动化

启用自动化。

## 故障排除

| 问题                              | 检查项                                               |
| ------------------------------- | ------------------------------------------------- |
| 查找时出现 401 或 403                 | 令牌需要 `data.records:read` 范围以及对此 base 的访问权限。       |
| 422 `INVALID_FILTER_BY_FORMULA` | 工具描述中的字段名必须与表格完全一致，包括大小写。                         |
| 查找无结果                           | 电话号码的存储格式必须与接待员发送的格式一致，例如 `+14155550123`。         |
| 未添加记录                           | 必须启用自动化，且 **Create record** 必须映射 webhook 触发器中的字段。 |
| Airtable 返回 429                 | Airtable 每个 base 每秒允许 5 个请求。请减少该 base 的其他 API 流量。 |