Airtable | ElevenLabs Documentation

접수 담당자가 Airtable 테이블에서 발신자를 조회하고 리드나 콜백 요청 같은 새 레코드를 추가할 수 있습니다. 조회에는 Airtable API를 사용합니다. API는 webhook 도구가 전송할 수 없는 방식으로 필드가 중첩되어 있어, 새 레코드는 Airtable 자동화를 통해 추가합니다.

레코드 조회

개인 액세스 토큰 만들기

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

샘플 전송 및 필드 매핑

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

자동화 켜기

자동화를 켜세요.

문제 해결

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