Airtable | ElevenLabs Documentation

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

查找记录

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

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

前往 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 触发器。

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

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

通过发起会触发此工具的对话来测试接待员。在自动化中选择 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 流量。