ナビゲーションにスキップ

Attio

通話中に発信者を識別し、新しい人物を追加して、通話メモをAttioに記録します。

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

  • Webhookツール はAttioのAPIを直接呼び出すため、Zapierアカウントは不要で、Zapierのタスクも消費しません。
  • Zapier アクションではAttioへのサインインを代行しますが、アクションごとにZapierプランのタスクを消費します。

Attioの管理者にアクセストークンを作成してもらえない場合を除き、Webhookツールを使用してください。

オプション1:Webhookツール(推奨)

1

アクセストークンを作成する

Attioの管理者権限が必要です。ワークスペース名の横にあるドロップダウンを選択し、Workspace settings を開いて Developers タブに移動し、New access token を選択します。たとえばReception.aiという名前を付け、ツールに必要なスコープだけを付与します。オブジェクト設定の読み取り(object_configuration:read)、レコードの読み書き(record_permission:read-write)、メモの読み書き(note:read-write)です。Attio上のラベルは、これらの名前と若干異なる場合があります。

トークンに有効期限はなく、ワークスペース内のすべての人物を参照できます。漏えいした場合は、Attioで削除してください。

2

Webhookツールを作成する

以下の各ツールについて、Integrations に移動して Add integration を選択し、Webhook Tool を選びます。すべてのツールで同じヘッダーを送信します。Authorization(Secret)に、Bearer とトークンを続けて設定します。

3

ルールを追加する

受付担当がAttioを発信者の特定にのみ使用し、レコードやメモの内容を発信者に決して読み上げないよう指示するルールを追加します。

発信者を検索する

フィールド値
名前find_attio_person
説明「電話番号を使って、Attioに登録されている人物から発信者を検索します。通話開始時に使用してください。その人物のrecord_idをメモツールに渡します。」
メソッドPOST
URLhttps://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
URLhttps://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
URLhttps://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が別の値を送信しても、メモは常に人物に追加されます。

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

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

オプション2:Zapier

1

Zapierに接続する

まだ接続していない場合は、Reception.aiでZapierに接続します。

2

Attioアクションを追加する

mcp.zapier.comのZapier MCPサーバーで、Attio アプリから以下のアクションを追加し、Attioワークスペースに接続します。各フィールドについて、以下の一覧に従って固定値を設定するか、AIに入力させます。

3

ツールを割り当てる

Reception.aiでZapierインテグレーションの Tools タブを開き、Refresh tools を選択して、各アクションを以下の一覧どおりに割り当てます。

4

ルールを追加する

受付担当がAttioを発信者の特定にのみ使用し、レコードやメモの内容を発信者に決して読み上げないよう指示するルールを追加します。

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

5

テストする

Attioの人物に保存されている番号から電話をかけて受付担当をテストし、続けて折り返しを希望する新しい発信者としてテストします。Attioに新しい人物とメモが表示されます。

Zapierアクション

発信者を検索する

フィールド値
ZapierアクションFind Records
Zapierで設定オブジェクト:People。検索に使用する属性:電話番号。
AIに入力させる検索する値:発信者の電話番号。
割り当て先クライアント

発信者を追加する

フィールド値
ZapierアクションCreate Record
Zapierで設定オブジェクト:People。使用する場合、常に同じ値にする属性。
AIに入力させる名、姓、電話番号、メールアドレス。
割り当て先クライアント

メモを記録する

フィールド値
ZapierアクションCreate Note
Zapierで設定親オブジェクト:People。
AIに入力させる親レコードID(前のアクションから取得)、タイトル、発信者の用件を記載したメモ本文。
割り当て先クライアント

どちらのオプションを使用する場合も、受付担当が最初に発信者を検索し、一致する人物が見つからない場合にのみ人物を作成して、 その後にメモを記録するよう、手順を追加してください。

制限事項

  • 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を必要とします。