# Действия оператора и своя пауза

Действия над диалогом Открытой линии от имени сотрудника, к которому привязан ключ: пропустить диалог, передать его, пометить клиента спамером, завершить диалог другого оператора. Здесь же — чтение, включение и выключение своей паузы оператора.

Битрикс24 API: `imopenlines.operator.*`
Скоуп: `imopenlines`

## От чьего имени выполняется действие

Параметра «сотрудник» у этих методов нет. Действие и пауза относятся к сотруднику, от имени которого идёт вызов:

| Авторизация | Сотрудник |
|---|---|
| Личный ключ (`X-Api-Key: YOUR_API_KEY`) | Владелец ключа |
| OAuth-приложение (`X-Api-Key: YOUR_APP_KEY` + `Authorization: Bearer USER_SESSION_TOKEN`) | Пользователь, чья сессия передана в `Authorization` |

Права на действие проверяются по этому сотруднику. Все методы, кроме чтения паузы, требуют ключа с разрешённой записью.

## Идентификатор чата

Методы принимают `chatId` — числовой идентификатор чата Открытой линии, например `5255`. Это не `dialogId` вида `chat5255` и не `sessionId`. Один чат проходит через несколько сессий, и действие применяется к текущей сессии чата.

Где взять `chatId`:

- Поле `chatId` в ответе [`POST /v1/openlines/sessions/search`](/docs/openlines/sessions/search).
- [`POST /v1/openlines/sessions/open`](/docs/openlines/sessions/open) — по коду клиента в коннекторе.
- [`GET /v1/openlines/crm/chats`](/docs/openlines/crm-chats) — по карточке CRM.

## Типовой сценарий

1. Найти чат клиента: [`POST /v1/openlines/sessions/search`](/docs/openlines/sessions/search) по линии или [`POST /v1/openlines/sessions/open`](/docs/openlines/sessions/open) по коду клиента.
2. Взять диалог себе: [`POST /v1/openlines/sessions/start`](/docs/openlines/sessions/start). Сотрудник, от имени которого идёт вызов, становится оператором сессии.
3. Передать диалог коллеге или в очередь линии: [`POST /v1/openlines/operator/transfer`](/docs/openlines/operator/transfer).
4. Завершить диалог, который ведёт другой оператор: [`POST /v1/openlines/operator/finish-another`](/docs/openlines/operator/finish-another).

## Операции

- [Пропустить диалог](./operator/skip.md) — `POST /v1/openlines/operator/skip`
- [Пометить клиента спамером](./operator/spam.md) — `POST /v1/openlines/operator/spam`
- [Передать диалог](./operator/transfer.md) — `POST /v1/openlines/operator/transfer`
- [Завершить чужой диалог](./operator/finish-another.md) — `POST /v1/openlines/operator/finish-another`
- [Прочитать свою паузу](./operator/pause.md) — `GET /v1/openlines/operator/pause`
- [Включить свою паузу](./operator/pause-start.md) — `POST /v1/openlines/operator/pause`
- [Выключить свою паузу](./operator/pause-stop.md) — `DELETE /v1/openlines/operator/pause`

## Смотрите также

- [Открытые линии](/docs/openlines)
- [Поиск сессий](/docs/openlines/sessions/search)
- [Чаты по карточке CRM](/docs/openlines/crm-chats)
- [Конфигурации открытых линий](/docs/openlines/config)