企业微信之发送应用消息案例

本文详细介绍了如何进行企业微信应用消息的发送,包括在企业微信官网注册、获取AgentId、CropID和Secret,以及如何调用API接口发送消息。强调了Secret的安全处理和接口参数的设置,提醒注意HTTPS的使用和必要参数设置。

企业微信消息发送开发步骤:

1、到企业微信官网注册企业用户

企业微信, 找到“立即注册”。

2、下载企业微信APP到手机

3、找到关键信息,AgentId、企业ID(CropID)、秘钥(Secret)

① AgentId,到“企业微信” -> "应用管理"->"自建"一个自己的要接受信息的应用 ->最上面会有“AgentId”

②CropID,到“企业微信” -> “我的企业” -> 最下面“企业ID” 或者 手机上的企业微信APP ->“工作台” -> “管理企业” -> “企业信息” -> “企业ID”

③ Secret, 到“企业微信” -> "应用管理" -> 找到自己创建的“自建应用” -> 在AgentId下面既是“Secret” -> 点击“查看” -> 会把Secret发送到手机“企业微信APP”里,查看即可。定期会失效,需要重新操作此步骤。

以上三个重要数据获得后,就可以调用“企业微信”官网提供的开发者指南编写即可

https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

这个是请求接口。

大家可以访问“

### 如何通过企业微信 API 发送单聊消息 #### 1. 准备工作 在使用企业微信 API 进行开发前,需完成以下准备工作: - **注册企业微信开发者账号**:确保已拥有企业微信管理员权限,并开通了开发者模式。 - **获取 Access Token**:Access Token 是调用企业微信 API 的必要凭证,可以通过 `GET` 请求 `/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET` 接口获取[^1]。 ```bash https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=YOUR_CORP_ID&corpsecret=YOUR_APP_SECRET ``` 返回数据结构如下: ```json { "errcode": 0, "errmsg": "ok", "access_token": "ACCESS_TOKEN", "expires_in": 7200 } ``` #### 2. 单聊消息发送接口 企业微信提供了专门用于发送单聊消息的 API。以下是具体参数说明: ##### 请求地址 ```bash POST https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN ``` ##### 参数说明 | 字段 | 类型 | 是否必填 | 描述 | |--------------|--------|----------|----------------------------------------------------------------------| | touser | String | 是 | 接收者 UserID | | msgtype | String | 是 | 消息类型 (text, image, voice, video, file, textcard, news, mpnews) | | agentid | int | 是 | 应用 ID | | content | String | 否 | 文本消息内容 | 对于不同类型的单聊消息,请求体中的字段可能有所不同。例如,发送文本消息时,JSON 数据格式如下所示: ```json { "touser": "USER_ID", "msgtype": "text", "agentid": YOUR_AGENT_ID, "text": { "content": "你好,这是一条测试消息" }, "safe": 0 } ``` 其中: - `touser`: 用户唯一标识符(UserID)。 - `msgtype`: 指定为 `text` 表示发送的是文本消息。 - `agentid`: 自定义应用应用 ID。 - `text.content`: 实际要发送消息内容。 - `safe`: 安全设置标志位,默认值为 0;如果设为 1,则表示该消息会被加密传输。 #### 3. 示例代码 下面是一个基于 Python 的简单实现案例,展示如何利用企业微信 API 发送一条文本形式的单聊消息给特定用户。 ```python import requests import json def get_access_token(corpid, corpsecret): url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpid}&corpsecret={corpsecret}" response = requests.get(url).json() return response['access_token'] def send_message(access_token, user_id, message_content, agent_id): url = f'https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}' payload = { 'touser': user_id, 'msgtype': 'text', 'agentid': agent_id, 'text': {'content': message_content}, 'safe': 0 } headers = {'Content-Type': 'application/json'} response = requests.post(url, data=json.dumps(payload), headers=headers) return response.json() if __name__ == "__main__": corpid = "your_corp_id_here" # 替换为企业微信号CorpId corpsecret = "your_app_secret_here" # 替换为应用SecretKey access_token = get_access_token(corpid, corpsecret) user_id = "target_user_id" # 替换为目标用户的UserId message_content = "这是来自Python脚本的一条测试消息!" agent_id = 1000002 # 替换为你自己的AgentId result = send_message(access_token, user_id, message_content, agent_id) print(result) ``` #### 4. 错误处理机制 当调用失败时,通常会收到错误码以及对应的提示信息。常见的错误原因包括但不限于: - Access Token 失效或非法; - 用户不存在或者未授权访问目标资源; - 超过每日限额等限制条件。 更多关于错误码及其含义可以查阅官方文档[^1]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值