Intercom HITL

  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 設定でデバッグロギングを有効にして、統合の問題をトラブルシュートしてください。