Документация › Интеграции › Gmail
Gmail
📌 Сначала прочти это. Для большинства проще обычная отправка писем — см. «Письмо клиенту» (работает сразу, без Google Workspace) и «Уведомления владельцу». Gmail-функция ниже — продвинутый вариант для тех, у кого есть Google Workspace.
Бот умеет отправлять письма через Gmail-функцию. Но честно сразу: для обычного@gmail.comэто не заработает — нужен Google Workspace с особой настройкой. Чаще проще использовать «Письмо клиенту».
⏱ 5 мин · 👤 для владельца · 🟢 live
За 30 секунд:
- Функция
gmail_sendшлёт письмо (кому / тема / текст, + копии).- Ограничение: работает только если у тебя Google Workspace и админ включил domain-wide delegation для сервис-аккаунта.
- Для обычного личного
@gmail.comотправка вернёт 403 — это ожидаемо.- Заголовки писем защищены от инъекций.
Что делает
Функция send_gmail отправляет email: поля кому (to), тема (subject), текст (body), опционально копии (cc/bcc) и адрес для ответа (reply_to).
Отправка идёт от имени сервис-аккаунта платформы.
⚠️ Важное ограничение (читай до настройки)
Gmail-отправка через сервис-аккаунт — не для всех. Она работает только при выполнении одного из условий:
- у тебя Google Workspace (корпоративный Google для домена), и админ включил domain-wide delegation для сервис-аккаунта; или
- сервис-аккаунт явно назначен авторизованным отправителем.
Если это не настроено, отправка вернёт ошибку 403 с подсказкой:
«Сервис-аккаунт не может отправить email. Для Gmail через Service Account нужна domain-wide delegation в Google Workspace админке (или используйте Resend / SMTP вместо Gmail)»
Перевод на простой язык: для обычного @gmail.com это просто не заработает. Нужна корпоративная почта на своём домене и доступ к её админке.
💡 Что делать вместо. Если тебе нужны письма клиентам (подтверждения, уведомления) и у тебя нет Workspace — обычно проще отправлять их другим способом. Напиши в саппорт — подскажем рабочий вариант под твой случай.
Безопасность
Все поля письма (получатель, тема, копии) очищаются от спецсимволов переноса строк — защита от подмены заголовков письма (header injection).
💬 Простыми словами
Бот в принципе умеет слать письма через Gmail, но тут надо быть честным: для обычной почты @gmail.com это не включится. Технически Google разрешает «роботу» слать письма только если у тебя корпоративная почта Google (Workspace) на своём домене и админ специально это разрешил. У большинства малого бизнеса такого нет — и тогда бот честно ответит ошибкой 403.
Поэтому если тебе просто нужно отправлять клиентам письма — не мучайся с Gmail, напиши в саппорт, подберём способ попроще. А если у тебя есть корпоративный Google на домене — тогда Gmail-функция тебе подойдёт, и админ домена включит нужный доступ.
Дальше: → CRM (Bitrix24 / amoCRM / AlphaCRM)
Связано: Обзор интеграций · Google Sheets
Не получилось? → напиши в саппорт — Gmail требует Google Workspace