BotpressHITL統合
このインテグレーションにより、Botpress ボットをBrevoの会話プラットフォームと接続し、HITL（Human-in-the-Loop）セットアップを可能にします。これにより、Botpress ボットが最初のユーザーとの対話を処理し、必要に応じてBrevoの人間のエージェントにシームレスに会話をエスカレーションすることができます。
## 仕組み
ユーザーがBotpress ボットと対話すると、会話はBrevoの人間のエージェントに転送されます。エージェントは会話を引き継ぎ、パーソナライズされたサポートを提供することができます。Botpress ユーザーからのメッセージは、Brevoエージェントに転送されます。
## 主な制限事項
このインテグレーションをご利用の際は、以下の制限にご注意ください：
- メッセージの帰属:**Botpress ユーザーから Brevo エージェントに送信されたメッセージは、統合が設定されている Brevo エージェントアカウントから送信されたかのように表示されます。ただし、これらのメッセージを区別するために、メッセージの先頭にBotpress User:」が付けられます。例：`Botpress User: Hello, I need help with my order.`.
- ステータスの更新:**Botpress ユーザーは、エージェントの割り当てに関する通知やステータスの更新を自動的に受け取ることはありません（例：「エージェント John がチャットに参加しました」）。
## セットアップガイド
Botpress HITLインテグレーションを設定するには、以下が必要です：
1. 1. **Brevo API Key:**
- BrevoのAPIキーは、Brevoの公式ヘルプページの指示に従って作成・管理することができます：[APIキーの作成と管理](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **IPブロックを解除する。
Botpress Brevo間のシームレスな通信のためには、BrevoアカウントでIPブロックを解除する必要があります。
- Brevo IP Authorisation](https://app.brevo.com/security/authorised_ips)に移動し、Botpress 環境からのリクエストを許可するためにIPブロックが解除されていることを確認してください。
3. **BrevoエージェントID:**
- 統合でメッセージの送受信に使用するBrevoエージェントアカウントを指定する必要があります。
- Brevoエージェント設定ページに移動します：[Brevoエージェント設定](https://conversations-app.brevo.com/settings/agents)
- 統合に使用するエージェントを特定し、そのエージェントIDをコピーします。
Webhook 設定（必須）
BrevoからのイベントをBotpress 連携で受信するには、Brevoでwebhook 設定する必要があります：
1.1.Brevoダッシュボードの**Integrations > Webhooks**に移動します（[直接リンク](https://conversations-app.brevo.com/settings/integrations/webhooks)）。
2.Add newwebhookまたは既存のものを編集）をクリックします。
3.URL**フィールドに、Botpress Brevowebhook 入力します。例
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4.イベントタイプ**で、`conversationStarted`を選択します：
- conversationStarted`を選択します。
- conversationTranscript`（会話トランスクリプト
- conversationFragment`を選択する。
5.webhook有効にするには、**Save**をクリックします。
> 注意：*** URLがあなたのBotpress 統合のエンドポイントと一致し、すべての必要なイベントタイプが完全な機能のためにチェックされていることを確認してください。
これが設定されると、Botpress 統合はBrevoからリアルタイムのイベントを受信し、それに応じて処理できるようになります。
これらの詳細が確認できたら、インテグレーション固有のセットアップ手順に従って、Botpress 環境内でインテグレーションを設定することができます。
