网易云信消息抄送php,消息功能-服务端API文档-IM即时通讯-网易云信开发文档

本文档详细介绍了网易云信的消息发送功能,包括普通消息、批量发送、自定义系统通知的发送,以及消息撤回、广播消息、文件上传、会话漫游删除等操作。支持多种消息类型如文本、图片、语音、视频等,并提供消息抄送、推送配置、反垃圾策略等高级特性。适用于需要实现即时通讯功能的开发者。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

消息功能

发送普通消息

请求说明

POST https://api.netease.im/nimserver/msg/sendMsg.action HTTP/1.1

Content-Type:application/x-www-form-urlencoded;charset=utf-8

请求中Headers的设置请参考接口概述

接口描述

给用户或者高级群发送普通消息,包括文本,图片,语音,视频和地理位置,具体消息参考下面描述

参数说明

参数类型必须说明

fromString是发送者accid,用户帐号,最大32字符,

必须保证一个APP内唯一

opeint是0:点对点个人消息,1:群消息(高级群),其他返回414

toString是ope==0是表示accid即用户id,ope==1表示tid即群id

typeint是0 表示文本消息,

1 表示图片,

2 表示语音,

3 表示视频,

4 表示地理位置信息,

6 表示文件,

10 表示提示消息,

100 自定义消息类型(特别注意,对于未对接易盾反垃圾功能的应用,该类型的消息不会提交反垃圾系统检测)

bodyString是最大长度5000字符,JSON格式。

具体请参考:

消息格式示例

antispamString否对于对接了易盾反垃圾功能的应用,本消息是否需要指定经由易盾检测的内容(antispamCustom)。

true或false, 默认false。

只对消息类型为:100 自定义消息类型 的消息生效。

antispamCustomString否在antispam参数为true时生效。

自定义的反垃圾检测内容, JSON格式,长度限制同body字段,不能超过5000字符,要求antispamCustom格式如下:

{"type":1,"data":"custom content"}

字段说明:

1. type: 1:文本,2:图片。

2. data: 文本内容or图片地址。

optionString否发消息时特殊指定的行为选项,JSON格式,可用于指定消息的漫游,存云端历史,发送方多端同步,推送,消息抄送等特殊行为;option中字段不填时表示默认值

,option示例:

{"push":false,"roam":true,"history":false,"sendersync":true,"route":false,"badge":false,"needPushNick":true}

字段说明:

1. roam: 该消息是否需要漫游,默认true(需要app开通漫游消息功能);

2. history: 该消息是否存云端历史,默认true;

3. sendersync: 该消息是否需要发送方多端同步,默认true;

4. push: 该消息是否需要APNS推送或安卓系统通知栏推送,默认true;

5. route: 该消息是否需要抄送第三方;默认true (需要app开通消息抄送功能);

6. badge:该消息是否需要计入到未读计数中,默认true;

7. needPushNick: 推送文案是否需要带上昵称,不设置该参数时默认true;

8. persistent: 是否需要存离线消息,不设置该参数时默认true;

9. sessionUpdate: 是否将本消息更新到会话列表服务里本会话的lastmsg,默认true。

pushcontentString否推送文案,最长500个字符。具体参见 推送配置参数详解。

payloadString否必须是JSON,不能超过2k字符。该参数与APNs推送的payload含义不同。具体参见 推送配置参数详解。

extString否开发者扩展字段,长度限制1024字符

forcepushlistString否发送群消息时的强推用户列表(云信demo中用于承载被@的成员),格式为JSONArray,如["accid1","accid2"]。若forcepushall为true,则forcepushlist为除发送者外的所有有效群成员

forcepushcontentString否发送群消息时,针对强推列表forcepushlist中的用户,强制推送的内容

forcepushallString否发送群消息时,强推列表是否为群里除发送者外的所有有效成员,true或false,默认为false

bidString否可选,反垃圾业务ID,实现“单条消息配置对应反垃圾”,若不填则使用原来的反垃圾配置

useYidunint否可选,单条消息是否使用易盾反垃圾,可选值为0。

0:(在开通易盾的情况下)不使用易盾反垃圾而是使用通用反垃圾,包括自定义消息。

若不填此字段,即在默认情况下,若应用开通了易盾反垃圾功能,则使用易盾反垃圾来进行垃圾消息的判断

yidunAntiCheatingString否可选,易盾反垃圾增强反作弊专属字段,限制json,长度限制1024字符(详见易盾反垃圾接口文档反垃圾防刷版专属字段)

markReadint否可选,群消息是否需要已读业务(仅对群消息有效),0:不需要,1:需要

checkFriendboolean否是否为好友关系才发送消息,默认否

注:使用该参数需要先开通功能服务

subTypeint否自定义消息子类型,大于0

msgSenderNoSenseint否发送方是否无感知。0-有感知,1-无感知。若无感知,则消息发送者无该消息的多端、漫游、历史记录等。

msgReceiverNoSenseint否接受方是否无感知。0-有感知,1-无感知。若无感知,则消息接收者者无该消息的多端、漫游、历史记录等

envString否所属环境,根据env可以配置不同的抄送地址

curl请求示例

curl -X POST -H "AppKey: go9dnk49bkd9jd9vmel1kglw0803mgq3" -H "Nonce: 4tgggergigwow323t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'from=zhangsan&ope=0&to=lisi&type=0&body={"msg":"hello"}' 'https://api.netease.im/nimserver/msg/sendMsg.action'

返回说明

http 响应:json

"Content-Type": "application/json; charset=utf-8"

{

"code":200,

"data":{

"msgid":1200510468189,

"timetag": 1545635366312,//消息发送的时间戳

"antispam":false

}

}

主要的返回码

200、403、414、416、431、500

批量发送点对点普通消息

请求说明

POST https://api.netease.im/nimserver/msg/sendBatchMsg.action HTTP/1.1

Content-Type:application/x-www-form-urlencoded;charset=utf-8

请求中Headers的设置请参考接口概述

接口描述

1.给用户发送点对点普通消息,包括文本,图片,语音,视频,地理位置和自定义消息。

2.最大限500人,只能针对个人,如果批量提供的帐号中有未注册的帐号,会提示并返回给用户。

3.此接口受频率控制,一个应用一分钟最多调用120次,超过会返回416状态码,并且被屏蔽一段时间;

具体消息参考下面描述。

参数说明

参数类型必须说明

fromAccidString是发送者accid,用户帐号,最大32字符,

必须保证一个APP内唯一

toAccidsString是["aaa","bbb"](JSONArray对应的accid,如果解析出错,会报414错误),限500人

typeint是0 表示文本消息,

1 表示图片,

2 表示语音,

3 表示视频,

4 表示地理位置信息,

6 表示文件,

10 表示提示消息,

100 自定义消息类型

bodyString是最大长度5000字符,JSON格式。

具体请参考:

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值