> 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를 사용합니다. API는 webhook 도구가 전송할 수 없는 방식으로 필드가 중첩되어 있어, 새 레코드는 Airtable 자동화를 통해 추가합니다.

## 레코드 조회

### 개인 액세스 토큰 만들기

[airtable.com/create/tokens](https://airtable.com/create/tokens)로 이동하여 `data.records:read` 범위의 토큰을 만드세요. **Access**에서 접수 담당자에게 필요한 베이스만 추가하세요.

### 베이스 및 테이블 ID 찾기

브라우저에서 테이블을 여세요. URL에는 `app`으로 시작하는 베이스 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`을 테이블의 필드 이름으로 바꾸면 접수 담당자가 일치하는 수식을 작성합니다.

## 레코드 추가

### 자동화 만들기

베이스에서 **Automations**를 열고 **Create automation**을 선택한 뒤 **When webhook received** 트리거를 선택하세요. webhook URL을 복사하세요. webhook 트리거는 모든 Airtable 요금제에서 제공되지는 않습니다.

### webhook 도구 만들기

**Integrations**로 이동해 **Add integration**을 선택한 다음 **Webhook Tool**을 선택하세요.

| 필드           | 값                                                       |
| ------------ | ------------------------------------------------------- |
| **이름**       | `add_airtable_record`                                   |
| **설명**       | "발신자가 견적이나 콜백을 원할 때 새 리드를 저장합니다."                       |
| **메서드**      | POST                                                    |
| **URL**      | 자동화의 webhook URL                                        |
| **본문 매개변수**  | 입력할 필드마다 하나씩. 예: `name`, `phone`, `request`(모두 문자열, 필수) |
| **에이전트에 할당** | **Receptionist**                                        |

### 샘플 전송 및 필드 매핑

도구가 실행되는 대화로 [접수 담당자를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 자동화에서 **Test trigger**를 선택해 요청을 불러온 다음, **Create record** 작업을 추가하고 각 본문 매개변수를 필드에 매핑하세요.

### 자동화 켜기

자동화를 켜세요.

## 문제 해결

| 문제                              | 확인할 사항                                                         |
| ------------------------------- | -------------------------------------------------------------- |
| 조회 시 401 또는 403                 | 토큰에 `data.records:read` 범위와 이 베이스에 대한 액세스 권한이 필요합니다.           |
| 422 `INVALID_FILTER_BY_FORMULA` | 도구 설명의 필드 이름은 대소문자를 포함해 테이블과 정확히 일치해야 합니다.                     |
| 조회 결과가 없음                       | 전화번호는 접수 담당자가 보내는 형식(예: `+14155550123`)과 동일하게 저장되어야 합니다.       |
| 레코드가 추가되지 않음                    | 자동화가 켜져 있어야 하며, **Create record**에서 webhook 트리거의 필드를 매핑해야 합니다. |
| Airtable의 429                   | Airtable은 베이스당 초당 5개의 요청을 허용합니다. 해당 베이스의 다른 API 트래픽을 줄이세요.     |