Your AI Connector Docs

GoHighLevel (GHL) 連携

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

別のCRMを使用していますか？Your AI Connectorと連携するために専用の画面は必要ありません。カスタム関数、API、およびWebhookについては、リストにないツールの接続を参照してください。

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

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

前提条件

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

仕組み

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

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

このワークフローは、GHLからの着信メッセージを Your AI Connector に転送します。

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

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

ステップ 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

重要: 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へ通知を送信するようになります。送信されるデータは以下の通りです：

{
  "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 を参照してください。

ステップ 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 から Your AI Connector のテスト（ワークフロー 1）

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

Your AI Connector から GHL のテスト（ワークフロー 2）

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

トラブルシューティング

問題 確認事項
メッセージが Your AI Connector に届かない 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 — 他の Your AI Connector イベント用にWebhookを設定します。
  • APIアクセス — GHL以外のカスタム統合にAPIを使用します。
  • カスタムチャネル — カスタムチャネルメッセージングの詳細を確認します。