创建预约会议

POST

http://127.0.0.1/cgi-bin/meeting/create

第三方应用开发/效率工具/会议

最后修改时间：2022-08-30 03:03:37

责任人：未设置

权限说明：发起人和企业内部参与人必须在应用可见范围内，「会议」应用默认全员可见发起人需要与外部联系人有好友关系系统应用「会议」默认可使用会议接口自建应用需要配置在“可调用接口的应用”列表第三方服务商创建应用的时候，需要开启“会议接口权限”

文档ID: 25245
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93627
https://open.work.weixin.qq.com/api/doc/90001/90143/93706

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

agentid

integer <int32>

可选

授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数

meeting_start

integer <int32>

必需

会议开始时间的unix时间戳。需大于当前时间

remind_time

integer <int32>

可选

指定会议开始前多久提醒用户，相对于meeting_start前的秒数，默认为0

attendees

object

可选

参与会议的成员，与会人员最多299，任何userid，external_userid和device_sn不合法，直接报错

external_userid

array[string]

可选

device_sn

array[string]

可选

userid

array[string]

可选

creator_userid

string

必需

会议发起者的userId

description

string

可选

会议的描述，最多支持500个字节或者utf8字符

meeting_duration

integer <int32>

必需

会议持续时间单位秒，最小300秒

title

string

必需

会议的标题，最多支持40个字节或者20个utf8字符

type

integer <int32>

必需

会议的类型，1：表示视频会议，2：表示语音会议

示例

{
  "creator_userid": "zhangsan",
  "title": "新建会议",
  "meeting_start": 1600000000,
  "meeting_duration": 3600,
  "description": "新建会议描述",
  "type": 1,
  "remind_time": 60,
  "agentid": 1000014,
  "attendees": {
    "userid": [
      "lisi",
      "wangwu"
    ],
    "external_userid": [
      "woabc",
      "woced"
    ],
    "device_sn": [
      "devsn1",
      "devsn2"
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/meeting/create?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "creator_userid": "zhangsan",
    "title": "新建会议",
    "meeting_start": 1600000000,
    "meeting_duration": 3600,
    "description": "新建会议描述",
    "type": 1,
    "remind_time": 60,
    "agentid": 1000014,
    "attendees": {
        "userid": [
            "lisi",
            "wangwu"
        ],
        "external_userid": [
            "woabc",
            "woced"
        ],
        "device_sn": [
            "devsn1",
            "devsn2"
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

meetingid

string

可选

会议id，通过此id可调用“进入会议”接口(包括小程序接口和JS-SDK接口)，以实现主持人到点后的开始会议操作，以及参会人进入会议详情参加会议

示例

{
  "errcode": 0,
  "errmsg": "string",
  "meetingid": "string"
}

日程接口获取日历下的日程列表

修改预约会议