Mailgun

Mailgun — мощный сервис доставки email, разработанный для разработчиков и компаний, которым нужно легко отправлять, получать и отслеживать письма. Mailgun даёт возможность использовать надёжные API для транзакционного и маркетингового email, гибкого управления списками рассылок и расширенного отслеживания событий.

Благодаря широкому набору возможностей Mailgun вы можете автоматизировать ключевые email-операции и подробно отслеживать доставляемость и вовлечённость получателей. Это делает его идеальным решением для автоматизации воркфлоу, в которых коммуникации, уведомления и рассылки кампаний — основа процессов.

Ключевые возможности Mailgun:

Отправка транзакционных писем: доставляйте большие объёмы писем — уведомления о действиях в аккаунте, чеки, оповещения и сбросы пароля.
Богатый контент писем: отправляйте письма как в текстовом, так и в HTML-формате, используйте теги для классификации и отслеживания сообщений.
Управление списками рассылки: создавайте, обновляйте и управляйте списками рассылки и их участниками для эффективной групповой коммуникации.
Информация о доменах: получайте сведения о ваших отправляющих доменах, чтобы контролировать их настройку и состояние.
Отслеживание событий: анализируйте доставляемость и вовлечённость с помощью подробных событий по отправленным сообщениям.
Получение сообщений: обращайтесь к сохранённым сообщениям для соответствия требованиям, анализа или диагностики.

Интегрируя Mailgun в AACFlow, ваши AI-агенты получают возможность программно отправлять письма, управлять списками рассылки, получать информацию о доменах и отслеживать события в реальном времени в рамках автоматизированных воркфлоу. Это позволяет выстраивать интеллектуальное, основанное на данных взаимодействие с пользователями прямо из ваших AI-процессов.

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	Mailgun API key
`domain`	string	Да	Mailgun sending domain (e.g., mg.example.com)
`from`	string	Да	Sender email address (e.g., sender@example.com or "Name <sender@example.com>")
`to`	string	Да	Recipient email address (e.g., user@example.com). Use comma-separated values for multiple recipients
`subject`	string	Да	Email subject line
`text`	string	Нет	Plain text body of the email
`html`	string	Нет	HTML body of the email (e.g., "<h1>Hello</h1><p>Message content</p>")
`cc`	string	Нет	CC recipient email address (e.g., cc@example.com). Use comma-separated values for multiple recipients
`bcc`	string	Нет	BCC recipient email address (e.g., bcc@example.com). Use comma-separated values for multiple recipients
`tags`	string	Нет	Tags for the email (comma-separated)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Произошла ли message was sent successfully
`id`	string	Message ID
`message`	string	Response message from Mailgun

`mailgun_get_message`

Получить stored message by its key

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	Mailgun API key
`domain`	string	Да	Mailgun domain for retrieving messages (e.g., mg.example.com)
`messageKey`	string	Да	Message storage key

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Произошла ли request was successful
`recipients`	string	Message recipients
`from`	string	Sender email
`subject`	string	Message subject
`bodyPlain`	string	Plain text body
`strippedText`	string	Stripped text
`strippedSignature`	string	Stripped signature
`bodyHtml`	string	HTML body
`strippedHtml`	string	Stripped HTML
`attachmentCount`	number	Number of attachments
`timestamp`	number	Message timestamp
`messageHeaders`	json	Message headers
`contentIdMap`	json	Content ID map

`mailgun_list_messages`

Список events (logs) для messages sent through Mailgun

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	Mailgun API key
`domain`	string	Да	Mailgun domain for listing events (e.g., mg.example.com)
`event`	string	Нет	Filter by event type (accepted, delivered, failed, opened, clicked, etc.)
`limit`	number	Нет	Maximum number of events to return (default: 100)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Произошла ли request was successful
`items`	json	Массив event items
`paging`	json	Paging information

`mailgun_create_mailing_list`

Создать новый mailing list

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	Mailgun API key
`address`	string	Да	Mailing list address (e.g., newsletter@mg.example.com)
`name`	string	Нет	Mailing list name
`description`	string	Нет	Mailing list description
`accessLevel`	string	Нет	Access level: readonly, members, or everyone

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Произошла ли list was created successfully
`message`	string	Response message
`list`	json	Created mailing list details

`mailgun_get_mailing_list`

Получить details of a mailing list

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	Mailgun API key
`address`	string	Да	Mailing list address to retrieve (e.g., newsletter@mg.example.com)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Произошла ли request was successful
`list`	json	Mailing list details

`mailgun_add_list_member`

Добавить участника to a mailing list

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	Mailgun API key
`listAddress`	string	Да	Mailing list address (e.g., list@mg.example.com)
`address`	string	Да	Member email address to add (e.g., user@example.com)
`name`	string	Нет	Member name
`vars`	string	Нет	JSON string of custom variables
`subscribed`	boolean	Нет	Произошла ли member is subscribed