# 创建对讲分组

## 接口描述

创建一个对讲分组。对讲分组的概念与域名规则参见[遍历对讲分组](/voip/遍历对讲分组.md)。

分组数量受公司配额限制，达到上限后无法继续创建。

## 请求说明
| 接口ID | 协议 | 方法 | PATH |
| --- | --- | --- | --- |
| 97 | HTTPS | POST | /openapi/v1/voip/groups |

### PATH参数

无

### URL参数
| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| accesskey_id | string | 是 | 参见[签名认证](/签名认证.md) |
| expires | int | 是 | 参见[签名认证](/签名认证.md) |
| signature | string | 是 | 参见[签名认证](/签名认证.md) |

### HTTP请求头
| 名称 | 必填 | 说明 |
| --- | --- | --- |
| Content-Type | 是 | `application/json` |

### 请求参数

请求参数以Json格式放置于Body中，如下：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| tag | string | 是 | 分组标识，用于拼分组级 SIP 域名。规则：以小写字母或数字开头，只能包含小写字母、数字和连字符，长度 1-32 字符，不允许出现点号；创建后不可修改 |
| name | string | 是 | 分组名称，长度 1-64 字符 |

### 请求示例

```
POST https://open.vzicloud.com/openapi/v1/voip/groups?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json

{ "tag": "xiaoqu-a", "name": "小区A" }
```

## 返回说明

### 返回参数
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| id | int | 分组ID |
| tag | string | 分组标识 |
| name | string | 分组名称 |
| device_count | int | 分组下设备分机数量（新建恒为 0） |
| agent_count | int | 分组下坐席分机数量（新建恒为 0） |
| call_center_count | int | 分组下呼叫中心数量（新建恒为 0） |

**注：返回参数里可能还包含其他信息但未在上面的表格内列出，请勿使用！**

### 返回示例


```json
{
  "id": 12,
  "tag": "xiaoqu-a",
  "name": "小区A",
  "device_count": 0,
  "agent_count": 0,
  "call_center_count": 0
}
```