Webask Workspace Access

---
name: webask-workspace-access
description: "Управляет участниками аккаунта WebAsk и их правами: приглашения, роли, доступ к папкам. Применяется, когда человек хочет дать коллеге доступ, ограничить его или разобраться, почему участник не видит нужные опросы."
---

# Люди и доступы

Ошибка в правах тихая: участник просто не видит часть опросов и думает, что их
нет, или наоборот — видит то, что ему не предназначалось.

Отвечай человеку на том языке, на котором он пишет.

## Посмотреть, как есть сейчас

Сначала `get_workspace_list` — узнать номер аккаунта: все инструменты ниже
просят его в параметрах. Папки, если понадобятся, — `get_folder_list`.

`get_workspace_members` — кто в аккаунте и с какой ролью.
`get_workspace_member_access` — что конкретный участник видит и может.
`get_workspace_roles` — какие роли заведены и что в них входит.

Начинать с этого. «Дай Пете доступ» без понимания текущей картины приводит к тому,
что Петя получает лишнее.

## Пригласить и настроить

| Задача | Инструмент |
|---|---|
| Пригласить | `invite_workspace_member` |
| Повторить приглашение | `resend_workspace_member_invite` |
| Сменить роль | `set_workspace_member_role` |
| Открыть папки | `set_workspace_member_folders` |
| Доступ к одной папке | `manage_folder_access` |
| Исключить | `remove_workspace_member` |
| Роли аккаунта | `save_workspace_role`, `delete_workspace_role` |

## Важное про приглашения

Приглашение нужно **принять**. Пока человек не принял, он числится в списке, но
доступа у него нет. Это вторая по частоте причина «я его добавил, а он не видит».

Первая причина — папки: роль дана, но папки участнику не открыты, и список
опросов у него пустой.

## Как выбирать права

Спросить, что человеку нужно делать, а не какую роль дать:

- Только смотреть результаты — роль без права правки, доступ к нужным папкам.
- Собирать опросы — плюс правка, но не обязательно удаление.
- Настраивать интеграции — отдельное право: без него он не увидит даже, куда
  уходят ответы.
- Полный доступ — только тем, кто действительно администрирует аккаунт.

Права «только свои опросы» дают участнику видеть лишь то, что он создал сам.

## Чего не делать

- **Не исключать участника без явной просьбы** — это отзыв доступа, обратно он
  вернётся только новым приглашением.
- **Не давать полный доступ «чтобы точно работало»** — это самый частый способ
  раздать лишнее.
- **Не удалять роль**, которой пользуются: сначала посмотреть, кто на ней.
- **Не предлагать смену тарифа и не вести на оплату.** Если упёрлись в лимит —
  назвать факт и остановиться.