Intercom HITLインテグレーション この統合により、Botpress Intercom HITL(Human in the Loop)プロバイダとして使用することができます。ボットからのメッセージはIntercom表示され、エージェントの応答はボットに返信されます。 ## 機能 Botpress Intercom シームレスな統合 - リアルタイムメッセージ同期 - テキストメッセージのサポート - 自動会話セッション管理 Webhookイベント処理 - エージェントの割り当てと会話管理 ## コンフィギュレーション 統合には以下の設定が必要です: - accessToken`:あなたのIntercom アクセストークン (API 認証に必要) ##Botpress 統合のためのIntercom アプリのセットアップ このガイドでは、Botpress チャットボットとの統合を可能にするためのIntercom のセットアップと設定について説明します。 ### ステップバイステップの手順 #### 1.Intercom アプリを作成する *intercomintercom にアクセスします。 *Intercom アカウントにサインインします。 * 開発者hub **Apps** に移動します。 * をクリックします。 * アプリ名を入力(例:Botpress HITL Integration") * アプリを作成」をクリックします。 #### 2.アクセストークンをコピー * アプリのダッシュボードで、**Authentication**に移動します。 * アクセストークンのセクションに表示されている **Access Token** をコピーします。 * このアクセストークンを**Botpress Intercom インテグレーション設定**に貼り付けます。 #### 3.ウェブフックの設定 ##### a. 会話Webhook * アプリダッシュボードの **Webhooks** に移動します。 Webhookクリックします。 *Webhook URL** をあなたのBotpress Intercom インテグレーションwebhook URL** に設定します。 **Subscribe to only these events:** * `conversation.admin.assigned` * `conversation.admin.assigned` * `conversation.admin.closed` * `conversation.admin.closed` * `conversation.admin.replied` * `conversation.admin.replied` Webhookクリックします。 ###Botpress 必須設定のまとめ **Access Token**:Intercom 認証より Webhook URL**:Botpress 提供Botpress ## 利用方法 1.Intercom 統合を設定します。 2.startHitl` アクションを使用して会話セッションを開始する。 3.ボットからのメッセージがIntercom 会話に表示されます。 4.Intercom 内のエージェントの応答がボットに返信されます。 5.会話の状態は、Botpress Intercom 間で自動的に管理されます。Intercom > 注意:** HITLセッションを開始する際、ユーザーのメールがIntercomコンタクトとして存在しない場合、新しいコンタクトが自動的に作成されます。既にメールが存在する場合は、既存のコンタクトがHITL処理に使用されます。 ## サポート サポートについては、Botpress チームにお問い合わせいただくか、Intercom API documentation]intercom をご参照ください。 ## トラブルシューティング ### よくある問題 1.Webhook イベントを受信しない:webhook URLが一般に公開され、適切に設定されていることを確認してください。 2.**認証エラーアクセストークンが正しく、必要な権限を持っていることを確認してください。 3.**メッセージが同期されない:会話が正しく作成され、Intercom コンタクトが存在することを確認してください。Intercom ### デバッグモード Botpress 設定でデバッグロギングを有効にして、統合の問題をトラブルシュートしてください。