チャット プラットフォーム 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

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

    • YOUR_CCAAS_HOST: Contact Center AI Platform（CCAI Platform）ホスト

    • CHAT_ID: チャット ID

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

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

ファイルの制限事項

エージェントがチャット セッションに添付できるファイル形式は次のとおりです。

  • 画像: JPEG、JPG、PNG、GIF、TIFF、RAW、WebP

  • 動画: MP4、MOV、AVI、WMV、WebM

  • 音声: MP3、WAV

  • ドキュメント: PDF、XML、XLS、PPT、CSV、TXT

ファイルサイズの上限は 100 MB です。