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

# Attio

受付担当は、Attioにすでに登録されている発信者を特定し、新しい発信者を名前と電話番号付きの人物として追加できます。また、用件をメモに残し、チームが後から対応できるようにします。接続方法は2つあります。

* **[Webhookツール](#option-1-webhook-tools-recommended)** はAttioのAPIを直接呼び出すため、Zapierアカウントは不要で、Zapierのタスクも消費しません。
* **[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/ja/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`（object、必須）。以下のフィールドを含む  `limit`（integer、固定値）：`5`                       |
| **エージェントに割り当て** | **受付担当**                                                                        |

`filter`で **Add field** を選択し、次を追加します。

* `phone_numbers`（string、必須、会話から取得）：「発信者の電話番号を国際形式で指定します。例：+14155550123」

Attioでは、保存されている番号と完全に一致する人物のみが返されるため、電話番号は国番号付きで保存してください。

### 発信者を追加する

| フィールド           | 値                                                                              |
| --------------- | ------------------------------------------------------------------------------ |
| **名前**          | `create_attio_person`                                                          |
| **説明**          | 「`find_attio_person`で見つからなかった場合にのみ、発信者を人物として追加します。新しい人物のrecord_idをメモツールに渡します。」 |
| **メソッド**        | POST                                                                           |
| **URL**         | `https://api.attio.com/v2/objects/people/records`                              |
| **リクエストヘッダー**   | `Authorization`（Secret）：`Bearer `の後にトークンを指定                                    |
| **本文パラメーター**    | `data`（object、必須）。以下のフィールドを含む                                                  |
| **エージェントに割り当て** | **受付担当**                                                                       |

`data`で **Add field** を選択し、`values`（object、必須）を追加します。`values`に次を追加します。

* `name`（object、必須）。次の3つのフィールドを含む：
  * `first_name`（string、必須、会話から取得）：「発信者の名。」
  * `last_name`（string、必須、会話から取得）：「発信者の姓。姓を伝えなかった場合は空の文字列。」
  * `full_name`（string、必須、会話から取得）：「発信者の姓名。」
* `phone_numbers`（array、必須、会話から取得）：「発信者の電話番号を1件だけ指定します。」**Each item** で`string`を選択し、説明に「発信者の電話番号を国際形式で指定します。例：+14155550123」と入力します。
* `email_addresses`（array、会話から取得）：「発信者のメールアドレスを1件だけ指定します。伝えられなかった場合は省略します。」**Each item** で`string`を選択し、説明に「発信者のメールアドレス」と入力します。

### メモを記録する

| フィールド           | 値                                           |
| --------------- | ------------------------------------------- |
| **名前**          | `add_attio_note`                            |
| **説明**          | 「通話が終了する前に、発信者の用件をその人物のレコードに記録します。」         |
| **メソッド**        | POST                                        |
| **URL**         | `https://api.attio.com/v2/notes`            |
| **リクエストヘッダー**   | `Authorization`（Secret）：`Bearer `の後にトークンを指定 |
| **本文パラメーター**    | `data`（object、必須）。以下のフィールドを含む               |
| **エージェントに割り当て** | **受付担当**                                    |

`data`で、次の項目ごとに **Add field** を選択します。

* `parent_object`（string、固定値）：`people`
* `parent_record_id`（string、必須、会話から取得）：「`find_attio_person`または`create_attio_person`から取得した人物のrecord_id。」
* `title`（string、必須、会話から取得）：「短いタイトル。例：Jane Doeから見積もりについての電話。」
* `format`（string、固定値）：`plaintext`
* `content`（string、必須、会話から取得）：「発信者の用件を数文でまとめます。」

親オブジェクトと形式は固定値です。そのため、AIが別の値を送信しても、メモは常に人物に追加されます。

> **Warning**
>
> `find_attio_person`は、その人物について保存されているすべての情報を返します。受付担当がAttioを発信者の特定にのみ使用し、
> 発信者に別の人物の情報が決して伝わらないよう、ルールを設定したままにしてください。

各ツールで **Enable** を選択します。次に、Attioの人物に保存されている番号から電話をかけて[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)し、続けて折り返しを希望する新しい発信者としてテストします。Attioに新しい人物とメモが表示されます。

## オプション2：Zapier

### Zapierに接続する

まだ接続していない場合は、Reception.aiで[Zapier](/docs/ja/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/ja/reception-ai/receptionist/rules-and-procedures)を追加します。

> **Warning**
>
> Zapierは、ワークスペースに接続したAttioユーザーとして動作し、そのユーザーが参照できるすべての情報にアクセスできます。
> 受付担当に必要なレコードだけにアクセスが制限されているメンバーとして接続し、発信者に別の人物の情報が決して伝わらないよう、
> ルールを設定したままにしてください。

### テストする

Attioの人物に保存されている番号から電話をかけて[受付担当をテスト](/docs/ja/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/ja/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を必要とします。 |