# Интеграция с Google Таблицами

Source: https://docs.botman.pro/a/228-integratsiya-s-google-tablitsami

Интеграция позволяет связать ваш Google-аккаунт с платформой и работать с Google Таблицами прямо в сценариях бота.

Вы сможете:

- добавлять новые строки с данными подписчиков (например, заявки, контакты);
- обновлять информацию в таблице (например, статус заявки, комментарий);
- искать данные в таблице и подставлять их в карточку подписчика или в сценарий.

Интеграция особенно полезна для:

- ведения клиентской базы;
- работы с анкетами, заявками, заказами;
- создания отчётности;
- быстрой передачи данных в Google-таблицы без ручной работы.

---

**Как подключить Google Таблицы: пошаговая инструкция**

Подключение проходит через стандартную форму авторизации от Google. Это безопасный процесс, при котором вы сами управляете доступом.

**Шаг 1️⃣: Где найти интеграцию**

\- Перейдите в раздел [Интеграции на платформе BotMan](https://app.botman.pro/app/integration/extensions).

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/1352d563032eb3a024794c21c327bc2f15a28a0537bbab86c039a3439aa157e9.png)

\- Найдите блок Google Таблицы:

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/466a1e57ad5592a145348d3429e7f9449ebd1b2cfb07254ffed1b35d9a3d6bbf.png)

\- Нажмите кнопку «Подключить».

После этого вы будете перенаправлены на сайт Google для входа в аккаунт и подтверждения прав доступа.

**Шаг 2️⃣: Выбор Google-аккаунта**

После нажатия на кнопку «Подключить» в разделе интеграций вы будете перенаправлены на страницу входа Google.

На этом этапе система предложит выбрать один из аккаунтов, с которыми вы уже работали в браузере, или войти в новый.

- Если нужный аккаунт отображается в списке — просто нажмите на него.
- Если его нет — выберите «Использовать другой аккаунт» и введите логин и пароль вручную.

В зависимости от того, подключаете ли вы этот аккаунт впервые или повторно, Google отобразит разные экраны:

**Вариант 1: Первичный вход**

Если аккаунт ещё не подключался, вы увидите экран с заголовком:

Вход в сервис "BotMan"\
(далее откроется запрос прав доступа)⬇

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/6b52af659274d8c520ab1c695342a69f04f3c4684047a67a572f8faceebb4b2e.png)

На следующем шаге нужно будет вручную разрешить доступ к Google Таблицам *(не забудьте поставить галочку).*

**Вариант 2: Повторный вход**

Если этот аккаунт уже был подключён ранее, появится другой экран:

Повторный вход в сервис или приложение (BotMan)\
(Google помнит, что вы уже предоставили доступ, и не будет снова его запрашивать) ⬇

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/29866151aeee14c07e37d9df6712823ea55149da3e9ab42fb0cc21d3450d3a54.png)

В этом случае достаточно просто нажать «Продолжить» — дополнительных действий не требуется.

**Шаг 3️⃣: Запрос прав доступа**

Этот шаг отображается только при первичном подключении аккаунта. Вы увидите экран с заголовком: Приложению "BotMan" нужны права доступа к вашему аккаунту Google. На этом экране будет список запрашиваемых доступов. Главное, что нужно сделать:

✅ Обязательно поставьте галочку: Создание, просмотр, изменение и удаление ваших таблиц Google

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/784260e6233467a867da2af461cfc934f697a63675200aef2cc5373cee56a398.png)

**⚠️ Если вы не установите галочку** и нажмёте «Продолжить», Google не предоставит доступ, и вы будете возвращены к экрану выбора аккаунта.\
Чтобы интеграция работала, галочка обязательно должна быть включена.

После установки галочки нажмите «Продолжить», чтобы завершить авторизацию и вернуться в сервис

Повторное подключение (если аккаунт уже подключался ранее)

Если вы уже ранее подключали этот Google-аккаунт к платформе:

- Экран с галочками и списком прав не появится — Google запомнил, что вы уже предоставили доступ.
- Вам нужно просто подтвердить вход (иногда — просто выбрать аккаунт).
- После этого вы сразу будете перенаправлены обратно в сервис.
- Интеграция будет автоматически активирована без дополнительных действий.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/70c5c49086d611116b538f815da0b37b74ff2f8371ac3934eea89077bdb07a93.png)

**Шаг 4️⃣: Завершение подключения**

Если вы успешно подтвердили доступ (нажав «Продолжить»), система автоматически вернёт вас обратно в платформу. Подключение считается завершённым, и статус интеграции изменится.

Что вы увидите после подключения:

- В блоке Google Таблицы отобразится:\
  \- Адрес подключённого Google-аккаунта\
  \- Кнопка «Отключить» вместо кнопки «Подключить»

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/7829b35f1a8e7d998f9a32c73c07942f7f1c021947a9d92b3822ed62907be7e8.png)

Теперь вы можете использовать Google Таблицы в сценариях — через шаг «Действие». В разделе Интеграции Google Таблиц станут доступны следующие функции:

- Вставить строку – добавить данные подписчика в таблицу;
- Поиск строки – найти информацию и сохранить её в карточку;
- Обновить строку – изменить данные в уже существующей строке по критерию (например, по Telegram ID).

🧠 Полезно знать:

- Все действия с Google Таблицами происходят строго в рамках выданных прав доступа — бот работает только с тем аккаунтом, который вы подключили.
- Это значит, что вы можете управлять только теми таблицами, которые находятся в подключённом Google-аккаунте.
- Если вы хотите работать с таблицами из другого аккаунта — необходимо:

  1. Нажать «Отключить» текущую интеграцию,
  2. Подключить новый аккаунт через кнопку «Подключить».
- 📌 Одновременная работа с несколькими Google-аккаунтами невозможна — в интеграции может быть активен только один аккаунт.

---

**Возможные ошибки при подключении и использовании Google Таблиц**

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

**1. После нажатия на кнопку «Подключить» ничего не происходит**\
Возможно, браузер блокирует всплывающее окно для авторизации.\
👉 Разрешите всплывающие окна или попробуйте открыть платформу в другом браузере.

**2. После выбора аккаунта снова возвращает на тот же экран**\
Скорее всего, вы не поставили галочку при запросе доступа к Google Таблицам.\
👉 Повторите подключение и обязательно установите галочку.

**3. Вы подключили аккаунт, но нужная таблица не отображается**\
Таблица может находиться в другом Google-аккаунте.\
👉 Интеграция работает только с аккаунтом, который подключён сейчас. Чтобы использовать таблицы из другого аккаунта — переподключитесь.

**4. Попытка работать с двумя аккаунтами одновременно**\
Это невозможно — интеграция поддерживает только один активный аккаунт.\
👉 Сначала отключите текущий аккаунт, затем подключите другой.

**5. Вы нажали «Отмена» во время авторизации**\
В таком случае подключение прерывается, и доступ не выдаётся.\
👉 Просто повторите процесс подключения с самого начала.

**6. Интеграция подключена, но действия с таблицей не работают**\
Проверьте, не была ли таблица удалена, переименована или перемещена.\
👉 Убедитесь, что таблица существует и находится в подключённом аккаунте.

**7. Вы отозвали доступ у приложения в настройках Google-аккаунта**\
Если вы вручную отключили доступ для BotMan в настройках аккаунта Google, интеграция перестаёт работать.\
👉 Нужно снова подключить аккаунт через платформу.

**8. У аккаунта больше нет доступа к нужной таблице**\
Если вы подключили аккаунт, но саму таблицу вам больше не расшарили (например, её удалили или закрыли доступ) — действия работать не будут.\
👉 Уточните права доступа к таблице в Google Диске.

**9. Интеграция «забылась» из-за сбоев авторизации**\
В редких случаях Google может сбросить сессию доступа (например, после изменения пароля или смены безопасности).\
👉 Просто переподключите аккаунт через «Отключить» → «Подключить».

