使用聊天平台 API 附加代理文件

借助聊天平台 API 自定义应用,您可以设置一个工作流,让客服人员在聊天会话期间附加文件。

代理文件附件工作流程

以下是代理在聊天会话期间附加文件的流程。

  1. 代理在聊天会话期间附加文件。
  2. 您的 webhook 端点会收到 message_received 事件,其中包含附加文件的 media_id 值。如需了解详情,请参阅聊天 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 平台 (CCAI 平台) 主机

    • CHAT_ID:聊天 ID

    • MEDIA_ID:您要下载的文件的 ID。从 message_received 网络钩子事件中获取此信息。

    如果请求成功,则会返回附件文件。如需了解详情,请参阅 Chat 平台 API 指南

文件限制

以下是客服人员可以附加到聊天会话中的文件类型:

  • 图片:JPEG、JPG、PNG、GIF、TIFF、RAW、WebP

  • 视频:MP4、MOV、AVI、WMV、WebM

  • 音频:MP3、WAV

  • 文档:PDF、XML、XLS、PPT、CSV、TXT

文件大小上限为 100 MB。