微信客服:消息接口接入微信

  • 功能简介
  • 使用场景
  • 功能说明

一、功能简介

当微信开发者后台绑定其他开发者的URL和Token时,如果想同时使用Udesk服务可以通过一个服务器与Udesk消息接口对接对接来实现。

通过Udesk消息接口对接服务器,消息的接收和发送均走服务器。(其中为了微信做了特别的优化,通过获得token可以直接生成符合微信规范的图片类消息无需服务器再上传到微信)

二、使用场景

  • 企业公众号已经绑定了其他第三方系统,此时需要接入Udesk客服系统

三、功能说明

1. 进入配置界面

管理员登录Udeks,进入【管理中心-渠道管理-即时通讯】界面,选择“消息接口接入”页面

2. 测试接收消息通道是否正常

http://xxxx .udesk.cn/spa1/im_callback/test?number=13574221234&email=894733082@qq.com&timestamp=20151124141451&sign=07131700A29AD987F5D9F0463CE7EFC7

测试接口是否畅通

传入参数

number=13574221234&email=894733082@qq.com&timestamp=20151124141451&sign=07131700A29AD987F5D9F0463CE7EFC7

参数

描述

number

电话号码

email

邮箱

timestamp

时间戳

sign

按前面几个参数生成的md5 的结果

Sign 生成方式

返回参数

{success: false, msg: "请传递验证参数"}

参数

描述

success

True/false

msg

string格式消息

3. 接收文本消息

http://xxxx.udesk.cn/spa1/im_callback?number=13574221234&email=894733082@qq.com&timestamp=20151124141451&sign=07131700A29AD987F5D9F0463CE7EFC7

接收消息接口  post 方式

<xml>

  <FromUserName>openid</FromUserName>

  <Number>phone number</Number>

  <Email>894733082@qq.com</Email>

  <Content>this is a test</Content>

  <CreateTime>1548348776</CreateTime>

  <MsgType>text</MsgType>

  <MsgId>1548348777</MsgId>

</xml>

参数

描述

FromUserName

发送方帐号(一个OpenID)

Number

客户手机号或电话

Email

客户邮箱

Content

消息内容

CreateTime

消息创建时间 (整型)

MsgType

text

MsgId

消息id,64位整型

4. 接收图片消息

http://xxxx.udeskdog.com/spa1/im_callback?number=13574221234&email=894733082@qq.com&timestamp=20151124141451&sign=07131700A29AD987F5D9F0463CE7EFC7

接收消息接口  post 方式

<xml>

 <FromUserName><![CDATA[fromUser]]></FromUserName>

 <Number>phone number</Number>

 <Email>894733082@qq.com</Email>

 <CreateTime>1348831860</CreateTime>

 <MsgType><![CDATA[image]]></MsgType>

 <PicUrl><![CDATA[this is a url]]></PicUrl>

 <MediaId><![CDATA[media_id]]></MediaId>

 <MsgId>1234567890123456</MsgId>

 </xml>

注意xml中的Email和Number不能为空

参数

描述

FromUserName

发送方帐号(一个OpenID)

Number

客户手机号或电话

Email

客户邮箱

CreateTime

消息创建时间 (整型)

MsgType

image

PicUrl

图片链接

MediaId

图片消息媒体id,可以调用多媒体文件下载接口拉取数据。

MsgId

消息id,64位整型

5. 接收语音消息

http://xxxx.udesk.cn/spa1/im_callback?number=13574221234&email=894733082@qq.com&timestamp=20151124141451&sign=07131700A29AD987F5D9F0463CE7EFC7

接收消息接口  post 方式

<xml>

 <FromUserName><![CDATA[fromUser]]></FromUserName>

 <Number>phone number</Number>

 <Email>894733082@qq.com</Email>

 <CreateTime>1357290913</CreateTime>

 <MsgType><![CDATA[voice]]></MsgType>

 <MediaId><![CDATA[media_id]]></MediaId>

 <Format><![CDATA[Format]]></Format>

 <MsgId>1234567890123456</MsgId>

</xml>

参数

描述

FromUserName

发送方帐号(一个OpenID)

Number

客户手机号或电话

Email

客户邮箱

CreateTime

消息创建时间 (整型)

MsgType

语音为voice

MediaId

图片消息媒体id,可以调用多媒体文件下载接口拉取数据。

Format

语音格式,amr

MsgId

消息id,64位整型

 

6. 接收图文消息(用于发送知识库富文本问题回答)

{
  "status": "chatting",
  "turn": 0,
  "agent_name": "Tom",
  "msg": {
    "touser": "oImr8t02SskaichIIPAT8TvVtzWM",
    "msgtype": "rich",
    "text": {
      "articles": [
        {
          "title": "富文本",
          "description": "",
          "url": "http://reocar.udeskmonkey.com/question/9",
          "picurl": "https://qn-public.udesk.cn/O-iTn7wSB8uwTijG_nEtsxPkccxv2K_uYeuhrbIr-AW4bDWU8WdhEXezFu3K6z9V-1485137896.jpg"
        }
      ]
    }
  },
  "kw_on": false,
  "kw_on2": false,
  "kw_msg": ""
}
 

参数

描述

title

图文消息标题

description

图文消息描述

url

点击图文消息跳转链接

picurl

图片链接

 

 

7. 接收消息时的Response 结果

参数

描述

status

客服状态,queuing/chatting/offline/unknown( 排队 / 聊天 / 离线 / 未知错误 )

turn

排队在第几位

agent_name

客服名称

msg

string 格式消息

消息推送

    推送地址配置方法:

    在【设置中心-即时通讯-消息接口接入】页面的推送地址框输入推送URL即可。

  • 推送文本格式消息

{status: 'chatting',

         turn: 0,

         agent_name: 'Tom',

         msg: {

               touser: customer_weixin_openid,

               msgtype: ‘text’,

               text: {content: "您好,客服 Tom 在线为您服务" }

          },

        kw_on:  enabled,

        kw_on2:  enabled,

        kw_msg: '' }

参数

描述

status

客服状态,queuing/chatting/offline/unknown( 排队 / 聊天 / 离线 / 未知错误 )

turn

排队在第几位

agent_name

客服名称

msg

JSON 格式消息

kw_on

忙碌状态,关键字是否启用 true/false

kw_on2

离线状态,关键字是否启用 true/false

kw_msg

关键字匹配回复

JSON 格式msg消息说明

参数

描述

touser

客户微信id

msgtype

消息类型( text/ image )

text

文本类型回复: {content: "您好,客服 Tom 在线为您服务" }

  • 推送图片格式消息

{status: 'chatting',

         turn: 0,

         agent_name: 'Tom',

         msg: {

               touser: customer_weixin_openid,

               msgtype: 'image',

               image: {media_id: 123432443 }

          },

        kw_on:  enabled,

        kw_on2:  enabled,

        kw_msg: '' }

参数

描述

status

客服状态,queuing/chatting/offline/unknown( 排队 / 聊天 / 离线 / 未知错误 )

turn

排队在第几位

agent_name

客服名称

msg

JSON 格式消息

kw_on

忙碌状态,关键字是否启用 true/false

kw_on2

离线状态,关键字是否启用 true/false

kw_msg

关键字匹配回复

JSON 格式msg消息说明

参数

描述

touser

客户微信id

msgtype

消息类型image

image

图片类型回复: {media_id: 123432443 }

 

8. 获取Token

  • 请求url

http://xxxxxx.com/getAccessToken?from=udesk&timestamp=12124234&sign=133d74d79aef117690f431f81d8df406

 

       参数说明:

   

  • 返回json结果:

返回格式: 

{

    error_code: 0, 

    error_msg: "SUCCESS", 

    data: 
{
              token: "rg9noa9Z9AqovM1bTJX_-5VUH9PCBlkQ5u91nEHJVJcu2fN"
              } 


 

参数说明:

error_code:  值为0表示成功,其他值为失败,其中2表示验证通过,但是获取token失败

error_msg:   返回的错误提示

data         包含token,即微信的access_token 值

 

  • 注意事项

1.Token的状态由你方管理,要保证Udesk计时渠道的token是有效的。

2.Udesk不保存token值,不保存token状态。

 

Udesk官方微信公众号

Udesk智能客服系统,用一个通用的平台连接电话、在线客服、手机APP、微信、微博、短信、邮箱、web等所有渠道。包括五大核心功能:呼叫中心、在线客服、智能机器人、工单系统、移动客服。是星巴克、海底捞、迅雷、每日优鲜等20多个行业,数万家企业的选择。

微信扫一扫,关注Udesk官方微信公众号,获取精品电子书

《中小企业CEO必须知道的客服知识》、《客户自助帮助中心搭建指南》、 《如何提升客户服务绩效指标》《创业公司客户服务指南》、《客户服务投资回报计算表》、《不同年龄客户的服务策略》

评论

阅读量:313
  • 头像
    814630271

  • 头像
    管理员_(上海孕贝网络有限公司_sameboy)

登录 添加您的评论。