TIP

• 1.5 消息
  • 1.5.1 推送消息给用户

1.5 消息

1.5.1 推送消息给用户

第三方应用可以使用此接口给授权用户推送消息。第三方服务商给用户推送消息，用户可以在APP端接收到消息。

请求方式： POST（HTTPS）
请求地址： https://sso.qince.com/service/oauth/app/message/send?access_token=2019040189580858920907506625723500936366986112&msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359
请求示例：

{
  "msgtype": "card",
  "emp_id": [
    "7089416178531804546",
    "7089416178531804547"
  ],
  "text": {
    "content": "这是一条卡片消息",
    "url": "https://www.qince.com"
  }
}

参数说明：

参数	是否必须	说明
access_token	是	应用授权AccessToken，生成方法详见 1.1.1 应用获取AccessToken (opens new window)
msg_signature	是	请求数据签名，生成方法详见 3.3.1 数据签名生成方法 (opens new window)
timestamp	是	请求时间戳，如：1503276678552
nonce	是	随机字符串，最长为128字节
msgtype	是	消息类型。text：文本消息，card：卡片消息(带详情链接)
emp_id	否	消息接收员工ID和linkman_id至少传一个，JSONArray数组
linkman_id	否	消息接收客户联系人ID和emp_id至少传一个，JSONArray数组
content	是	消息内容
url	否	点击消息链接URL

响应示例：

{
  "return_code": 0,
  "return_msg": "success"
}

参数说明：

参数	说明
return_code	响应码。0：成功 1：失败
return_msg	对返回码的文本描述内容