Gmail
Отправка, чтение, поиск и перемещение сообщений Gmail или запуск рабочих процессов из событий Gmail
Gmail — одна из самых популярных в мире почтовых служб, которой доверяют частные лица и организации для безопасной отправки, получения и управления сообщениями.
С интеграцией Gmail в AACFlow вы можете:
- Отправлять электронные письма: Создавать и отправлять письма с поддержкой получателей, CC, BCC, темы, тела и вложений
- Создавать черновики: Сохранять черновики писем для последующего просмотра и отправки
- Читать письма: Получать сообщения электронной почты по ID с полным содержимым и метаданными
- Искать письма: Находить письма с использованием мощного синтаксиса поисковых запросов Gmail
- Перемещать письма: Перемещать сообщения между папками или метками
- Управлять статусом прочтения: Помечать письма как прочитанные или непрочитанные
- Архивировать и разархивировать: Архивировать сообщения для очистки входящих или восстанавливать их
- Удалять письма: Удалять сообщения из почтового ящика
- Управлять метками: Добавлять или удалять метки с писем для организации
В AACFlow интеграция Gmail позволяет вашим агентам программно взаимодействовать с вашим почтовым ящиком как частью автоматизированных рабочих процессов. Агенты могут отправлять уведомления, искать определенные письма, организовывать сообщения и запускать действия на основе содержимого писем — обеспечивая интеллектуальную автоматизацию электронной почты и коммуникационные рабочие процессы.
Интегрируйте Gmail в рабочий процесс. Может отправлять, читать, искать и перемещать письма. Может использоваться в режиме триггера для запуска рабочего процесса при получении нового письма.
Отправка писем с использованием Gmail. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
to | string | Да | Адрес электронной почты получателя |
subject | string | Нет | Тема письма |
body | string | Да | Содержимое тела письма |
contentType | string | Нет | Тип содержимого для тела письма (text или html) |
threadId | string | Нет | ID цепочки для ответа (для создания цепочек) |
replyToMessageId | string | Нет | ID сообщения Gmail для ответа - используйте поле "id" из результатов чтения Gmail (не RFC "messageId") |
cc | string | Нет | Получатели в копии (через запятую) |
bcc | string | Нет | Получатели в скрытой копии (через запятую) |
attachments | file[] | Нет | Файлы для прикрепления к письму |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Метки письма |
Создание черновиков писем с использованием Gmail. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
to | string | Да | Адрес электронной почты получателя |
subject | string | Нет | Тема письма |
body | string | Да | Содержимое тела письма |
contentType | string | Нет | Тип содержимого для тела письма (text или html) |
threadId | string | Нет | ID цепочки для ответа (для создания цепочек) |
replyToMessageId | string | Нет | ID сообщения Gmail для ответа - используйте поле "id" из результатов чтения Gmail (не RFC "messageId") |
cc | string | Нет | Получатели в копии (через запятую) |
bcc | string | Нет | Получатели в скрытой копии (через запятую) |
attachments | file[] | Нет | Файлы для прикрепления к черновику письма |
| Параметр | Тип | Описание |
|---|
draftId | string | ID черновика |
messageId | string | ID сообщения Gmail для черновика |
threadId | string | ID цепочки Gmail |
labelIds | array | Метки письма |
Чтение писем из Gmail. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Нет | ID сообщения Gmail для чтения (например, 18f1a2b3c4d5e6f7) |
folder | string | Нет | Папка/метка для чтения писем (например, INBOX, SENT, DRAFT, TRASH, SPAM или имя пользовательской метки) |
unreadOnly | boolean | Нет | Установите true для получения только непрочитанных сообщений |
maxResults | number | Нет | Максимальное количество сообщений для получения (по умолчанию: 1, максимум: 10) |
includeAttachments | boolean | Нет | Установите true для загрузки и включения вложений писем |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Метки письма |
from | string | Адрес электронной почты отправителя |
to | string | Адрес электронной почты получателя |
subject | string | Тема письма |
date | string | Дата письма |
body | string | Текст тела письма (plain text с максимальным качеством) |
hasAttachments | boolean | Имеет ли письмо вложения |
attachmentCount | number | Количество вложений |
attachments | file[] | Загруженные вложения (если включено) |
results | json | Сводные результаты при чтении нескольких сообщений |
Поиск писем в Gmail. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Поисковый запрос для писем |
maxResults | number | Нет | Максимальное количество результатов для возврата (например, 10, 25, 50) |
| Параметр | Тип | Описание |
|---|
results | json | Массив результатов поиска |
Перемещение писем между метками/папками в Gmail. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID сообщения для перемещения |
addLabelIds | string | Да | ID меток для добавления через запятую (например, INBOX, Label_123) |
removeLabelIds | string | Нет | ID меток для удаления через запятую (например, INBOX, SPAM) |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Метки письма |
Пометить сообщение Gmail как прочитанное. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID сообщения для пометки как прочитанного |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Обновленные метки письма |
Пометить сообщение Gmail как непрочитанное. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID сообщения для пометки как непрочитанного |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Обновленные метки письма |
Архивировать сообщение Gmail (удалить из входящих). Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID сообщения для архивирования |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Обновленные метки письма |
Разархивировать сообщение Gmail (вернуть во входящие). Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID сообщения для разархивирования |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Обновленные метки письма |
Удалить сообщение Gmail (переместить в корзину). Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID сообщения для удаления |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Обновленные метки письма |
Добавить метку(и) к сообщению Gmail. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID сообщения для добавления меток |
labelIds | string | Да | ID меток для добавления через запятую (например, INBOX, Label_123) |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Обновленные метки письма |
Удалить метку(и) из сообщения Gmail. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
messageId | string | Да | ID сообщения для удаления меток |
labelIds | string | Да | ID меток для удаления через запятую (например, INBOX, Label_123) |
| Параметр | Тип | Описание |
|---|
id | string | ID сообщения Gmail |
threadId | string | ID цепочки Gmail |
labelIds | array | Обновленные метки письма |
