Mailgun (предварительная версия)
Mailgun предоставляет мощные API для отправки, получения, отслеживания и хранения электронной почты. Используйте этот соединитель для автоматизации рабочих процессов доставки электронной почты и обмена данными без написания кода.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандартный | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Канал поддержки |
| URL | https://help.mailgun.com/hc/en-us |
| Эл. почта | support@mailgun.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Синч Швеция AB |
| Веб-сайт | https://www.mailgun.com |
| Политика конфиденциальности | https://www.mailgun.com/legal/privacy-policy/ |
| Categories | Маркетинг; Продажи и CRM |
Имя соединителя
Mailgun
Сводка по соединителю
Соединитель Mailgun позволяет Power Automate пользователям отправлять сообщения электронной почты, получать сведения о домене Mailgun, проверять отдельные адреса электронной почты, отправлять задания массовой проверки электронной почты и получать результаты массовой проверки с помощью учетной записи Mailgun.
Контакт
URL-адрес контакта: https://help.mailgun.com/hc/en-us
Поддержка и обращение по электронной почте: support@mailgun.com
URL-адрес регистрации: https://signup.mailgun.com/
Требования
- Учетная запись Mailgun. Если у вас нет, зарегистрируйтесь по адресу https://signup.mailgun.com/.
- Ключ ИЛИ домен отправки ключа API Mailgun.
- Правильный регион API Mailgun для вашей учетной записи: США или ЕС.
- Для отправки электронной почты почтовый домен Mailgun. Для отправки рабочей среды требуется проверенный домен.
- Для действий проверки доступ к Mailgun Validate.
Домены песочницы могут использоваться для первоначального тестирования, но ограничены авторизованными получателями.
Получение учетных данных
Этот соединитель использует проверку подлинности ключа API Mailgun. Войдите в панель управления Mailgun и создайте ключ API из службы безопасности API или создайте ключ API для конкретного домена из параметров домена отправки.
Соединитель использует обычную проверку подлинности в api качестве имени пользователя и ключа API Mailgun в качестве пароля. Во время настройки подключения выберите регион API Mailgun, соответствующий вашей учетной записи.
Поддерживаемые операции
Этот соединитель поддерживает следующие операции:
-
Send Email: отправка сообщения электронной почты с помощью домена отправки Mailgun. -
Get Domain Information: получение сведений о домене Mailgun. -
Validate Email Address: проверьте отдельный адрес электронной почты. -
Submit Bulk Validation Job: отправка задания массовой проверки электронной почты. -
Get Bulk Validation Results: получение результатов массовой проверки электронной почты.
Создание подключения
Коннектор поддерживает следующие типы аутентификации:
| По умолчанию | Параметры для создания подключения. | Все регионы | Не подлежит распространению |
По умолчанию
Применимо: Все регионы
Параметры для создания подключения.
Это не общее соединение. Если приложение Power используется совместно с другим пользователем, ему будет предложено явно создать новое подключение.
| Имя | Тип | Описание | Обязательный |
|---|---|---|---|
| Ключ API | securestring | Закрытый ключ API Mailgun | True |
| Регион Mailgun | струна | Выбор Mailgun US или Mailgun EU | True |
Действия
| Массовая проверка электронной почты |
Отправьте CSV-файл с столбцом заголовка электронной почты и запустите задание массовой проверки с помощью API Mailgun версии 4. |
| Отправить сообщение электронной почты |
Отправляет сообщение электронной почты с помощью учетной записи Mailgun через поля формы с несколькими частями, совместимыми с API сообщений Mailgun. |
| Получение доменов |
Получите список доменов. Можно отфильтровать по штату или органу. Список разбиен на страницы и ограничен 1000 элементами на страницу. |
| Получение результатов массовой проверки |
Извлекает состояние задания массовой проверки и сводные результаты для ранее отправленного задания. |
| Получение сведений о домене |
Извлекает представление JSON домена, включающего сведения о состоянии и параметрах домена. |
| Проверка электронной почты |
Проверяет адрес электронной почты с помощью службы проверки Mailgun и возвращает результаты доставки. |
Массовая проверка электронной почты
Отправьте CSV-файл с столбцом заголовка электронной почты и запустите задание массовой проверки с помощью API Mailgun версии 4.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя списка заданий
|
list_id | True | string |
Параметр пути, определяющий задание массовой проверки. |
|
CSV-файл
|
file | True | file |
CSV-файл для отправки. Файл должен содержать заголовок с именем электронной почты. |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор задания (имя списка)
|
id | string |
Идентификатор задания (имя списка) |
|
Сообщение сервера
|
message | string |
Сообщение о состоянии из Mailgun |
Отправить сообщение электронной почты
Отправляет сообщение электронной почты с помощью учетной записи Mailgun через поля формы с несколькими частями, совместимыми с API сообщений Mailgun.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя домена
|
domain_name | True | string |
Домен для отправки сообщения электронной почты из |
|
Из адреса электронной почты
|
from | True | string |
Адрес электронной почты, из который будет отправлено сообщение. |
|
Адрес электронной почты
|
to | True | string |
Адрес электронной почты получателя. |
|
Тема
|
subject | True | string |
Тема сообщения электронной почты. |
|
Текст электронной почты (текст)
|
text | string |
Текст обычного текста сообщения электронной почты. |
|
|
Текст электронной почты (HTML)
|
html | html |
Текст HTML сообщения электронной почты. |
|
|
Адрес электронной почты CC
|
cc | string |
Адрес электронной почты получателя углеродной копии. |
|
|
Адрес электронной почты BCC
|
bcc | string |
Адрес электронной почты получателя глухого копирования. |
|
|
адрес электронной почты Reply-To
|
h:Reply-To | string |
Где должны быть доставлены ответы. |
|
|
Вложение
|
attachment | file |
Вложение файла для включения в сообщение. |
|
|
Tags
|
o:tag | array |
Один или несколько тегов для группировки и фильтрации сообщений в Mailgun (до 10 за сообщение). |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор сообщения
|
id | string |
Уникальный идентификатор, назначенный сообщению в очереди |
|
Сообщение о состоянии
|
message | string |
Состояние, доступное для чтения пользователем из Mailgun (например, Queued). Спасибо.) |
Получение доменов
Получите список доменов. Можно отфильтровать по штату или органу. Список разбиен на страницы и ограничен 1000 элементами на страницу.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Максимальное количество элементов. Макс. 1000. По умолчанию — 100 |
|
|
Пропустить
|
skip | integer |
Получите список элементов, начиная с n-го элемента. По умолчанию: 0 |
|
|
State
|
state | string |
Получение только доменов с определенным состоянием. Может быть активным, непроверенным или отключенным. |
|
|
Sort
|
sort | string |
Допустимые параметры сортировки : name (asc), name:asc или name:desc. |
|
|
Авторитет
|
authority | string |
Получение только доменов с определенным центром. |
|
|
Search
|
search | string |
Поиск доменов по заданному частичному или полному имени. Не поддерживает подстановочные знаки. |
|
|
Включение подсчетных записей
|
include_subaccounts | boolean |
Выполните поиск по каждому домену, принадлежащему любому подсчету в этой учетной записи. По умолчанию: false. |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
total_count
|
total_count | integer |
Общее количество доменов |
|
items
|
items | array of object |
Список доменов |
|
id
|
items.id | string |
Уникальный идентификатор домена |
|
имя
|
items.name | string |
Полное доменное имя, зарегистрированное в Mailgun |
|
state
|
items.state | string |
Текущее состояние проверки домена |
|
тип
|
items.type | string |
Классификация домена. Возможные значения — это настраиваемые или песочницы |
|
создано_в
|
items.created_at | string |
Метка времени, указывающая, когда домен был создан в формате RFC1123 |
|
is_disabled
|
items.is_disabled | boolean |
Указывает, отключен ли домен в настоящее время |
|
require_tls
|
items.require_tls | boolean |
Если true Mailgun будет отправлять сообщения только через подключение TLS |
|
skip_verification
|
items.skip_verification | boolean |
Если true Mailgun не проверяет сертификат и имя узла при настройке подключения TLS |
|
smtp_login
|
items.smtp_login | string |
Имя входа SMTP для домена |
|
smtp_password
|
items.smtp_password | string |
Необязательный пароль SMTP для домена, используемого для проверки подлинности SMTP |
|
spam_action
|
items.spam_action | string |
Действие, выполняемое при помечении сообщения как нежелательной почты. Параметры отключены, тег или блок |
|
Подстановочный знак
|
items.wildcard | boolean |
Указывает, является ли домен подстановочным доменом и может получать сообщения электронной почты для любого поддомена. |
|
subaccount_id
|
items.subaccount_id | string |
Идентификатор подсчета, к которому принадлежит домен |
|
tracking_host
|
items.tracking_host | string |
Пользовательский узел отслеживания для домена, используемого для отслеживания, открывается и щелкает |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Если true Mailgun управляет созданием ключей DKIM и конфигурацией записи DNS автоматически |
|
web_prefix
|
items.web_prefix | string |
Префикс поддомена, используемый для открытия и отслеживания щелчков |
|
web_scheme
|
items.web_scheme | string |
Схема протокола, используемая для отслеживания |
|
archive_to
|
items.archive_to | string |
URL-адрес, в который будет отправлена копия каждого успешно доставленного сообщения. |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Если в этот домен будут зашифрованы истинные входящие сообщения |
|
message_ttl
|
items.message_ttl | integer |
Указывает время жизни (TTL) в секундах для получения входящих и исходящих сообщений |
Получение результатов массовой проверки
Извлекает состояние задания массовой проверки и сводные результаты для ранее отправленного задания.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задания
|
list_id | True | string |
Идентификатор задания, возвращенный из запроса массовой проверки. |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор задания
|
id | string |
Идентификатор задания |
|
Идентификатор задания
|
list_id | string |
Имя списка заданий |
|
Состояние задания
|
status | string |
Текущее состояние задания |
|
Создано в
|
created_at | integer |
Когда задание было создано (метка времени Unix) |
|
URL-адрес скачивания CSV
|
download_url.csv | string |
URL-адрес для скачивания всех результатов в виде CSV-файла |
|
URL-адрес скачивания для скачиваемого CSV-файла
|
download_url.curated_csv | string |
URL-адрес для скачивания проверенных результатов в виде CSV-файла |
|
URL-адрес скачивания JSON
|
download_url.json | string |
URL-адрес для скачивания всех результатов в формате JSON-файла |
|
URL-адрес скачивания JSON для курированного кода
|
download_url.curated_json | string |
URL-адрес для скачивания проверенных результатов в формате JSON-файла |
|
Общее количество
|
quantity | integer |
Общее количество записей в задании |
|
Обработанные записи
|
records_processed | integer |
Количество записей, обработанных до сих пор |
|
Число конечных объектов
|
summary.result.deliverable | integer |
Количество конечных адресов |
|
Неизменяемое число
|
summary.result.undeliverable | integer |
Количество невыживаемых адресов |
|
Перехват всех счетчиков
|
summary.result.catch_all | integer |
Число адресов catch-all |
|
Не отправлять число
|
summary.result.do_not_send | integer |
Число адресов, помеченных как не отправляемые |
|
Принять все счетчики
|
summary.result.accept_all | integer |
Число адресов accept-all |
|
Неизвестное число
|
summary.result.unknown | integer |
Количество адресов с неизвестной доставкой |
|
Высокий уровень риска
|
summary.risk.high | integer |
Количество адресов с высоким риском |
|
Среднее число рисков
|
summary.risk.medium | integer |
Количество адресов среднего риска |
|
Низкое число рисков
|
summary.risk.low | integer |
Количество адресов с низким риском |
|
Неизвестное число рисков
|
summary.risk.unknown | integer |
Число адресов с неизвестным риском |
|
Число с высоким уровнем вовлеченности
|
summary.engagement.highly_engaged | integer |
Количество адресов с высокой степенью вовлеченности |
|
Количество занятых
|
summary.engagement.engaged | integer |
Количество задействованных адресов |
|
Отключаемое число
|
summary.engagement.disengaged | integer |
Количество разъединяемых адресов |
|
Число ботов
|
summary.engagement.bot | integer |
Количество адресов бота |
|
Число жалующегося
|
summary.engagement.complainer | integer |
Количество адресов жалующегося |
|
Число данных не
|
summary.engagement.no_data | integer |
Количество адресов без данных об участии |
Получение сведений о домене
Извлекает представление JSON домена, включающего сведения о состоянии и параметрах домена.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя домена
|
name | True | string |
Имя домена, который требуется получить |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
domain.id | string |
Уникальный идентификатор домена |
|
имя
|
domain.name | string |
Полное доменное имя, зарегистрированное в Mailgun |
|
state
|
domain.state | string |
Текущее состояние проверки домена |
|
тип
|
domain.type | string |
Классификация домена. Возможные значения — это настраиваемые или песочницы |
|
создано_в
|
domain.created_at | string |
Метка времени, указывающая, когда домен был создан в формате RFC1123 |
|
is_disabled
|
domain.is_disabled | boolean |
Указывает, отключен ли домен в настоящее время |
|
require_tls
|
domain.require_tls | boolean |
Если true Mailgun будет отправлять сообщения только через подключение TLS |
|
skip_verification
|
domain.skip_verification | boolean |
Если true Mailgun не проверяет сертификат и имя узла при настройке подключения TLS |
|
smtp_login
|
domain.smtp_login | string |
Имя входа SMTP для домена |
|
smtp_password
|
domain.smtp_password | string |
Необязательный пароль SMTP для домена, используемого для проверки подлинности SMTP |
|
spam_action
|
domain.spam_action | string |
Действие, выполняемое при помечении сообщения как нежелательной почты. Параметры отключены, тег или блок |
|
Подстановочный знак
|
domain.wildcard | boolean |
Указывает, является ли домен подстановочным доменом и может получать сообщения электронной почты для любого поддомена. |
|
subaccount_id
|
domain.subaccount_id | string |
Идентификатор подсчета, к которому принадлежит домен |
|
tracking_host
|
domain.tracking_host | string |
Пользовательский узел отслеживания для домена, используемого для отслеживания, открывается и щелкает |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Если true Mailgun управляет созданием ключей DKIM и конфигурацией записи DNS автоматически |
|
web_prefix
|
domain.web_prefix | string |
Префикс поддомена, используемый для открытия и отслеживания щелчков |
|
web_scheme
|
domain.web_scheme | string |
Схема протокола, используемая для отслеживания |
|
archive_to
|
domain.archive_to | string |
URL-адрес, в который будет отправлена копия каждого успешно доставленного сообщения. |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Если в этот домен будут зашифрованы истинные входящие сообщения |
|
message_ttl
|
domain.message_ttl | integer |
Указывает время жизни (TTL) в секундах для получения входящих и исходящих сообщений |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Список записей DNS, необходимых для получения сообщений электронной почты |
|
is_active
|
receiving_dns_records.is_active | boolean |
Указывает, активна ли запись DNS в настоящее время |
|
Кэшированные
|
receiving_dns_records.cached | array of string |
Список кэшированных значений Mailgun для записи DNS |
|
имя
|
receiving_dns_records.name | string |
Имя записи DNS, если применимо |
|
приоритет
|
receiving_dns_records.priority | string |
Значение приоритета для записей MX DNS |
|
record_type
|
receiving_dns_records.record_type | string |
Тип записи DNS, например MX, TXT или CNAME |
|
действительный
|
receiving_dns_records.valid | string |
Указывает, является ли запись DNS допустимой |
|
value
|
receiving_dns_records.value | string |
Ожидаемое значение записи DNS |
|
sending_dns_records
|
sending_dns_records | array of object |
Список записей DNS, необходимых для отправки сообщений электронной почты |
|
is_active
|
sending_dns_records.is_active | boolean |
Указывает, активна ли запись DNS в настоящее время |
|
Кэшированные
|
sending_dns_records.cached | array of string |
Список кэшированных значений Mailgun для записи DNS |
|
имя
|
sending_dns_records.name | string |
Имя записи DNS, если применимо |
|
приоритет
|
sending_dns_records.priority | string |
Значение приоритета для записей MX DNS |
|
record_type
|
sending_dns_records.record_type | string |
Тип записи DNS, например MX, TXT или CNAME |
|
действительный
|
sending_dns_records.valid | string |
Указывает, является ли запись DNS допустимой |
|
value
|
sending_dns_records.value | string |
Ожидаемое значение записи DNS |
Проверка электронной почты
Проверяет адрес электронной почты с помощью службы проверки Mailgun и возвращает результаты доставки.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Адрес электронной почты
|
address | True | string |
Адрес электронной почты для проверки. |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Адрес электронной почты
|
address | string |
Проверенный адрес электронной почты |
|
Является действительным
|
is_valid | boolean |
Является ли Mailgun допустимым адресом |
|
Проверка почтового ящика
|
mailbox_verification | string |
Состояние проверки почтового ящика |
|
Является удаленным адресом
|
is_disposable_address | boolean |
Указывает, является ли адрес у удаленного поставщика |
|
Адрес роли
|
is_role_address | boolean |
Указывает, является ли адрес адресом на основе ролей |
|
Причина проверки
|
reason | array of string |
Причины проверки, возвращаемые Mailgun (пустые при допустимости) |
|
Уровень риска
|
risk | string |
Уровень риска, назначенный Mailgun |
|
Результат
|
result | string |
Результат доставки почтового пистолета (например, доставить или недоступен) |
|
Корневой адрес
|
root_address | string |
Нормализованный корневой адрес |
|
Отображаемое имя
|
parts.display_name | string |
Отображаемое имя адреса |
|
Домен
|
parts.domain | string |
Доменная часть адреса |
|
Локальная часть
|
parts.local_part | string |
Локальная часть адреса |