---
metadata:
  - name: generator
    content: Diplodoc Platform v5.61.0
alternate:
  - https://yandex.com/dev/telemost/doc/ru/conference-create.md
  - href: https://yandex.com/dev/telemost/doc/ru/conference-create.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/telemost/doc/ru/llms.txt
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/telemost/doc/ru/llms.txt

# Создание видеовстречи

Создает [видеовстречу]( https://yandex.ru/support/telemost-business/create.html ) или [трансляцию]( https://yandex.ru/support/telemost-business/broadcasting.html ) в Телемосте.

Чтобы выполнить запрос, приложению требуется разрешение `telemost-api:conferences.create`.

## Запрос

##POST##

```html
https://cloud-api.yandex.net/v1/telemost-api/conferences

```

### Заголовки

```plaintext
Authorization: OAuth <токен>
Content-Type: application/json
```

<!-- source: ru/_includes/request-conf-body-fields.md -->
### Тело (JSON)

```json
{
  "access_level": "string", //deprecated
  "waiting_room_level": "string",
  "live_stream": {
    "access_level": "string",
    "title": "string",
    "description": "string"
  },
  "cohosts": [
    {
      "email": "string"
    }
  ],
  "is_auto_summarization_enabled": true
}
```

### Поля

#|
|| **Имя параметра** | **Обязат.** | **Тип** | **Описание** | **Ограничения, значение по умолчанию** ||
|| `access_level` | Нет

Deprecated — используется для обратной совместимости | `string` | В предыдущих версиях использовался для настройки ограничения доступа к видеовстрече. Поле игнорируется, если передан параметр `waiting_room_level` | Основные используемые значения:
- `PUBLIC` — комната ожидания выключена, все пользователи смогут сразу присоединиться к встрече;
- `ORGANIZATION` — комната ожидания включена для внешних пользователей, к встрече сразу смогут присоединиться только пользователи с аккаунтами на домене организации;
- `UNKNOWN` — параметр для обеспечения обратной совместимости: все остальные значения поля обрабатываются как `UNKNOWN`. ||
|| `waiting_room_level` | Нет | `string` | Настройки комнаты ожидания для видеовстречи | Основные используемые значения:
- `PUBLIC` — комната ожидания выключена, пользователи смогут сразу присоединиться к встрече;
- `ORGANIZATION` — комната ожидания включена для внешних пользователей, к встрече сразу смогут присоединиться только пользователи с аккаунтами на домене организации;
- `ADMINS` — комната ожидания включена для всех пользователей, кроме организаторов и соорганизаторов встречи. ||
|| `live_stream` | Нет | `object` | Параметры трансляции | Если параметры не указаны, трансляция не создается или не изменяется. ||
|| `live_stream.`
`access_level` | Нет | `string` | Настройки ограничения доступа для трансляции | Основные используемые значения:
- `PUBLIC` — для всех пользователей;
- `ORGANIZATION` — только для сотрудников;
- `UNKNOWN` — добавлен для обеспечения обратной совместимости: все значения, которые добавятся в будущем, будут обрабатываться как `UNKNOWN`.||
|| `live_stream.`
`title` | Нет | `string` | Название трансляции, которое отображается на странице для зрителей | Максимальная длина 1024.||
|| `live_stream.`
`description` | Нет | `string` | Описание трансляции, которое отображается на странице для зрителей | Максимальная длина 2048.||
|| `cohosts` | Нет | `array` of `object`| Список соорганизаторов встречи | Максимальная длина 30 элементов.

Если параметр не указан или указан пустой список, встреча создается без соорганизаторов.||
|| `cohosts.email` | Нет | `string` | Адрес электронной почты соорганизатора | Соорганизатором встречи может быть только пользователь с аккаунтом на Яндексе.||
|| `is_auto_summarization_enabled` | Нет | `boolean` | Автоматический запуск конспектирования при старте встречи.

Включается при входе первого участника. Останавливается автоматически при выходе всех участников из встречи. ||
|#




<!-- endsource: ru/_includes/request-conf-body-fields.md -->

### Примеры

{% list tabs %}

- Видеовстреча без трансляции

  Видеовстреча для всех пользователей без трансляции.

  ```json
  {
    "waiting_room_level": "PUBLIC",
  }
  ```

- Видеовстреча с трансляцией

  Видеовстреча для сотрудников организации с трансляцией для всех пользователей.

  ```json
  {
    "waiting_room_level": "ADMINS",
    "live_stream": {
      "access_level": "PUBLIC",
      "title": "Example conference created via API",
      "description": "Some description of example conference created via API"
    }
  }
  ```

- Видеовстреча с соорганизаторами

  Видеовстреча с двумя соорганизаторами для всех пользователей без трансляции.

  ```json
  {
    "waiting_room_level": "PUBLIC",
    "cohosts": [
      {
        "email": "user1@yandex.ru"
      },
      {
        "email": "user2@org-domain.ru"
      }
    ]
  }
  ```

- Видеовстреча с автоматическим конспектированием

  Видеовстреча для сотрудников организации с автоматическим конспектированием. Функция включается при входе первого участника.

  ```json
  {
    "waiting_room_level": "ADMINS",
    "live_stream": {
      "access_level": "PUBLIC",
      "title": "Example conference created via API",
      "description": "Some description of example conference created via API"
    },
    "is_auto_summarization_enabled": true
  }
  ```

{% endlist %}

## Результат

### Успешный ответ

Результатом успешного запроса является ответ с кодом 201 и телом с JSON, где содержится информация о созданной видеовстрече.

`201 Created` — запрос выполнен успешно:

<!-- source: ru/_includes/respons-ok.md -->
  ```json
{
    "id": "string",
    "join_url": "string",
    "live_stream": {
        "watch_url": "string"
    }
}
  ```

#|
|| **Имя параметра** | **Тип** | **Описание** ||
|| `id` | `string` | Идентификатор видеовстречи ||
|| `join_url` | `string` | Ссылка для участников, по которой можно присоединения к видеовстрече ||
|| `live_stream` | `object` | Данные о трансляции. Если видеовстреча создана без трансляции, параметр отсутствует ||
|| `live_stream.`
`watch_url` | `string` | Ссылка для зрителей, по которой можно смотреть трансляцию ||
|#



<!-- endsource: ru/_includes/respons-ok.md -->

{% cut "Примеры" %}

{% list tabs %}

- Видеовстреча без трансляции

  ```json
  {
    "id": "12345678901234",
    "join_url": "https://telemost.yandex.ru/j/12345678901234"
  }
  ```

- Видеовстреча с трансляцией

  ```json
  {
    "id": "12345678901234",
    "join_url": "https://telemost.yandex.ru/j/12345678901234",
    "live_stream": {
      "watch_url": "https://telemost.yandex.ru/live/123456789abcdef0123456789abcdef0"
    }
  }
  ```

{% endlist %}

{% endcut %}

### Ответ с ошибкой

В случае ошибки возвращается сообщение следующего содержания:

<!-- source: ru/_includes/respons-err.md -->
  ```json
{
    "error": "string",
    "message": "string",
    "description": "string",
    "details": "object"
}
  ```

#|
|| **Имя параметра** | **Тип** | **Описание** ||
|| `error` | `string` | Код ошибки ||
|| `message` | `string` | Сообщение об ошибке ||
|| `description` | `object` | Техническое описание ошибки ||
|| `details` | `object` | [Опциональный параметр] Дополнительная информация об ошибке ||
|#



<!-- endsource: ru/_includes/respons-err.md -->

Ошибки могут быть со следующими HTTP-статусами:

- 402 Payment Required<br>
  * `{"error": "PaymentRequiredToUseLiveStreams"}` — трансляция не предусмотрена вашим тарифным планом.

- 403 Forbidden<br>
  * `{"error": "ApiRestrictedToOrganizations"}` — доступ запрещен, так как вы не являетесь пользователем Яндекс 360 для бизнеса или ваш аккаунт зарегистрирован не на домене организации.

- 404 Not Found<br>
  * `{"error": "NoSuchUserPrincipalsFound", "details": {"emails": "неверный_адрес1;неверный_адрес_;..."}}` —
  некоторые из переданных электронных адресов соорганизаторов не принадлежат пользователям с аккаунтами на Яндексе, некорректные адреса перечислены в поле `details.emails` через `;`.

- 4xx<br>
  * незадокументированные ошибки, например некорректный запрос, слишком большое количество запросов или проблемы с авторизацией.