> Расположение: Авторизация от имени сотрудника
> Краткое содержание: Авторизация от имени сотрудника: сотрудник выдаёт боту свои права, и бот делает автоматизации в Пачке и связывает её с другими сервисами от его имени. Как это выглядит для сотрудника, где настраивается у бота и какие ограничения действуют
> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ.


# Авторизация от имени сотрудника

Обычно бот работает своими правами: видит чаты, в которые его добавили, и пишет как бот. Но многим автоматизациям нужны права конкретного сотрудника: собрать сводку по его чатам, завести задачу от его имени, присылать ему задачи из трекера и отвечать на них прямо из Пачки. Для этого сотрудник авторизует бота — выдаёт ему свои права, и дальше бот работает от его имени.

Механизм — OAuth 2.0 с кодом авторизации: бот отправляет сотрудника на экран согласия, получает код и обменивает его на токен, которым вызывает API от имени сотрудника.

## Как это выглядит для сотрудника


  ### Шаг 1. Сотрудник пишет боту

Находит бота в [витрине](/guides/bots/showcase) или в поиске и пишет ему, например `/start`. Кто может написать боту — в разделе [Доступы к чатам и сообщениям](/guides/bots/access#lichnye-soobscheniya).


  ### Шаг 2. Бот присылает кнопку

В ответ бот отправляет сообщение с кнопкой авторизации. Кнопка — обычная ссылка на экран согласия.

![Сотрудник пишет боту /start, бот отвечает приветствием и кнопкой «Предоставить доступ»](/images/bots/first_contact.webp)

*Бот отвечает на /start кнопкой авторизации*


  ### Шаг 3. Сотрудник соглашается

На экране согласия видны имя бота, пространство и запрашиваемые права. Сотрудник нажимает **Разрешить**.


  ### Шаг 4. Бот получает токен

Браузер возвращается на адрес вашего сервера с кодом, сервер обменивает код на токен сотрудника. В витрине у бота появляется отметка **Подключено**.


Как собрать кнопку и обменять код — в разделе [Получение токена](/guides/oauth/flow).

## Где включается

Авторизация включается на вкладке **OAuth** в карточке бота: там выдаются `client_id` и `client_secret`, задаются адреса возврата и набор прав, который бот попросит у сотрудника. Подробнее — в разделе [Настройка авторизации](/guides/oauth/setup).

Одной вкладки мало: авторизация проходит через диалог с ботом, поэтому боту нужны ещё исходящий вебхук и токен. Всё, что должно быть включено, собрано в [Чек-листе запуска](/guides/oauth/checklist).

## Ограничения

- **Только своё пространство.** Авторизовать бота может сотрудник того же пространства, где создан бот.
- **По умолчанию — только администраторам.** Авторизовать бота может тот, кому разрешено создавать персональные токены. По умолчанию это только администраторы: пока владелец или администратор не выберет **Все сотрудники** в настройке **Кто может создавать персональные токены**, сотрудники и мульти-гости авторизовать бота не могут. Подробнее — в разделе [Кто может создавать токены](/api/authorization#kto-mozhet-sozdavat-tokeny).
- **Гостям недоступно.** Гость не может авторизовать бота ни при какой настройке, а мульти-гость может, как и сотрудник.
- **Роль урезает права.** Право из набора, недоступное роли сотрудника, работать не будет: вызов с таким токеном вернёт `403`.
- **Набор прав один.** Бот не выбирает права при каждой авторизации: запрашивается ровно то, что задано в его настройках.

## Разделы

- [Чек-лист запуска](/guides/oauth/checklist) — Что включить у бота, чтобы сотрудник смог написать ему, получить кнопку и авторизовать бота
- [Настройка авторизации](/guides/oauth/setup) — Вкладка «OAuth»: где хранится секрет, адреса возврата и запрашиваемый доступ
- [Получение токена](/guides/oauth/flow) — Кнопка авторизации, обмен кода на токен, PKCE и обработка отказов
- [Согласие и отзыв](/guides/oauth/consent) — Что видит сотрудник, как роль урезает права и что происходит после отзыва



## Связанные разделы

- [Чек-лист запуска](/guides/oauth/checklist)
- [Настройка авторизации](/guides/oauth/setup)
- [Получение токена](/guides/oauth/flow)
- [Авторизация](/api/authorization)
- [Боты: Витрина](/guides/bots/showcase)
