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

Copper

通話中にCopperで発信者を検索し、リードを追加して、メモやフォローアップタスクを記録します。

受付担当は、Copperに登録済みの発信者を識別し、新規発信者をリードとして追加できます。また、発信者の要望をメモし、チーム向けのフォローアップタスクを作成できます。発信者の検索とタスクの作成にはWebhookツールを使用します。リードとメモの追加にはZapierを使用します。Copperでは電話番号とメモのリンクがネストされたデータとして保存されますが、Webhookツールでは送信できないためです。

始める前に

CopperでSystem settings → API Keysを開き、Generate API keyを選択します。たとえばReception.aiというラベルを付けます。このキーはユーザー本人と同じ権限を持つため、アクセス可能なデータの閲覧や変更ができます。

以下のすべてのWebhookツールは、次のリクエストヘッダーを送信します。

ヘッダー値
X-PW-AccessTokenAPIキー
X-PW-Applicationdeveloper_api
X-PW-UserEmailキーを作成したユーザーのメールアドレス

APIキーとメールアドレスを持つ人は誰でもCopperのデータを閲覧・変更できます。キーを 共有ドキュメントには記載せず、漏えいした場合はCopperで削除してください。

Webhookツールを作成する

ツールごとにIntegrationsに移動し、Add integrationを選択して、Webhook Toolを選び、Assign to agentsをReceptionistに設定します。Copperの検索エンドポイントでは、本文に検索条件を含むPOSTを使用します。

連絡先を検索する

フィールド値
Namefind_copper_person
Description「電話番号で連絡先から発信者を検索します。通話の開始時に使用し、顧客かどうかを確認してください。」
MethodPOST
URLhttps://api.copper.com/developer_api/v1/people/search
Request Headers始める前にに記載されたヘッダー
Body Parametersphone_number(文字列、必須):「発信者の電話番号。」

リードを検索する

フィールド値
Namefind_copper_lead
Description「電話番号でリードから発信者を検索します。発信者が連絡先に登録されていない場合に使用してください。」
MethodPOST
URLhttps://api.copper.com/developer_api/v1/leads/search
Request Headers始める前にに記載されたヘッダー
Body Parametersphone_number(文字列、必須):「発信者の電話番号。」

フォローアップタスクを作成する

フィールド値
Namecreate_copper_task
Description「発信者に折り返しを約束した場合は、必ずチーム向けのタスクを作成してください。」
MethodPOST
URLhttps://api.copper.com/developer_api/v1/tasks
Request Headers始める前にに記載されたヘッダー
Body Parametersname(文字列、必須):「例:キッチンの見積もりについてJane Doeに折り返し電話する。」
details(文字列、必須):「発信者の名前、電話番号、要件。」

各ツールでEnableを選択します。

リードとメモを追加する

1

Zapierに接続する

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

2

Copperのアクションを追加する

mcp.zapier.comのZapier MCPサーバーでCopperアカウントに接続し、次のアクションを追加します。

  • Create Lead:オーナーとリードソースを固定値として設定し、発信者の名前、電話番号、メールアドレス、要望をAIに入力させます。
  • Create Activity:アクティビティの種類をメモに設定し、検索ツールで見つかった人物またはリードと、発信者の要件をAIに入力させます。
3

ツールを割り当てる

Reception.aiでZapierインテグレーションのToolsタブを開き、Refresh toolsを選択して、両方のCopperアクションをClient(受付担当)に割り当てます。

4

テストする

Copperの連絡先に保存されている番号から電話をかけて受付担当をテストし、次に折り返しを依頼する新しい番号からテストします。新規発信者がリードとして表示され、Copperにタスクが表示されます。

手順を追加して、受付担当が最初に 連絡先とリードを検索し、どちらにも発信者が見つからなかった場合にのみリードを作成するようにします。

制限事項

  • Webhookツールはフラットな値を送信しますが、Copperではネストされた値を使ってタスクを人物またはリードにリンクします。そのため、create_copper_taskで作成したタスクは発信者のレコードにリンクされません。代わりに、タスクの詳細に発信者の名前と電話番号が保存されます。
  • Copperは期限をUnixタイムスタンプとして受け取りますが、AIでは確実に算出できないため、create_copper_taskでは期限が空欄になります。
  • タスクを発信者にリンクしたり期限を設定したりするには、Webhookツールの代わりにZapier経由でCopperのCreate Taskアクションを使用してください。
  • 受付担当がZapierアクションを実行するたびに、Zapierプランのタスクが消費されます。プランの上限に達すると、リセットされるまでアクションは停止します。

トラブルシューティング

問題確認事項
Copperから401または403エラーが返される3つのヘッダーをすべて確認します。X-PW-UserEmailには、キーを生成したユーザーのメールアドレスを指定する必要があります。
登録済みの発信者が見つからないCopperは保存されている形式の電話番号と照合します。番号の形式を統一し、発信者が会社ではなく人物またはリードとして登録されていることを確認してください。
受付担当が重複するリードを作成する検索ツールの説明で、発信者が見つからなかった場合にのみリードを作成するよう指示します。
Copperのアクションが表示されないZapierでアクションを追加した後、ZapierインテグレーションでRefresh toolsを選択します。
アクションにChangedと表示され、使用されないZapierでアクションが編集されています。ToolsタブでUpdateを選択します。