发送名片消息

向好友或群聊发送微信名片。

接口地址： POST /sendNameCard

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 接收方 wcId 可以是好友微信 ID，也可以是群 ID。
• nameCardId 必须是要发送名片对应的微信 ID。
• 建议发送前确认当前微信实例具备查看或发送该名片的权限。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	接收方微信 ID 或群 ID
nameCardId	是	string	要发送的名片微信 ID

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data.type	int	类型
data.msgId	long	消息 ID
data.newMsgId	long	新消息 ID
data.createTime	long	发送时间戳（秒）
data.wcId	string	接收方 ID

请求示例

{
 "wId": "0000016e-abef-bb44-0002-dad3f6230dad",
 "wcId": "azhichao",
 "nameCardId": "wxid_uf44z2g3jge022"
}

成功响应

{
 "code": "1000",
 "message": "发送名片成功",
 "data": {
 "type": 42,
 "msgId": 0,
 "newMsgId": 6240562811972867706,
 "createTime": 1641457349,
 "wcId": "wxid_rfdfvhobjai8d"
 }
}

错误响应

{
 "message": "失败",
 "code": "1001",
 "data": null
}

使用建议

• 发送客户或员工名片前，建议在业务系统中校验 nameCardId 来源，避免误发。
• 群聊场景下名片会被所有群成员看到，建议对操作入口做权限控制。
• 发送成功后保存 msgId、newMsgId、createTime，便于后续撤回或追踪。