# 发送事件

**接口说明**

第三方系统向开言发送事先已经注册的事件，未注册请先填表注册：[注册表单链接](https://doc.weixin.qq.com/smartsheet/form/1_wpJawBCQAAhCf5ayp_YgvDUSyb9CdTig_fe3639)；

**接口信息**

```
POST https://qw-openapi-tx.dustess.com/ai/v1/agent/sendOpenapiEventCode?accessToken=

Content-Type: application/json
```


**请求参数**

| 请求参数名 | 类型    | 说明 | 是否必须 |
| ---------- | ------- | ------------ | -------- |
| eventID     | `string` | 本次请求请求的唯一id| true     |
| eventCode   | `string` | 预先注册的事件编码| true|
| bizIDType   | `string` | 业务主键的类型，暂只支持传递"chatID"固定值即可| true|
| bizID   | `string` | 业务主键对应的值，chatID的值| true|
| payload   | `string` | 预先注册的事件内容的json字符串| true|

**请求参数示例**
`json` - Request-Example:

```json
{
    "eventID": "", // 唯一请求id
    "eventCode": "", // 事件编码
    "bizIDType": "", // 本期仅支持 "chatID"
    "bizID": "", // 实际的chatID
    "payload": "" // json字符串
}
```

**成功响应**

| 响应参数名           | 类型     | 说明                         |
| -------------------- | -------- | ---------------------------- |
| code                 | `int32`  | 响应码                       |
| msg                  | `string` | 消息提示                     |
| success              | `string` | 是否成功请求                 |
| traceId              | `string` | 请求链路id                   |
| data | `object` | {}             |

**成功响应示例**

```json
{
    "code": 0,
    "msg": "success",
    "success": true,
    "data": {},
    "traceId": "1601ca8f-1ee0-9725-81ba-d49016bc1a34"
}
```

**错误响应示例**

```json
{
    "code": 20171204,
    "msg": "参数不能为空",
    "success": false,
    "data": {},
    "traceId": "88146ad5-ac5f-9758-9ebb-0f13eb8ae973"
}
```