Gmail
Отправка, чтение, поиск и метки писем Gmail в процессах Pailot
Gmail — почта Google. Блок отправляет, читает, ищет и раскладывает письма. Подключение — OAuth (вход по разрешению сервиса).
С Gmail в Pailot вы можете:
- Отправлять письмо и сохранять черновик (вложения, CC/BCC, ответ в тред)
- Читать письма, искать по запросу и переносить между метками
- Помечать прочитанным/непрочитанным, архивировать, удалять в корзину
- Добавлять и снимать метки
- Запускать процесс по событию почты, если включён триггер
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства. Если включён триггер — не публикуйте URL вебхука (входящего HTTP-запроса).
Отправить письмо. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
to | string | Да | Email получателя |
subject | string | Нет | Тема |
body | string | Да | Текст письма |
contentType | string | Нет | Тип тела: text или html |
threadId | string | Нет | ID треда для ответа |
replyToMessageId | string | Нет | ID письма Gmail для ответа — поле id из Gmail Read, не RFC messageId |
cc | string | Нет | Копия, через запятую |
bcc | string | Нет | Скрытая копия, через запятую |
attachments | file[] | Нет | Вложения |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Метки письма |
Сохранить черновик. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
to | string | Да | Email получателя |
subject | string | Нет | Тема |
body | string | Да | Текст письма |
contentType | string | Нет | Тип тела: text или html |
threadId | string | Нет | ID треда для ответа |
replyToMessageId | string | Нет | ID письма Gmail для ответа — поле id из Gmail Read, не RFC messageId |
cc | string | Нет | Копия, через запятую |
bcc | string | Нет | Скрытая копия, через запятую |
attachments | file[] | Нет | Вложения черновика |
| Параметр | Тип | Описание |
|---|
draftId | string | ID черновика |
messageId | string | ID письма черновика |
threadId | string | ID треда |
labelIds | array | Метки письма |
Прочитать письма. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Нет | ID письма |
folder | string | Нет | Папка или метка |
unreadOnly | boolean | Нет | Только непрочитанные |
maxResults | number | Нет | Максимум писем (по умолчанию 1, максимум 10) |
includeAttachments | boolean | Нет | Скачать и вернуть вложения |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Метки письма |
from | string | Отправитель |
to | string | Получатель |
subject | string | Тема |
date | string | Дата письма |
body | string | Текст письма (по возможности обычный текст) |
hasAttachments | boolean | Есть вложения |
attachmentCount | number | Число вложений |
attachments | file[] | Скачанные вложения (если включено) |
results | json | Сводка, если читают несколько писем |
Поиск писем. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Поисковый запрос |
maxResults | number | Нет | Максимум результатов |
| Параметр | Тип | Описание |
|---|
results | json | Массив результатов поиска |
Перенести письмо между метками. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID письма |
addLabelIds | string | Да | ID меток через запятую, которые добавить (например, INBOX, Label_123) |
removeLabelIds | string | Нет | ID меток через запятую, которые снять (например, INBOX, SPAM) |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Метки письма |
Пометить письмо прочитанным. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID письма |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Обновлённые метки |
Пометить письмо непрочитанным. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID письма |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Обновлённые метки |
Архивировать письмо (убрать из входящих). Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID письма |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Обновлённые метки |
Вернуть письмо во входящие. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID письма |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Обновлённые метки |
Удалить письмо (в корзину). Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID письма |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Обновлённые метки |
Добавить метки к письму. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID письма |
labelIds | string | Да | ID меток через запятую (например, INBOX, Label_123) |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Обновлённые метки |
Снять метки с письма. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID письма |
labelIds | string | Да | ID меток через запятую (например, INBOX, Label_123) |
| Параметр | Тип | Описание |
|---|
id | string | ID письма Gmail |
threadId | string | ID треда |
labelIds | array | Обновлённые метки |
