Документация › Интеграции › Обзор интеграций
Обзор интеграций + сервисный аккаунт Google
Интеграции дают боту «руки во внешнем мире»: записать в Google-таблицу, поставить событие в календарь, завести сделку в CRM. Эта статья, что есть и как подключается Google (через шаринг доступа, без паролей и OAuth).
⏱ 8 мин · 👤 для владельца · 🟢 live
За 30 секунд:
- Интеграции: Google (Таблицы, Календарь, Gmail) · CRM (Bitrix24, amoCRM) · CRM для образования (AlphaCRM) · свои вебхуки.
- Раздел, проект → «Интеграции» (нужна роль редактор+; «просмотр» туда не пускают).
- Google подключается без логина/пароля: платформа даёт тебе email сервис-аккаунта, ты делишься с ним своей таблицей/календарём как «Редактор», и всё.
- Каждая интеграция работает через функции бота.
Какие интеграции есть
| Интеграция | Для чего | Статья |
|---|---|---|
| Google Таблицы | запись лидов, расписание, прайс, бронь слотов | Google Sheets |
| Google Календарь | запись на приём, проверка свободных слотов | Google Calendar |
| Gmail | отправка письма от бота (ограничения: см. статью) | Gmail |
| CRM: Bitrix24 / amoCRM | сделки и контакты в твоей CRM | CRM |
| CRM для образования: AlphaCRM | запись на занятия, поиск ученика | CRM |
| МойСклад | наличие и цены товаров прямо в ответе бота | МойСклад |
| Свои вебхуки | дёрнуть любой свой HTTP-эндпоинт | Функции → Своя интеграция по API |
Все они подключаются в разделе «Интеграции» проекта (доступ: роль редактор и выше; роль «просмотр» туда не пускается, см. Роли).
Как подключается Google: сервисный аккаунт
Это место, где новички путаются. У DOS AI нет «войти через Google» с паролем. Вместо этого работает сервисный аккаунт: служебный Google-аккаунт платформы, у которого есть свой email.
Что делаешь ты (один раз на каждую таблицу/календарь):
- В разделе «Интеграции» платформа показывает email сервис-аккаунта (скопируй его).
- Открываешь свою Google-таблицу (или календарь) → «Поделиться» → добавляешь этот email с правами «Редактор».
- Вставляешь ID таблицы/календаря в функцию. Готово: бот может читать и писать.
Почему так лучше OAuth: ты не отдаёшь платформе доступ ко всему своему Google-аккаунту. Ты делишься только конкретной таблицей или календарём, как поделился бы с коллегой. Захотел отключить, убрал email из доступа, и всё.
💡 Доступ: точечный. Бот видит ровно те таблицы/календари, которыми ты с ним поделился. Не поделился, не видит. Это и безопаснее, и понятнее.
⚠️ Забыл поделиться → ошибка доступа. Самая частая проблема: указал ID таблицы, но не дал сервис-аккаунту доступ. Бот честно скажет, что нужно добавить его email в «Поделиться» как Редактора. → Google Sheets
Что под капотом (для технических)
- Аутентификация, JWT сервис-аккаунта (env
GOOGLE_SERVICE_ACCOUNT_EMAIL+GOOGLE_SERVICE_ACCOUNT_KEY), без пользовательского OAuth. - Запрашиваемые scopes:
spreadsheets,calendar,calendar.events,gmail.send. - Email сервис-аккаунта отдаётся в UI, чтобы ты мог расшарить ресурсы.
Простыми словами
Интеграции это «руки» бота во внешних сервисах. Через них он записывает клиентов в Google-таблицу, ставит встречи в календарь, заводит сделки в твоей CRM.
Самое непонятное для новичков, как подключить Google, ведь логина и пароля тут нет. И это сделано нарочно, ради твоей безопасности. У платформы есть свой служебный «робот-аккаунт» с email-адресом. Ты просто берёшь свою таблицу или календарь и делишься ими с этим адресом: точно так же, как поделился бы с сотрудником. Всё: бот теперь видит именно эту таблицу и ничего больше. Не понравилось, убрал доступ, и связь разорвана. Никакого «дать доступ ко всему Google» не требуется.
Дальше: → Google Sheets
Связано: Google Calendar · Gmail · CRM · Функции
Не получилось? → Функция не вызывается / падает