> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# HighLevel

HighLevelはGoHighLevelとも呼ばれ、そのAPIはLeadConnectorの名称で提供されています。[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使うと、受付担当が各発信者をHighLevelサブアカウントの連絡先として保存できます。発信者がすでに連絡先に登録されている場合、HighLevelは重複する連絡先を作成せず、既存のレコードを更新します。

## セットアップ

### プライベートインテグレーショントークンを作成する

HighLevelのサブアカウントで、**Settings** → **Private Integrations** を開き、**Create New Integration** を選択します。名前を付け、連絡先の表示と編集に必要なスコープだけを選択して作成します。トークンはHighLevelに一度しか表示されないため、すぐにコピーしてください。

設定に **Private Integrations** がない場合は、エージェンシー管理者にアクセス権を付与してもらってください。

### ロケーションIDを確認する

同じサブアカウントで **Settings** → **Business Profile** を開き、**Location ID** をコピーします。

### Webhookツールを作成する

Reception.aiで **Integrations** に移動し、**Add integration** を選択して、**Webhook Tool** を選びます。

| フィールド            | 値                                                                                                                                                                                                                                                                           |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名前**           | `save_highlevel_contact`                                                                                                                                                                                                                                                    |
| **説明**           | 「発信者の名前と電話番号が分かったら、その人をCRMの連絡先として保存します。新規または既存顧客からのすべての通話で使用してください。」                                                                                                                                                                                                        |
| **メソッド**         | POST                                                                                                                                                                                                                                                                        |
| **URL**          | `https://services.leadconnectorhq.com/contacts/upsert`                                                                                                                                                                                                                      |
| **リクエストヘッダー**    | `Authorization`：`Bearer `の後にトークンを指定  `Version`：`2021-07-28`                                                                                                                                                                                                                 |
| **本文パラメーター**     | `locationId`（文字列、必須）：「常に正確な値`LOCATION_ID`を指定します。」  `firstName`（文字列、必須）：「発信者の名。」  `lastName`（文字列）：「発信者が伝えた場合は、その姓。」  `phone`（文字列、必須）：「発信者の電話番号を国際形式で指定します（例：+14155550123）。」  `email`（文字列）：「発信者が伝えた場合は、そのメールアドレス。」  `source`（文字列、必須）：「常に正確な値`Reception.ai phone call`を指定します。」 |
| **エージェントへの割り当て** | **受付担当**                                                                                                                                                                                                                                                                    |

`LOCATION_ID`をコピーしたIDに置き換えます。**Enable** を選択します。

### テストする

名前と電話番号を伝える通話で[受付担当をテストします](/docs/ja/reception-ai/receptionist/testing)。HighLevelの **Contacts** に連絡先が表示されます。同じ番号でもう一度電話すると、新しい連絡先が追加されるのではなく、既存の連絡先が更新されます。

> **Warning**
>
> このトークンを使うと、連絡先の表示と変更ができます。共有ドキュメントには記載しないでください。漏洩した場合は、
> HighLevelでプライベートインテグレーションを削除してください。

発信者がすでに連絡先に登録されているかどうかは、サブアカウントの **Allow Duplicate Contact** 設定に基づいてHighLevelが判断します。この設定でメールアドレスと電話番号の両方を照合する場合は、設定に記載された順番で確認されます。

> **Tip**
>
> 通話後に営業案件を作成したりチームに通知したりするには、**Inbound Webhook** トリガーで開始するHighLevelの
> ワークフローを作成します。2つ目のWebhookツールから、必要なフィールドを含めて
> ワークフローのURLに送信し、ワークフロー内でそれらのフィールドをマッピングします。
> ワークフローのURLは機密情報として扱ってください。HighLevelではInbound Webhookがプレミアムトリガーに分類されるため、
> 利用料金についてプランを確認してください。

## 制限事項

* HighLevelのMCPサーバーにはOAuthサインインが必要ですが、Reception.aiは対応していません。そのため、Webhookツールを使用してください。
* HighLevelのAPIでは、タグとカスタムフィールドはリストですが、Webhookツールはフラットな値を送信します。代わりにワークフローで設定してください。
* メモやタスクを追加するにはURLに連絡先IDが必要ですが、Webhookツールでは通話中に入力できません。これらには **Inbound Webhook** ワークフローを使用してください。

## トラブルシューティング

| 問題                    | 確認事項                                                                                          |
| --------------------- | --------------------------------------------------------------------------------------------- |
| HighLevelから401が返される   | `Authorization`ヘッダーでは、`Bearer`の後にスペースを入れ、続けてトークンを指定する必要があります。                                 |
| HighLevelから403が返される   | トークンには連絡先のスコープが必要です。また、`locationId`にはトークンを作成したサブアカウントを指定する必要があります。                            |
| HighLevelでバージョンが拒否される | `Version`ヘッダーは正確に`2021-07-28`と指定する必要があります。HighLevelのAPIドキュメントで新しい必須値が案内されている場合は、その値を使用してください。 |
| リピーターが重複して登録される       | **Allow Duplicate Contact** 設定を確認し、電話番号が同じ国際形式で保存されていることも確認してください。                            |
| 連絡先に名前がない             | 保存前に発信者の名前を尋ねるよう、ツールの説明で受付担当に指示してください。                                                        |