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

# Attio

리셉셔니스트는 이미 Attio에 등록된 발신자를 인식하고, 새 발신자를 이름과 전화번호가 포함된 사람으로 추가하며, 발신자가 원한 내용을 메모로 남겨 팀에서 후속 조치를 할 수 있습니다. 연결하는 방법은 두 가지입니다:

* **[Webhook 도구](#option-1-webhook-tools-recommended)** 는 Zapier 계정이나 Zapier 작업 사용 없이 Attio API를 직접 호출합니다.
* **[Zapier](#option-2-zapier)** 작업은 Attio에 대신 로그인하지만, 각 작업에서 Zapier 플랜의 작업이 사용됩니다.

Attio 관리자가 액세스 토큰을 만들 수 없는 경우가 아니라면 webhook 도구를 사용하세요.

## 옵션 1: Webhook 도구(권장)

### 액세스 토큰 만들기

Attio 관리자여야 합니다. 워크스페이스 이름 옆의 드롭다운을 선택하고 **Workspace settings**를 연 다음 **Developers** 탭으로 이동하여 **New access token**을 선택하세요. 예를 들어 `Reception.ai`라는 이름을 지정하고, 이 도구에 필요한 범위만 부여하세요. 객체 구성 읽기(`object_configuration:read`), 레코드 읽기-쓰기(`record_permission:read-write`), 메모 읽기-쓰기(`note:read-write`)입니다. Attio의 라벨은 이 이름과 약간 다를 수 있습니다.

토큰은 만료되지 않으며 워크스페이스의 모든 사람을 볼 수 있습니다. 유출된 경우 Attio에서 삭제하세요.

### Webhook 도구 만들기

아래의 각 [도구](#find-the-caller)에 대해 **Integrations**로 이동하여 **Add integration**을 선택하고 **Webhook Tool**을 선택하세요. 모든 도구는 동일한 헤더를 전송합니다. `Authorization`(Secret)을 선택하고 `Bearer ` 뒤에 토큰을 입력하세요.

### 규칙 추가

리셉셔니스트에게 Attio는 발신자 인식 용도로만 사용하고 레코드나 메모 내용을 발신자에게 읽어 주지 않도록 지시하는 [규칙](/docs/ko/reception-ai/receptionist/rules-and-procedures)을 추가하세요.

### 발신자 찾기

| 필드           | 값                                                                                |
| ------------ | -------------------------------------------------------------------------------- |
| **이름**       | `find_attio_person`                                                              |
| **설명**       | "전화번호로 Attio의 사람 목록에서 발신자를 찾습니다. 통화 시작 시 사용하세요. 해당 사람의 record_id를 메모 도구에 전달하세요." |
| **메서드**      | POST                                                                             |
| **URL**      | `https://api.attio.com/v2/objects/people/records/query`                          |
| **요청 헤더**    | `Authorization`(Secret): `Bearer ` 뒤에 토큰 입력                                      |
| **본문 매개변수**  | `filter`(객체, 필수), 아래 필드 포함  `limit`(정수, 고정값): `5`                                |
| **에이전트에 할당** | **리셉셔니스트**                                                                       |

`filter`에서 **Add field**를 선택하고 다음을 추가하세요.

* `phone_numbers`(문자열, 필수, 대화에서 가져오기): "국제 형식의 발신자 전화번호입니다. 예: +14155550123"

Attio는 저장된 번호가 정확히 일치하는 사람만 반환하므로 국가 코드를 포함하여 번호를 저장하세요.

### 발신자 추가

| 필드           | 값                                                                                       |
| ------------ | --------------------------------------------------------------------------------------- |
| **이름**       | `create_attio_person`                                                                   |
| **설명**       | "`find_attio_person`에서 발신자를 찾지 못한 경우에만 발신자를 사람으로 추가합니다. 새 사람의 record_id를 메모 도구에 전달하세요." |
| **메서드**      | POST                                                                                    |
| **URL**      | `https://api.attio.com/v2/objects/people/records`                                       |
| **요청 헤더**    | `Authorization`(Secret): `Bearer ` 뒤에 토큰 입력                                             |
| **본문 매개변수**  | `data`(객체, 필수), 아래 필드 포함                                                                |
| **에이전트에 할당** | **리셉셔니스트**                                                                              |

`data`에서 **Add field**를 선택하고 `values`(객체, 필수)를 추가하세요. `values`에 다음을 추가하세요.

* `name`(객체, 필수), 세 필드 포함:
  * `first_name`(문자열, 필수, 대화에서 가져오기): "발신자의 이름입니다."
  * `last_name`(문자열, 필수, 대화에서 가져오기): "발신자의 성입니다. 제공하지 않은 경우 빈 문자열을 입력하세요."
  * `full_name`(문자열, 필수, 대화에서 가져오기): "발신자의 이름과 성입니다."
* `phone_numbers`(배열, 필수, 대화에서 가져오기): "발신자의 전화번호를 위한 항목을 정확히 하나 입력합니다." **Each item**에서 `string`을 선택하고 "국제 형식의 발신자 전화번호입니다. 예: +14155550123"이라고 설명을 입력하세요.
* `email_addresses`(배열, 대화에서 가져오기): "발신자의 이메일 주소를 위한 항목을 정확히 하나 입력합니다. 제공하지 않은 경우 생략하세요." **Each item**에서 `string`을 선택하고 "발신자의 이메일 주소입니다."라고 설명을 입력하세요.

### 메모 기록

| 필드           | 값                                           |
| ------------ | ------------------------------------------- |
| **이름**       | `add_attio_note`                            |
| **설명**       | "통화가 끝나기 전에 해당 사람의 레코드에 발신자가 원한 내용을 메모합니다." |
| **메서드**      | POST                                        |
| **URL**      | `https://api.attio.com/v2/notes`            |
| **요청 헤더**    | `Authorization`(Secret): `Bearer ` 뒤에 토큰 입력 |
| **본문 매개변수**  | `data`(객체, 필수), 아래 필드 포함                    |
| **에이전트에 할당** | **리셉셔니스트**                                  |

다음 각각에 대해 `data`에서 **Add field**를 선택하세요.

* `parent_object`(문자열, 고정값): `people`
* `parent_record_id`(문자열, 필수, 대화에서 가져오기): "`find_attio_person` 또는 `create_attio_person`의 사람 record_id입니다."
* `title`(문자열, 필수, 대화에서 가져오기): "짧은 제목입니다. 예: 견적 관련 Jane Doe의 전화"
* `format`(문자열, 고정값): `plaintext`
* `content`(문자열, 필수, 대화에서 가져오기): "발신자가 원한 내용을 몇 문장으로 작성합니다."

상위 객체와 형식은 고정값이므로 AI가 다른 값을 전송하더라도 메모는 항상 사람에게 추가됩니다.

> **Warning**
>
> `find_attio_person`은 사람에게 저장된 내용을 그대로 반환합니다. 리셉셔니스트가 Attio를
> 발신자 인식 용도로만 사용하고 발신자가 다른 사람의 세부 정보를 듣지 않도록 규칙을
> 유지하세요.

각 도구에서 **Enable**을 선택한 다음 Attio 사람에 저장된 번호로 전화하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하고, 콜백을 요청하는 새 발신자로도 테스트하세요. Attio에 새 사람과 메모가 표시됩니다.

## 옵션 2: Zapier

### Zapier 연결

아직 연결하지 않았다면 Reception.ai에서 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 연결하세요.

### Attio 작업 추가

[mcp.zapier.com](https://mcp.zapier.com)의 Zapier MCP 서버에서 **Attio** 앱의 아래 [작업](#zapier-actions)을 추가하고 Attio 워크스페이스를 연결하세요. 각 필드는 나열된 대로 고정값을 설정하거나 AI가 입력하도록 하세요.

### 도구 할당

Reception.ai에서 Zapier 통합의 **Tools** 탭을 열고 **Refresh tools**를 선택한 다음, 나열된 대로 각 작업을 할당하세요.

### 규칙 추가

리셉셔니스트에게 Attio는 발신자 인식 용도로만 사용하고 레코드나 메모 내용을 발신자에게 읽어 주지 않도록 지시하는 [규칙](/docs/ko/reception-ai/receptionist/rules-and-procedures)을 추가하세요.

> **Warning**
>
> Zapier는 워크스페이스를 연결한 Attio 사용자로 작동하며, 해당 사용자가 볼 수 있는 모든 내용을 볼 수 있습니다.
> 리셉셔니스트에 필요한 레코드로 액세스가 제한된 구성원으로 연결하고, 발신자가 다른 사람의 세부 정보를
> 듣지 않도록 규칙을 유지하세요.

### 테스트

Attio 사람에 저장된 번호로 전화하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하고, 콜백을 요청하는 새 발신자로도 테스트하세요. Attio에 새 사람과 메모가 표시됩니다.

### Zapier 작업

#### 발신자 찾기

| 필드              | 값                         |
| --------------- | ------------------------- |
| **Zapier 작업**   | **Find Records**          |
| **Zapier에서 설정** | 객체: People. 검색할 속성: 전화번호. |
| **AI가 입력**      | 검색할 값: 발신자의 전화번호.         |
| **할당 대상**       | **클라이언트**                 |

#### 발신자 추가

| 필드              | 값                                  |
| --------------- | ---------------------------------- |
| **Zapier 작업**   | **Create Record**                  |
| **Zapier에서 설정** | 객체: People. 사용하는 경우 항상 동일해야 하는 속성. |
| **AI가 입력**      | 이름, 성, 전화번호, 이메일 주소.               |
| **할당 대상**       | **클라이언트**                          |

#### 메모 기록

| 필드              | 값                                                    |
| --------------- | ---------------------------------------------------- |
| **Zapier 작업**   | **Create Note**                                      |
| **Zapier에서 설정** | 상위 객체: People.                                       |
| **AI가 입력**      | 상위 레코드 ID(이전 작업에서 가져옴), 제목, 발신자에게 필요한 내용을 담은 메모 텍스트. |
| **할당 대상**       | **클라이언트**                                            |

> **Tip**
>
> 어떤 옵션을 사용하든 [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를 추가하여
> 리셉셔니스트가 먼저 발신자를 검색하고, 일치 항목이 없을 때만 사람을 생성한 후
> 메모를 기록하도록 하세요.

## 제한 사항

* Attio는 전화번호가 유효한지 확인합니다. 도구 또는 작업의 설명에서 리셉셔니스트에게 `+14155550123`과 같은 국제 형식으로 번호를 전송하도록 안내하세요.
* 이메일 주소와 같은 동일한 고유 값을 다른 사람이 이미 가진 경우 사람 생성에 실패합니다. 리셉셔니스트는 먼저 검색해야 합니다.
* Zapier를 통해 생성된 작업은 Attio 레코드에 연결할 수 없으므로 통화 세부 정보에는 메모를 사용하세요.
* Zapier에서는 리셉셔니스트가 실행하는 각 작업마다 Zapier 플랜의 작업이 사용됩니다. 현재 Zapier는 성공한 통화당 작업 2개를 계산하며 실패한 통화는 계산하지 않습니다. 플랜이 소진되면 재설정될 때까지 작업이 중지됩니다.

## 문제 해결

| 문제                              | 확인할 사항                                                                                           |
| ------------------------------- | ------------------------------------------------------------------------------------------------ |
| Attio에서 401 또는 403 응답           | 헤더 값이 `Bearer `와 공백으로 시작하는지, 토큰에 위의 범위가 있고 삭제되지 않았는지 확인하세요.                                      |
| Attio 작업이 Reception.ai에 표시되지 않음 | Zapier에서 작업을 추가한 후 Zapier 통합에서 **Refresh tools**를 선택하세요.                                         |
| 작업에 **Changed**가 표시되고 사용되지 않음   | Zapier에서 작업을 수정했습니다. **Tools** 탭에서 **Update**를 선택하세요.                                            |
| 알려진 발신자를 찾을 수 없음                | 번호가 국가 코드와 함께 저장되었는지 확인하세요. Zapier에서는 **Find Records**가 전화번호로 People 객체를 검색하는지 확인하세요.            |
| 사람 생성 실패                        | 전화번호가 국제 형식이 아니거나 발신자의 이메일 주소가 이미 저장되어 있을 수 있습니다.                                                |
| 메모가 발신자에게 연결되지 않음               | 리셉셔니스트는 찾기 또는 생성 도구의 레코드 ID, 또는 Zapier의 **Find Records**나 **Create Record**에서 가져온 레코드 ID가 필요합니다. |