## 提示

- `live-or-trading-module-only`
- `permission-dependent`


## 原型

```python
send_qywx(corp_id, secret, agent_id, info='', path='', toparty='', touser= '', totag= '')
```

## 释义

send_qywx 是 PTrade 中用于发送企业微信信息的接口。

研究：不支持；回测：不支持；模拟：官方目录未明确；实盘：支持。

## 参数

| 参数 | 是否必填 | 官方原始定义 |
|---|---:|---|
| `corp_id` | 是 | corp_id |
| `secret` | 是 | secret |
| `agent_id` | 是 | agent_id |
| `info` | 否 | info='' |
| `path` | 否 | path='' |
| `toparty` | 否 | toparty='' |
| `touser` | 否 | touser= '' |
| `totag` | 否 | totag= '' |

## 返回值

None

## 示例

```python
def initialize(context):

g.security = '600570.SS'

set_universe(g.security)

def handle_data(context, data):

#发送文字信息

send_qywx('wwxxxxxxxxxxxxf9', 'hixxxxxxxxxxxxxxxxxxxBX8', '10xxxx3', info='已触发委托买入', toparty='1|2')
```

## 详细说明

send_qywx(corp_id, secret, agent_id, info='', path='', toparty='', touser= '', totag= '')

### 使用场景

该函数仅在交易模块可用。

### 接口说明

该接口用于通过企业微信发送内容，使用方法请查看 企业微信功能使用手册。

### 注意事项

该接口需要服务端连通外网，是否开通由所在券商决定。

是否允许发送文件(即path参数)，由所在券商的配置管理决定。

企业微信不能同时发送文字和文件，当同时入参info和path的时候，默认发送文件。

企业微信接受到的文件为文件名而非文件路径。

2022年6月20日之后创建的应用由于需要配置企业可信ip(企业微信官方升级)导致企业微信功能不可用，该日期之前创建的应用仍可以正常使用。

### 参数详细说明

corp_id：企业ID，必填字段(str)；

secret：企业微信应用的密码，必填字段(str)；

agent_id：企业微信应用的ID，必填字段(str)；

info：发送内容，选填字段，默认空字符串(str)；

path：发送文件，选填字段，如:get_research_path() + 'stock.csv'，默认空字符串(str)；

toparty：发送对象为部门，选填字段，默认空字符串(str)，多个对象之间用 '|' 符号分割；

touser：发送内容为个人，选填字段，默认空字符串(str)，多个对象之间用 '|' 符号分割；

totag：发送内容为分组，选填字段，默认空字符串(str)，多个对象之间用 '|' 符号分割；

注意：toparty、touser、totag如果都不传入，接口默认发送至应用中设定的第一个toparty

### 返回值

None