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

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

代理文件附件工作流

以下是客服人员在聊天会话期间附加文件的操作流程。

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

    • CHAT_ID:对话 ID

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

    • MEDIA_TYPE:要下载的文件类型。photo、video、audio 或 document 之一。

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