更新时间:2025-11-13 GMT+08:00

发送消息

接口功能

用户给座席发送信息

使用说明

  • 前提条件

    正确创建web渠道配置。

接口原型

表1 接口原型说明

请求方法

POST

请求URL

https://ip:port/service-cloud/rest/webadapter/v1/webadapterfacade/sendMessageForWebChannel

其中,ip:port为对外暴露的nslb的ip和port

表2 请求Headers参数说明

参数名称

选取原则

参数类型

默认值

说明

Content-Type

必选

String

固定填 application/json; charset=UTF-8。

Cookie

必选

String

集成页面的时候,ccmessaging通过请求响应,将ccmessaging-token写到集成页面浏览器的Cookie中。单独调用时需确保请求头的Cookie中含有ccmessaging-token=xxx,xxx为ccmessaging-token值。

请求参数

参数名称

选取原则

参数类型

说明

controlType

必选

String

消息控制类型:CONNECT,DISCONNECT,CHAT,TRANS2AGENT

mediaType

必选

String

多媒体类型:TEXT,IMAGE,VIDEO,AUDIO

content

必选

String

消息内容

userAgent

必选

String

用户环境信息

响应参数

参数名称

选取原则

参数类型

说明

resultCode

必选

String

接口响应码,0:成功

resultDesc

必选

String

接口描述

接口示例

  • 请求示例
    POST /service-cloud/rest/webadapter/v1/webadapterfacade/sendMessageForWebChannel
    
    host: 10.10.10.2:18446
    connection: Keep-Alive
    x-forwarded-for: 10.10.10.3, 10.10.10.4
    x-real-ip: 10.10.10.5
    content-length: 401
    remote-host: 10.10.10.6
    user-agent: java/socket
    content-type: application/json; charset=utf-8
    cookie: JSESSION*****#*#*****3
    ccmessaging-token:********
    accept: */*
    
    {"controlType":"CONNECT","mediaType":"TEXT","content":"","userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36"}
  • 响应示例
    {"resultCode":"xxx","resultDesc":"xxxx"}