チャット プラットフォーム API を使用したエージェントのファイル添付

チャット プラットフォーム API カスタムアプリを使用すると、チャット セッション中にエージェントがファイルを添付できるワークフローを設定できます。

エージェントのファイル添付ワークフロー

チャット セッション中にエージェントがファイルを添付するワークフローは次のとおりです。

  1. エージェントがチャット セッション中にファイルを添付します。
  2. Webhook エンドポイントは、添付ファイルの media_id 値を含む message_received イベントを受信します。詳細については、チャット API プラットフォームの Webhook をご覧ください。
  3. 次のエンドポイントに GET リクエストを送信して、添付ファイルを取得します。このとき、前の手順で取得した media_id 値を指定します。基本認証を使用して認証します。

    https://YOUR_CCAAS_HOST/apps/api/v1/chats/CHAT_ID/media?media_id=MEDIA_ID&media_type=MEDIA_TYPE
    

    次のように置き換えます。

    • YOUR_CCAAS_HOST: コンタクト センター AI プラットフォーム(CCAI Platform)ホスト

    • CHAT_ID: チャット ID

    • MEDIA_ID: ダウンロードするファイルの ID。これは message_received Webhook イベントから取得します。

    • MEDIA_TYPE: ダウンロードするファイルの種類。photo、video、audio、document のいずれかです。

    リクエストが成功すると、添付ファイルが返されます。詳細については、Chat プラットフォーム API ガイドをご覧ください。