# GoHighLevel (GHL) 連携

すでにGoHighLevel (GHL) を使用してビジネスを管理されていますか？この統合により、既存のGHL設定に <span data-t="appName">Your AI Connector</span> のAI搭載メッセージング機能を追加できます。GHLに届いたメッセージはAIによる処理のために <span data-t="appName">Your AI Connector</span> へ転送され、<span data-t="appName">Your AI Connector</span> からの返信は元のチャネルを通じてGHL経由で顧客に送信されます。

> 別のCRMを使用していますか？<span data-t="appName">Your AI Connector</span>と連携するために専用の画面は必要ありません。カスタム関数、API、およびWebhookについては、[リストにないツールの接続](connecting-other-tools.md)を参照してください。

つまり、GHL をメインハブとして使い続けながら、AI による会話管理をプラットフォームに任せることができます。

::: note
**注意:** これは自動ワークフローの設定や、Webhook（アプリ間の自動通知）およびAPI呼び出しを使用したシステム接続を伴う、技術的な統合です。この作業に不安がある場合は、開発者や技術に詳しいチームメンバーにこのページを共有することをお勧めします。
:::


---

## 前提条件

- APIキー（**Settings → Integrations → API Key** で確認可能）を持つ有効な **<span data-t="appName">Your AI Connector</span> アカウント**。APIキーは、GHLがアカウントと安全に通信するための固有のコードです。
- ワークフローの作成とWebhook（システム間の自動通知）の管理権限を持つ **GoHighLevelアカウント**。

---

## 仕組み

| 方向 | 動作 |
|---|---|
| **GHL から <span data-t="appName">Your AI Connector</span>** | 顧客がGHLのSMS、メール、Messenger、Instagram、またはライブチャットでメッセージを送信します。ワークフローがそのメッセージを自動的に <span data-t="appName">Your AI Connector</span> へ転送します。<span data-t="appName">Your AI Connector</span> がそれを処理（AI応答、タグ付けなど）します。 |
| **<span data-t="appName">Your AI Connector</span> から GHL** | <span data-t="appName">Your AI Connector</span> が（手動またはAI経由で）返信を送信すると、自動的にGHLに通知されます。GHL内のワークフローが連絡先を特定し、適切なチャネルを通じて返信を送信します。 |

---

## ワークフロー 1: GHL から <span data-t="appName">Your AI Connector</span>

このワークフローは、GHLからの着信メッセージを <span data-t="appName">Your AI Connector</span> に転送します。

### ステップ 1: ワークフローの作成

1. GHLで **Automation > Workflows** に移動します。
2. **Create New Workflow** をクリックします。
3. 「Send Message to <span data-t="appName">Your AI Connector</span>」など、分かりやすい名前を付けます。

### ステップ 2: トリガーの追加

転送したいチャネルごとにトリガーを追加します：

- 顧客が返信 - SMS
- 顧客が返信 - メール
- 顧客が返信 - Facebook メッセージ
- 顧客が返信 - Instagram DM
- 顧客が返信 - ライブチャット

すべて追加することも、設定に関連するチャネルのみを追加することも可能です。

### ステップ 3: タグフィルターの追加（オプション）

特定の連絡先からのメッセージのみを転送したい場合：

1. トリガーの **フィルターを追加** をクリックします。
2. 条件を「連絡先にタグがある」に設定します。
3. タグを選択します。
4. 連絡先が選択したタグの **いずれか** を持つべきか、**すべて** を持つべきかを選択します。

### ステップ 4: チャネル分岐を作成する

**条件** アクションを追加して、各チャネルをそれぞれのWebhookにルーティングします：

| 分岐 | 条件 |
|---|---|
| 分岐 1 | メッセージソースが `Email` と等しい |
| 分岐 2 | メッセージソースが `SMS` と等しい |
| 分岐 3 | メッセージソースが `Messenger` と等しい |
| 分岐 4 | メッセージソースが `Instagram` と等しい |
| 分岐 5 | メッセージソースが `Live Chat` と等しい |

### ステップ 5: Webhookを設定する

各分岐に対して、**Webhook / HTTPリクエスト** アクションを追加します：

- **メソッド:** `POST`
- **URL:**
  ```
  https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
  ```

- **カスタムデータフィールド:**

| フィールド | 値 | 備考 |
|---|---|---|
| `messageSid` | `{{right_now.second}}{{contact.id}}` | 一意のメッセージ識別子 |
| `fromId` | `{{contact.id}}` | GHL連絡先ID |
| `toId` | `{{user.id}}` | GHLユーザーID |
| `body` | `{{message.body}}` | メッセージの内容 |
| `channel` | 下表を参照 | 分岐と一致させる必要があります |
| `status` | `created` | 常に `created` に設定 |
| `messageType` | `text` | メッセージタイプ |

**分岐ごとのチャネル値:**

| 分岐 | `channel` の値 |
|---|---|
| メール | `email` |
| SMS | `sms` |
| Messenger | `messenger` |
| Instagram | `ig` |
| ライブチャット | `livechat` |

::: warning
**重要:** `channel` の値が完全に一致していることを確認してください。これらは大文字と小文字を区別します。
:::


### ステップ 6: 再入力を有効にする

ワークフロー設定で、**再入力を許可** が有効になっていることを確認してください。これが有効でないと、各連絡先からの最初のメッセージのみが転送されます。

---

## ワークフロー 2: Your AI Connector から GHL

このワークフローは Your AI Connector からの返信を受信し、適切なGHLチャネルを通じて顧客に送信します。

### ステップ 1: GHL でインバウンド Webhook を作成する

1. GHLで **Settings > Developers / API** に移動します。
2. **Create New Webhook**（または「Inbound Webhook」）をクリックします。
3. 「Messages」という名前を付けます。
4. 保存し、**Webhook URLをコピー**します。次のステップで使用します。

### ステップ 2: Your AI Connector の設定

1. Your AI Connector で、サイドバーの **Settings** をクリックします。
2. **Channels** の下にある **Channels** をクリックします。
3. ページの一番下にある **Custom channel** カードまでスクロールします。
4. 先ほどコピーしたGHLインバウンドWebhook URLを **Webhook URL** に貼り付け（パブリックなHTTPSアドレスである必要があります）、**Save** をクリックします。

> **これは Settings → Integrations → Webhooks ページではありません。** そのページはイベント通知用であり、異なるペイロードを送信します。GHLアウトバウンドリレーは、**Settings → Channels** の下にある **Custom channel** カードで設定します。

Your AI Connector は、連絡先にメッセージが送信されるたびに、自動的にGHLへ通知を送信するようになります。送信されるデータは以下の通りです：

```json
{
  "contactId": "NtL97bwnhITrfIq8lWFi",
  "messageId": "s28dtg13qNuhXLoKpcLs",
  "userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",
  "body": "Message content here",
  "toId": "qtpBsc6fiqkXTnSOeze3",
  "channel": "email"
}
```

> **ナビゲーションに関する注意:** ワークフロー1で使用するAPIキーと、ここで使用するCustom channelカードはそれぞれ別の場所にあります。キーは **Settings → Integrations → API Key** に、このリレーの設定は **Settings → Channels** の一番下にある **Custom channel** カードにあります。別の場所にある **Settings → Integrations → Webhooks** ページはイベント通知用であり、異なるペイロードを送信します。そちらが必要な場合は [Webhooks](webhooks.md) を参照してください。

### ステップ 3: 応答ワークフローを作成する

1. GHL で **Automation > Workflows** に移動します。
2. 「Send Message to Contact」という名前の新しいワークフローを作成します。
3. トリガーを **Inbound Webhook** に設定し、ステップ 1 で作成した Webhook を選択します。

### ステップ 4: 「Find Contact」アクションを追加する

1. **Find Contact** アクションを追加します。
2. 検索フィールドを **Contact ID** に設定します。
3. 値として `{{inboundWebhookRequest.toId}}` を使用します。

### ステップ 5: オプションのタグチェックを追加する

Your AI Connector からのメッセージを受信する連絡先を制限したい場合：

1. **Condition** アクションを追加します。
2. 連絡先に特定のタグが付いているかを確認します。
3. タグがない場合はワークフローを終了します (false 分岐に「Stop」アクションを追加します)。

### ステップ 6: チャネル分岐を追加する

`{{inboundWebhookRequest.channel}}` に基づいてメッセージをルーティングする **Condition**（条件）アクションを追加します。

| ブランチ | 条件 | アクション |
|---|---|---|
| ブランチ 1 | `email` と等しい | メールを送信 |
| ブランチ 2 | `sms` と等しい | SMSを送信 |
| ブランチ 3 | `messenger` と等しい | Facebookメッセージを送信 |
| ブランチ 4 | `ig` と等しい | Instagramメッセージを送信 |
| ブランチ 5 | `livechat` と等しい | チャットメッセージを送信 |

### ステップ 7: 各送信アクションの設定

各送信アクションで、メッセージ本文を以下のように設定します。

```
{{inboundWebhookRequest.body}}
```

### ステップ 8: 再入力を有効にする

ワークフロー1と同様に、ワークフロー設定で **Allow Re-entry**（再入力を許可）が有効になっていることを確認してください。

---

## 統合のテスト

### GHL から <span data-t="appName">Your AI Connector</span> のテスト（ワークフロー 1）

1. GHLの番号または接続済みチャネルにメッセージを送信します（例：自分宛てにSMSを送信）。
2. <span data-t="appName">Your AI Connector</span> を開き、**Chats** にメッセージが表示されていることを確認します。
3. チャネルラベル（SMS、メールなど）が正しいか確認します。
4. 設定した各チャネルで繰り返します。

### <span data-t="appName">Your AI Connector</span> から GHL のテスト（ワークフロー 2）

1. <span data-t="appName">Your AI Connector</span> で、連絡先に返信を送信します（手動、またはAIによる自動応答）。
2. GHLを開き、連絡先がメッセージを受信したことを確認します。
3. 正しいチャネルを通じて送信されたことを確認します。
4. メッセージの内容が一致していることを確認します。

---

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

| 問題 | 確認事項 |
|---|---|
| メッセージが <span data-t="appName">Your AI Connector</span> に届かない | Webhook URL内のAPIキーが正しいか確認してください。ワークフローのトリガーが起動しているか確認してください（GHLワークフローログ）。「Allow Re-entry（再入）」が有効になっていることを確認してください。 |
| メッセージがGHLに届かない | GHLインバウンドWebhook URLが、**Settings → Channels** の一番下にある **Custom channel** カードの **Webhook URL** に正しく貼り付けられているか確認してください（別の機能である Settings → Integrations → Webhooks ページではありません）。GHLインバウンドWebhookがアクティブであることを確認してください。GHLワークフロー実行ログを確認してください。 |
| GHLで連絡先が見つからない | Webhookデータ内の `toId` は、既存のGHL連絡先IDと一致している必要があります。両方のシステムに一致するIDを持つ連絡先が存在することを確認してください。 |
| 返信に誤ったチャンネルが使用される | 条件分岐内のチャンネル値を再確認してください。これらは完全に一致している必要があります: `email`, `sms`, `messenger`, `ig`, `livechat`。 |
| 最初のメッセージのみが転送される | 両方のワークフロー設定で **Allow Re-entry** を有効にしてください。 |

---

## 次のステップ

- [Webhook](webhooks.md) — 他の <span data-t="appName">Your AI Connector</span> イベント用にWebhookを設定します。
- [APIアクセス](api-access.md) — GHL以外のカスタム統合にAPIを使用します。
- [カスタムチャネル](../messaging-channels/custom-channels.md) — カスタムチャネルメッセージングの詳細を確認します。