dingtalk.oapi.im.chat.servicegroup.create (创建服务群)

创建一个服务群

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
title String 必须 XXX服务群
  • 最大长度:256
  • 群标题
    owner_userid String 必须 12345 群主在钉钉组织内的userid
    org_inner_group Boolean 可选 true/false
  • 默认值:false
  • 是否企业内部服务群
    group_uniq_id String 可选 abc1234 建群去重的业务id

    响应参数

    名称 类型 示例值 描述
    result ServiceGroupCreateResponse result 结果
    • └ url
    • String
    • https://xxx
    • 群链接
    • └ open_conversation_id
    • String
    • cidxxx
    • 开放的会话ID
    • └ chat_id
    • String
    • chatxxx
    • 开放的会话chatId
    errcode Number 0 错误代码
    errmsg String 成功 错误描述
    success Boolean true 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    8
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/im/chat/servicegroup/create");
    OapiImChatServicegroupCreateRequest req = new OapiImChatServicegroupCreateRequest();
    req.setTitle("XXX服务群");
    req.setOwnerUserid("12345");
    req.setOrgInnerGroup(true/false);
    req.setGroupUniqId("abc1234");
    OapiImChatServicegroupCreateResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    {
        "result":{
            "url":"https:\/\/xxx",
            "open_conversation_id":"cidxxx",
            "chat_id":"chatxxx"
        },
        "errcode":0,
        "errmsg":"成功",
        "success":true
    }

    异常示例

    • JSON示例
    1
    2
    3
    4
    {
        "errcode":88,
        "errmsg":"ding talk error"
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部