企业微信-群机器人接口配置说明

群机器人配置说明 - 文档 - 企业微信开发者中心

如何使用群机器人

  • 在终端某个群组添加机器人之后,创建者可以在机器人详情页看到该机器人特有的webhookurl。开发者可以按以下说明向这个地址发起HTTP POST 请求,即可实现给该群组发送消息。下面举个简单的例子.
    假设webhook是:https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa
特别特别要注意:一定要 保护好机器人的webhook地址,避免泄漏!不要分享到github、博客等可被公开查阅的地方,否则坏人就可以用你的机器人来发垃圾消息了。

以下是用curl工具往群组推送文本消息的示例(注意要将url替换成你的机器人webhook地址,content必须是utf8编码):

curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa' \
   -H 'Content-Type: application/json' \
   -d '
   {
    	"msgtype": "text",
    	"text": {
        	"content": "hello world"
    	}
   }'
  • 当前自定义机器人支持文本(text)、markdown(markdown)、图片(image)、图文(news)、文件(file)、语音(voice)、模板卡片(template_card)七种消息类型。
  • 机器人的text/markdown类型消息支持在content中使用<@userid>扩展语法来@群成员

消息类型及数据格式

文本类型

{
    "msgtype": "text",
    "text": {
        "content": "广州今日天气:29度,大部分多云,降雨概率:60%",
		"mentioned_list":["wangqing","@all"],
		"mentioned_mobile_list":["13800001111","@all"]
    }
}
参数是否必填说明
msgtype消息类型,此时固定为text
content文本内容,最长不超过2048个字节,必须是utf8编码
mentioned_listuserid的列表,提醒群中的指定成员(@某个成员),@all表示提醒所有人,如果开发者获取不到userid,可以使用mentioned_mobile_list
mentioned_mobile_list手机号列表,提醒手机号对应的群成员(@某个成员),@all表示提醒所有人

 

后续应用:

kimi.ai php-api 企业微信群机器人发信息-优快云博客 

前台用get方法接收参数,后台用post方法传递参数给企业微信接口-优快云博客

### 使用 Python 配置企业微信机器人 为了实现这一目标,首先需要创建 `config.ini` 文件来保存必要的配置信息。此文件应包含企业的唯一标识符以及用于获取访问令牌的秘密密钥。 #### 创建配置文件 ```ini [WECHAT_BOT] corpId=【企业ID】 corpSecret=【应用密钥】 ``` 接着,在 Python 中读取这些设置并请求 `access_token` 是至关重要的一步。这可以通过发送 HTTP GET 请求到指定 URL 来完成,该 URL 结合了从配置文件中提取的企业 ID 和应用程序秘密[^1]。 #### 获取 Access Token ```python import requests from configparser import ConfigParser def get_access_token(): config = ConfigParser() config.read('config.ini') corp_id = config['WECHAT_BOT']['corpId'] secret = config['WECHAT_BOT']['corpSecret'] url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corp_id}&corpsecret={secret}" response = requests.get(url).json() if 'errcode' not in response or response['errcode'] != 0: raise Exception(f"Failed to fetch token, error code {response['errcode']}") return response["access_token"] ``` 一旦获得了有效的 `access_token`,就可以利用这个令牌向特定的消息接收者发送消息。对于聊中的自动化回复功能,则需监听来自用户的输入,并根据预定义规则作出响应[^4]。 #### 发送消息至聊 ```python def send_message_to_chat(access_token, chatid, content): message_url = "https://qyapi.weixin.qq.com/cgi-bin/appchat/send" params = {"access_token": access_token} data = { "touser": "@all", # 或者具体成员账号列表 "toparty": "", # 如果是部门则填写部门ID "totag": "", "msgtype": "text", "agentid": 1, "text": { "content": content }, "safe": 0, "enable_duplicate_check": 0, "duplicate_check_interval": 1800 } resp = requests.post(message_url, json=data, params=params) result = resp.json() if result['errmsg']!='ok': print("Error:",result) ``` 上述代码展示了如何构建一个简单的接口以与企业微信服务器交互,从而控制机器人的行为。需要注意的是实际部署时应当考虑安全性措施如环境变量存储敏感信息而非硬编码于源码内;另外还需遵循官方API指南确保合法合规操作。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值