Время: ~2-3 минуты.

Шаг 1. Создание приложения

1) Открой https://marketplace.zoom.us/develop/create 2) Выбери Server-to-Server OAuth и нажми Create

3) Дай название приложению на английском (например “my assistant”) и нажми Сreate

Шаг 2. Настройка приложения

4) Во вкладке App Credentials скопируй Account ID, Client ID, Client Secret (временно запиши/сохрани куда-нибудь)

5) Перейди в раздел Scopes и нажми Add Scopes

6) Поставь галочки на все нижеперечисленные scopes: – meeting:read:listmeetings:admin – meeting:read:meeting:admin – meeting:write:meeting:admin – meeting:delete:meeting:admin – user:read:listusers:admin – user:read:user:admin – cloudrecording:read:listuserrecordings:admin – cloudrecording:read:listrecordingfiles:admin

После того как выберешь все scopes – внизу должно быть “8 Selected”. Нажми Done

7) Перейди на вкладку Information и заполни : – Short Description (например “personal app for automation” / персональная автоматизация) – Company Name (название компании) – Name – Email

8) Перейди на вкладку Activation и нажми Activate your app

Шаг 3. Завершение подключения в боте

9) Отправь боту одним сообщением:

Account ID Client ID Client Secret

10) Если все успешно – бот пришлет сообщение о подключении

Время: ~3–4 минуты.

Шаг 1. Создание приложения

1. Открой https://www.dropbox.com/developers/apps/create
2. Choose an API → Scoped access
3. Choose the type of access → Full Dropbox
4. Name your app → любое название (например, «Мой ассистент»)
5. Нажми Create app

Шаг 2. Права доступа (Permissions)

1. Перейди на вкладку Permissions

1. Включи галочки в каждой группе:

Account info: – account_info.read — базовая информация об аккаунте

Files and folders: – files.metadata.write — изменение информации о файлах – files.metadata.read — просмотр списка файлов и папок – files.content.write — загрузка и изменение файлов – files.content.read — скачивание файлов

Collaboration: – sharing.write — управление общими папками – sharing.read — просмотр общих папок – file_requests.write — управление запросами файлов – file_requests.read — просмотр запросов файлов – contacts.write — управление контактами – contacts.read — просмотр контактов

1. Нажми Submit внизу страницы

⚠️ Если забыть Submit — права не сохранятся, и ассистент не сможет работать с файлами.

Шаг 3. Redirect URI (callback)

1. Вернись на вкладку Settings

1. Найди раздел OAuth 2 → Redirect URIs
2. Вставь в поле: https://localhost:3000/callback
3. Нажми Add

Это нужно чтобы Dropbox показал код авторизации на отдельной странице, а не пытался отправить тебя на несуществующий сайт.

Шаг 4. Получение App key и App secret

1. На вкладке Settings прокрути вверх
2. Найди:
   • App key — скопируй
   • App secret → нажми Show → скопируй

Шаг 5. Отправка ключей ассистенту

Пришли в чат App key и App secret одним сообщением. Например:

abc123def456
xyz789uvw012

Шаг 6. Авторизация по ссылке

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

1. Перейди по ссылке из чата
2. Откроется страница Dropbox — нажми Allow

1. Браузер перенаправит на https://localhost/?code=... — это нормально, страница не загрузится, но в адресной строке будет код
2. Скопируй значение параметра ?code= — то что между code= и & (или до конца строки, если & нет)
3. Пришли этот код в чат

После этого ассистент закончит подключение и пришлёт «✅ Dropbox подключён!».

Если что-то пошло не так

Не получилось — напиши в @office2i_bot.

Шаг 1. Перейдите в раздел разработчика

Откройте в браузере страницу:

https://ваш-домен.bitrix24.ru/devops/

Например: https://energokomfort.bitrix24.ru/devops/edit/

URL зависит от адреса вашего портала — подставьте свой домен вместо «ваш-домен».

Шаг 2. Выберите «Другое»

На странице разработчика вы увидите карточки с разными возможностями: импорт/экспорт данных, интеграция с внешними системами, автоматизация продаж и т.д.

Нажмите на карточку «Другое» — она находится в нижней части списка.

Шаг 3. Выберите «Входящий вебхук»

Откроется окно с тремя вариантами:

• Локальное приложение
• Исходящий вебхук
• Входящий вебхук ← выбираем этот

Нажмите на «Входящий вебхук».

Шаг 4. Настройте права доступа

В блоке «Настройка прав» отметьте нужные разрешения. Доступны следующие категории:

• Задачи (task) — работа с задачами
• Новости (log) — лента новостей
• Пользователи (user) — данные сотрудников
• CRM (crm) — сделки, контакты, лиды
• Чат и уведомления (im) — сообщения и уведомления
• Диск (disk) — файлы и документы
• Календарь (calendar) — события и расписания

Выберите только те права, которые действительно нужны для вашей интеграции.

Шаг 5. Сохраните и скопируйте URL

Нажмите кнопку «Сохранить».

После сохранения система сгенерирует уникальный URL вебхука. Он будет выглядеть примерно так:

https://ваш-домен.bitrix24.ru/rest/1/xxxxxxxxx/

Скопируйте этот URL — он понадобится для отправки запросов к API.

Шаг 6. Отправьте ее агенту

Отправьте скопированную ссылку Агенту от 2И.

Он сам подключит и проерит интеграцию

Важно

⚠️ Данная ссылка позволяет выполнять действия на портале в соответствии с настроенными правами. Держите её в секрете и не передавайте третьим лицам.

Если URL был скомпрометирован — вернитесь в настройки вебхука и нажмите «Перегенерировать», чтобы получить новую ссылку. Старая перестанет работать.