AgentMail
Управление почтовыми ящиками, цепочками и сообщениями с помощью AgentMail
AgentMail — это почтовая платформа с API-first подходом, созданная для агентов и автоматизации. AgentMail позволяет создавать почтовые ящики на лету, отправлять и получать сообщения, отвечать на цепочки, управлять черновиками и организовывать диалоги с помощью меток — все через простой REST API, разработанный для программного доступа.
Почему AgentMail?
- Почта для агентов: Специально создана для AI-агентов и автоматизации — создавайте почтовые ящики, отправляйте сообщения и управляйте цепочками без накладных расходов на пользовательский интерфейс.
- Полный жизненный цикл почты: Отправляйте новые сообщения, отвечайте на цепочки, пересылайте письма, управляйте черновиками и планируйте отправку — все из единого API.
- Управление цепочками и диалогами: Организуйте письма в цепочки с полной поддержкой чтения, ответов, пересылки и меток для структурированного отслеживания диалогов.
- Рабочий процесс черновиков: Создавайте черновики, обновляйте их, планируйте отправку и отправляйте, когда готово — идеально для рабочих процессов "проверка перед отправкой".
- Организация с помощью меток: Помечайте цепочки и сообщения пользовательскими метками для фильтрации, маршрутизации и последующей автоматизации.
Использование AgentMail в AACFlow
Интеграция AgentMail в AACFlow подключает ваши агентские рабочие процессы напрямую к AgentMail с использованием API-ключа. С 20 операциями, охватывающими почтовые ящики, цепочки, сообщения и черновики, вы можете создавать мощную почтовую автоматизацию без написания backend-кода.
Ключевые преимущества использования AgentMail в AACFlow:
- Динамическое создание почтовых ящиков: Создавайте новые почтовые ящики на лету для каждого агента, рабочего процесса или клиента — идеально для многопользовательской обработки почты.
- Автоматическая обработка почты: Просматривайте и читайте входящие сообщения, затем запускайте последующие действия на основе содержимого, отправителя или меток.
- Диалоговая почта: Отвечайте на цепочки и пересылайте сообщения, чтобы поддерживать естественный поток диалогов в ваших автоматизированных рабочих процессах.
- Рабочие процессы черновиков и проверки: Создавайте черновики, обновляйте их с помощью содержимого, сгенерированного ИИ, и отправляйте после утверждения — идеально для паттернов "человек в цикле".
- Организация почты: Применяйте метки к цепочкам и сообщениям для категоризации, фильтрации и маршрутизации писем через ваш конвейер автоматизации.
Создаете ли вы AI-почтового ассистента, автоматизируете ответы службы поддержки, обрабатываете входящие лиды или управляете многопользовательскими почтовыми рабочими процессами, AgentMail в AACFlow предоставляет прямой, безопасный доступ ко всему API AgentMail — без промежуточного ПО. Просто настройте ваш API-ключ, выберите нужную операцию и позвольте AACFlow сделать остальное.
Интегрируйте AgentMail в ваш рабочий процесс. Создавайте и управляйте почтовыми ящиками, отправляйте и получайте сообщения, отвечайте на цепочки, управляйте черновиками и организуйте цепочки с помощью меток. Требуется API-ключ.
Создать новый почтовый черновик в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для создания черновика |
to | string | Нет | Адреса электронной почты получателей (через запятую) |
subject | string | Нет | Тема черновика |
text | string | Нет | Текстовое тело черновика |
html | string | Нет | HTML-тело черновика |
cc | string | Нет | Адреса электронной почты получателей в копии (через запятую) |
bcc | string | Нет | Адреса электронной почты получателей в скрытой копии (через запятую) |
inReplyTo | string | Нет | Идентификатор сообщения, на которое идет ответ |
sendAt | string | Нет | Временная метка ISO 8601 для планирования отправки |
| Параметр | Тип | Описание |
|---|
draftId | string | Уникальный идентификатор черновика |
inboxId | string | Почтовый ящик, к которому принадлежит черновик |
subject | string | Тема черновика |
to | array | Адреса электронной почты получателей |
cc | array | Адреса электронной почты получателей в копии |
bcc | array | Адреса электронной почты получателей в скрытой копии |
text | string | Текстовое содержимое |
html | string | HTML-содержимое |
preview | string | Текст предпросмотра черновика |
labels | array | Метки, назначенные черновику |
inReplyTo | string | Идентификатор сообщения, на которое отвечает этот черновик |
sendStatus | string | Статус отправки (scheduled, sending, failed) |
sendAt | string | Запланированное время отправки |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
Создать новый почтовый ящик с помощью AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
username | string | Нет | Имя пользователя для адреса электронной почты почтового ящика |
domain | string | Нет | Домен для адреса электронной почты почтового ящика |
displayName | string | Нет | Отображаемое имя почтового ящика |
| Параметр | Тип | Описание |
|---|
inboxId | string | Уникальный идентификатор почтового ящика |
email | string | Адрес электронной почты почтового ящика |
displayName | string | Отображаемое имя почтового ящика |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
Удалить почтовый черновик в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего черновик |
draftId | string | Да | Идентификатор черновика для удаления |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Успешно ли удален черновик |
Удалить почтовый ящик в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для удаления |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Успешно ли удален почтовый ящик |
Удалить почтовую цепочку в AgentMail (перемещает в корзину или окончательно удаляет, если уже в корзине)
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего цепочку |
threadId | string | Да | Идентификатор цепочки для удаления |
permanent | boolean | Нет | Принудительное окончательное удаление вместо перемещения в корзину |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Успешно ли удалена цепочка |
Переслать почтовое сообщение новым получателям в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего сообщение |
messageId | string | Да | Идентификатор сообщения для пересылки |
to | string | Да | Адреса электронной почты получателей (через запятую) |
subject | string | Нет | Переопределить тему |
text | string | Нет | Дополнительный текстовый текст для добавления в начало |
html | string | Нет | Дополнительный HTML для добавления в начало |
cc | string | Нет | Адреса электронной почты получателей в копии (через запятую) |
bcc | string | Нет | Адреса электронной почты получателей в скрытой копии (через запятую) |
| Параметр | Тип | Описание |
|---|
messageId | string | Идентификатор пересланного сообщения |
threadId | string | Идентификатор цепочки |
Получить детали конкретного почтового черновика в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, к которому принадлежит черновик |
draftId | string | Да | Идентификатор черновика для получения |
| Параметр | Тип | Описание |
|---|
draftId | string | Уникальный идентификатор черновика |
inboxId | string | Почтовый ящик, к которому принадлежит черновик |
subject | string | Тема черновика |
to | array | Адреса электронной почты получателей |
cc | array | Адреса электронной почты получателей в копии |
bcc | array | Адреса электронной почты получателей в скрытой копии |
text | string | Текстовое содержимое |
html | string | HTML-содержимое |
preview | string | Текст предпросмотра черновика |
labels | array | Метки, назначенные черновику |
inReplyTo | string | Идентификатор сообщения, на которое отвечает этот черновик |
sendStatus | string | Статус отправки (scheduled, sending, failed) |
sendAt | string | Запланированное время отправки |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
Получить детали конкретного почтового ящика в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для получения |
| Параметр | Тип | Описание |
|---|
inboxId | string | Уникальный идентификатор почтового ящика |
email | string | Адрес электронной почты почтового ящика |
displayName | string | Отображаемое имя почтового ящика |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
Получить детали конкретного почтового сообщения в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего сообщение |
messageId | string | Да | Идентификатор сообщения для получения |
| Параметр | Тип | Описание |
|---|
messageId | string | Уникальный идентификатор сообщения |
threadId | string | Идентификатор цепочки, к которой принадлежит это сообщение |
from | string | Адрес электронной почты отправителя |
to | array | Адреса электронной почты получателей |
cc | array | Адреса электронной почты получателей в копии |
bcc | array | Адреса электронной почты получателей в скрытой копии |
subject | string | Тема сообщения |
text | string | Текстовое содержимое |
html | string | HTML-содержимое |
createdAt | string | Временная метка создания |
Получить детали конкретной почтовой цепочки, включая сообщения, в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего цепочку |
threadId | string | Да | Идентификатор цепочки для получения |
| Параметр | Тип | Описание |
|---|
threadId | string | Уникальный идентификатор цепочки |
subject | string | Тема цепочки |
senders | array | Список адресов электронной почты отправителей |
recipients | array | Список адресов электронной почты получателей |
messageCount | number | Количество сообщений в цепочке |
labels | array | Метки, назначенные цепочке |
lastMessageAt | string | Временная метка последнего сообщения |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
messages | array | Сообщения в цепочке |
↳ messageId | string | Уникальный идентификатор сообщения |
↳ from | string | Адрес электронной почты отправителя |
↳ to | array | Адреса электронной почты получателей |
↳ cc | array | Адреса электронной почты получателей в копии |
↳ bcc | array | Адреса электронной почты получателей в скрытой копии |
↳ subject | string | Тема сообщения |
↳ text | string | Текстовое содержимое |
↳ html | string | HTML-содержимое |
↳ createdAt | string | Временная метка создания |
Список почтовых черновиков в почтовом ящике в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для получения списка черновиков |
limit | number | Нет | Максимальное количество черновиков для возврата |
pageToken | string | Нет | Токен пагинации для следующей страницы результатов |
| Параметр | Тип | Описание |
|---|
drafts | array | Список черновиков |
↳ draftId | string | Уникальный идентификатор черновика |
↳ inboxId | string | Почтовый ящик, к которому принадлежит черновик |
↳ subject | string | Тема черновика |
↳ to | array | Адреса электронной почты получателей |
↳ cc | array | Адреса электронной почты получателей в копии |
↳ bcc | array | Адреса электронной почты получателей в скрытой копии |
↳ preview | string | Текст предпросмотра черновика |
↳ sendStatus | string | Статус отправки (scheduled, sending, failed) |
↳ sendAt | string | Запланированное время отправки |
↳ createdAt | string | Временная метка создания |
↳ updatedAt | string | Временная метка последнего обновления |
count | number | Общее количество черновиков |
nextPageToken | string | Токен для получения следующей страницы |
Список всех почтовых ящиков в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
limit | number | Нет | Максимальное количество почтовых ящиков для возврата |
pageToken | string | Нет | Токен пагинации для следующей страницы результатов |
| Параметр | Тип | Описание |
|---|
inboxes | array | Список почтовых ящиков |
↳ inboxId | string | Уникальный идентификатор почтового ящика |
↳ email | string | Адрес электронной почты почтового ящика |
↳ displayName | string | Отображаемое имя почтового ящика |
↳ createdAt | string | Временная метка создания |
↳ updatedAt | string | Временная метка последнего обновления |
count | number | Общее количество почтовых ящиков |
nextPageToken | string | Токен для получения следующей страницы |
Список сообщений в почтовом ящике в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для получения списка сообщений |
limit | number | Нет | Максимальное количество сообщений для возврата |
pageToken | string | Нет | Токен пагинации для следующей страницы результатов |
| Параметр | Тип | Описание |
|---|
messages | array | Список сообщений в почтовом ящике |
↳ messageId | string | Уникальный идентификатор сообщения |
↳ from | string | Адрес электронной почты отправителя |
↳ to | array | Адреса электронной почты получателей |
↳ subject | string | Тема сообщения |
↳ preview | string | Текст предпросмотра сообщения |
↳ createdAt | string | Временная метка создания |
count | number | Общее количество сообщений |
nextPageToken | string | Токен для получения следующей страницы |
Список почтовых цепочек в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для получения списка цепочек |
limit | number | Нет | Максимальное количество цепочек для возврата |
pageToken | string | Нет | Токен пагинации для следующей страницы результатов |
labels | string | Нет | Метки через запятую для фильтрации цепочек |
before | string | Нет | Фильтровать цепочки до этой временной метки ISO 8601 |
after | string | Нет | Фильтровать цепочки после этой временной метки ISO 8601 |
| Параметр | Тип | Описание |
|---|
threads | array | Список почтовых цепочек |
↳ threadId | string | Уникальный идентификатор цепочки |
↳ subject | string | Тема цепочки |
↳ senders | array | Список адресов электронной почты отправителей |
↳ recipients | array | Список адресатов электронной почты получателей |
↳ messageCount | number | Количество сообщений в цепочке |
↳ lastMessageAt | string | Временная метка последнего сообщения |
↳ createdAt | string | Временная метка создания |
↳ updatedAt | string | Временная метка последнего обновления |
count | number | Общее количество цепочек |
nextPageToken | string | Токен для получения следующей страницы |
Ответить на существующее почтовое сообщение в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для ответа |
messageId | string | Да | Идентификатор сообщения для ответа |
text | string | Нет | Текстовое тело ответа |
html | string | Нет | HTML-тело ответа |
to | string | Нет | Переопределить адреса электронной почты получателей (через запятую) |
cc | string | Нет | Адреса электронной почты получателей в копии (через запятую) |
bcc | string | Нет | Адреса электронной почты получателей в скрытой копии (через запятую) |
replyAll | boolean | Нет | Ответить всем получателям исходного сообщения |
| Параметр | Тип | Описание |
|---|
messageId | string | Идентификатор отправленного ответного сообщения |
threadId | string | Идентификатор цепочки |
Отправить существующий почтовый черновик в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего черновик |
draftId | string | Да | Идентификатор черновика для отправки |
| Параметр | Тип | Описание |
|---|
messageId | string | Идентификатор отправленного сообщения |
threadId | string | Идентификатор цепочки |
Отправить почтовое сообщение из почтового ящика AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для отправки |
to | string | Да | Адрес электронной почты получателя (через запятую для нескольких) |
subject | string | Да | Тема письма |
text | string | Нет | Текстовое тело письма |
html | string | Нет | HTML-тело письма |
cc | string | Нет | Адреса электронной почты получателей в копии (через запятую) |
bcc | string | Нет | Адреса электронной почты получателей в скрытой копии (через запятую) |
| Параметр | Тип | Описание |
|---|
threadId | string | Идентификатор созданной цепочки |
messageId | string | Идентификатор отправленного сообщения |
subject | string | Тема письма |
to | string | Адрес электронной почты получателя |
Обновить существующий почтовый черновик в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего черновик |
draftId | string | Да | Идентификатор черновика для обновления |
to | string | Нет | Адреса электронной почты получателей (через запятую) |
subject | string | Нет | Тема черновика |
text | string | Нет | Текстовое тело черновика |
html | string | Нет | HTML-тело черновика |
cc | string | Нет | Адреса электронной почты получателей в копии (через запятую) |
bcc | string | Нет | Адреса электронной почты получателей в скрытой копии (через запятую) |
sendAt | string | Нет | Временная метка ISO 8601 для планирования отправки |
| Параметр | Тип | Описание |
|---|
draftId | string | Уникальный идентификатор черновика |
inboxId | string | Почтовый ящик, к которому принадлежит черновик |
subject | string | Тема черновика |
to | array | Адреса электронной почты получателей |
cc | array | Адреса электронной почты получателей в копии |
bcc | array | Адреса электронной почты получателей в скрытой копии |
text | string | Текстовое содержимое |
html | string | HTML-содержимое |
preview | string | Текст предпросмотра черновика |
labels | array | Метки, назначенные черновику |
inReplyTo | string | Идентификатор сообщения, на которое отвечает этот черновик |
sendStatus | string | Статус отправки (scheduled, sending, failed) |
sendAt | string | Запланированное время отправки |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
Обновить отображаемое имя почтового ящика в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика для обновления |
displayName | string | Да | Новое отображаемое имя для почтового ящика |
| Параметр | Тип | Описание |
|---|
inboxId | string | Уникальный идентификатор почтового ящика |
email | string | Адрес электронной почты почтового ящика |
displayName | string | Отображаемое имя почтового ящика |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
Добавить или удалить метки на почтовом сообщении в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего сообщение |
messageId | string | Да | Идентификатор сообщения для обновления |
addLabels | string | Нет | Метки через запятую для добавления к сообщению |
removeLabels | string | Нет | Метки через запятую для удаления из сообщения |
| Параметр | Тип | Описание |
|---|
messageId | string | Уникальный идентификатор сообщения |
labels | array | Текущие метки на сообщении |
Добавить или удалить метки на почтовой цепочке в AgentMail
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ AgentMail |
inboxId | string | Да | Идентификатор почтового ящика, содержащего цепочку |
threadId | string | Да | Идентификатор цепочки для обновления |
addLabels | string | Нет | Метки через запятую для добавления к цепочке |
removeLabels | string | Нет | Метки через запятую для удаления из цепочки |
| Параметр | Тип | Описание |
|---|
threadId | string | Уникальный идентификатор цепочки |
labels | array | Текущие метки на цепочке |