Мандрил
Mandrill — это API транзакций электронной почты для пользователей MailChimp. Это надежная, мощная и идеально подходит для отправки электронных сообщений, управляемых данными, включая целевую электронную коммерцию и персонализированные сообщения по одному.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL |
Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://mandrill.com/ |
| Политика конфиденциальности | https://mailchimp.com/legal/privacy/ |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Доступный для общего пользования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API Mandrill | securestring | Ключ API Mandrill | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 1200 | 60 секунд |
Действия
| Отправка почты (версия 2) |
Отправка нового транзакционного сообщения через Mandrill. |
| Отправка почты [не рекомендуется] |
Это действие устарело. Вместо этого используйте почту отправки (V2 ).
|
| Перечисление запланированного сообщения |
Запрашивает запланированные сообщения электронной почты. |
| Текущие сведения о пользователе |
Возвращает сведения о пользователе, подключенном к API. |
Отправка почты (версия 2)
Отправка нового транзакционного сообщения через Mandrill.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Содержимое сообщения
|
html | html |
Полное содержимое для отправки |
|
|
Тема
|
subject | True | string |
Тема сообщения |
|
Из электронной почты
|
from_email | True | string |
Адрес электронной почты отправителя |
|
Имя
|
from_name | string |
Имя электронной почты отправителя |
|
|
Адрес электронной почты
|
True | string |
Адрес электронной почты получателя |
|
|
Имя
|
name | string |
Отображаемое имя получателя |
|
|
Отправка как
|
type | string |
Тип отправки (в, cc, bcc) |
|
|
Дополнительные заголовки
|
headers | string |
Дополнительные заголовки для добавления в сообщение (большинство заголовков разрешены) |
|
|
Важно ли это сообщение (true/false)?
|
important | boolean |
Важно ли это сообщение и должно быть доставлено перед не важными сообщениями |
|
|
Отслеживайте, когда сообщение открывается (true/false)?
|
track_opens | boolean |
Включение открытого отслеживания для сообщения |
|
|
Отслеживать щелчки этого сообщения (true/false)?
|
track_clicks | boolean |
Включение отслеживания нажатия кнопки для сообщения |
|
|
Заполните текстовое сообщение, если оно отсутствует (true/false)?
|
auto_text | boolean |
Независимо от того, следует ли автоматически создавать текстовую часть для сообщений, которые не заданы в тексте |
|
|
Встроенные стили CSS в html-сообщении (true/false)?
|
inline_css | boolean |
Независимо от того, следует ли автоматически встраивать все стили CSS, предоставляемые в html-коде сообщения, только для HTML-документов меньше 256 КБ в размере |
|
|
Строка запроса полоса из URL-адреса в агрегированных данных (true/false)?
|
url_strip_qs | boolean |
Независимо от того, следует ли удалять строку запроса из URL-адресов при агрегации отслеживаемых данных URL-адреса |
|
|
Отображение всех получателей в строке "To" (true/false)?
|
preserve_recipients | boolean |
Возможность предоставления всем получателям заголовка "To" для каждого сообщения электронной почты |
|
|
Удаление ведения журнала содержимого (true/false)?
|
view_content_link | boolean |
Следует ли регистрировать содержимое. Задайте значение false, чтобы удалить ведение журнала содержимого для конфиденциальных сообщений электронной почты |
|
|
Необязательный адрес BCC
|
bcc_address | string |
Необязательный адрес для получения точной копии электронной почты каждого получателя |
|
|
Пользовательский домен для отслеживания
|
tracking_domain | string |
Личный домен, используемый для отслеживания, открывается и щелкает вместо mandrillapp.com |
|
|
Метки
|
tags | array of string |
Массив строк для тега сообщения. Статистика накапливается с помощью тегов, хотя мы сохраняем только первые 100, поэтому это не должно быть уникальным или часто меняться. Теги должны быть 50 символами или меньше. Все теги, начиная с подчеркивания, зарезервированы для внутреннего использования и вызывают ошибки. |
|
|
Тип MIME
|
type | string |
Тип MIME вложения |
|
|
Имя файла
|
name | string |
Имя файла вложения |
|
|
Content
|
content | byte |
Содержимое вложения |
|
|
Отправка по адресу
|
send_at | string |
Если это сообщение должно быть отправлено в формате UTC timestamp в формате ГГГГ-MM-DD HH:MM:SS. Если вы указали время в прошлом, сообщение будет отправлено немедленно. Дополнительная плата применяется к запланированному сообщению электронной почты, и эта функция доступна только для учетных записей с положительным балансом. |
|
|
Включите асинхронный (true/false)?
|
async | boolean |
Включение режима фоновой отправки, оптимизированного для массовой отправки |
|
|
Имя выделенного ip-пула
|
ip_pool | string |
Имя выделенного пула IP-адресов, который должен использоваться для отправки сообщения |
Возвращаемое значение
- response
- array of SendMessageResponse
Отправка почты [не рекомендуется]
Это действие устарело. Вместо этого используйте почту отправки (V2 ).
Отправка нового транзакционного сообщения через Mandrill.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
HTML-текст
|
html | string |
Отправка полного HTML-содержимого |
|
|
Текстовое содержимое сообщения
|
text | True | string |
Содержимое полнотекстового текста для отправки |
|
Тема
|
subject | True | string |
Тема сообщения |
|
Из электронной почты
|
from_email | True | string |
Адрес электронной почты отправителя |
|
Имя
|
from_name | string |
Имя электронной почты отправителя |
|
|
Адрес электронной почты
|
True | string |
Адрес электронной почты получателя |
|
|
Имя
|
name | string |
Отображаемое имя получателя |
|
|
Отправка как
|
type | string |
Тип отправки (в, cc, bcc) |
|
|
Дополнительные заголовки
|
headers | string |
Дополнительные заголовки для добавления в сообщение (большинство заголовков разрешены) |
|
|
Важно ли это сообщение (true/false)?
|
important | boolean |
Важно ли это сообщение и должно быть доставлено перед не важными сообщениями |
|
|
Отслеживайте, когда сообщение открывается (true/false)?
|
track_opens | boolean |
Включение открытого отслеживания для сообщения |
|
|
Отслеживать щелчки этого сообщения (true/false)?
|
track_clicks | boolean |
Включение отслеживания нажатия кнопки для сообщения |
|
|
Заполните текстовое сообщение, если оно отсутствует (true/false)?
|
auto_text | boolean |
Независимо от того, следует ли автоматически создавать текстовую часть для сообщений, которые не заданы в тексте |
|
|
Заполните HTML-сообщение, если оно отсутствует (true/false)?
|
auto_html | boolean |
Следует ли автоматически создавать HTML-часть для сообщений, которые не заданы HTML |
|
|
Встроенные стили CSS в html-сообщении (true/false)?
|
inline_css | boolean |
Независимо от того, следует ли автоматически встраивать все стили CSS, предоставляемые в html-коде сообщения, только для HTML-документов меньше 256 КБ в размере |
|
|
Строка запроса полоса из URL-адреса в агрегированных данных (true/false)?
|
url_strip_qs | boolean |
Независимо от того, следует ли удалять строку запроса из URL-адресов при агрегации отслеживаемых данных URL-адреса |
|
|
Отображение всех получателей в строке "To" (true/false)?
|
preserve_recipients | boolean |
Возможность предоставления всем получателям заголовка "To" для каждого сообщения электронной почты |
|
|
Удаление ведения журнала содержимого (true/false)?
|
view_content_link | boolean |
Следует ли регистрировать содержимое. Задайте значение false, чтобы удалить ведение журнала содержимого для конфиденциальных сообщений электронной почты |
|
|
Необязательный адрес BCC
|
bcc_address | string |
Необязательный адрес для получения точной копии электронной почты каждого получателя |
|
|
Пользовательский домен для отслеживания
|
tracking_domain | string |
Личный домен, используемый для отслеживания, открывается и щелкает вместо mandrillapp.com |
|
|
Метки
|
tags | array of string |
Массив строк для тега сообщения. Статистика накапливается с помощью тегов, хотя мы сохраняем только первые 100, поэтому это не должно быть уникальным или часто меняться. Теги должны быть 50 символами или меньше. Все теги, начиная с подчеркивания, зарезервированы для внутреннего использования и вызывают ошибки. |
|
|
Тип MIME
|
type | string |
Тип MIME вложения |
|
|
Имя файла
|
name | string |
Имя файла вложения |
|
|
Content
|
content | byte |
Содержимое вложения |
|
|
Отправка по адресу
|
send_at | string |
Если это сообщение должно быть отправлено в формате UTC timestamp в формате ГГГГ-MM-DD HH:MM:SS. Если вы указали время в прошлом, сообщение будет отправлено немедленно. Дополнительная плата применяется к запланированному сообщению электронной почты, и эта функция доступна только для учетных записей с положительным балансом. |
|
|
Включите асинхронный (true/false)?
|
async | boolean |
Включение режима фоновой отправки, оптимизированного для массовой отправки |
|
|
Имя выделенного ip-пула
|
ip_pool | string |
Имя выделенного пула IP-адресов, который должен использоваться для отправки сообщения |
Возвращаемое значение
- response
- array of SendMessageResponse
Перечисление запланированного сообщения
Запрашивает запланированные сообщения электронной почты.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Кому
|
To | string |
Необязательный адрес электронной почты получателя, чтобы ограничить результаты |
Возвращаемое значение
- response
- array of ListScheduledInfo
Текущие сведения о пользователе
Возвращает сведения о пользователе, подключенном к API.
Возвращаемое значение
Сведения о пользователе, включая имя пользователя, ключ, репутацию, квоту и историческую отправку статистики
- Тело
- UserInfo
Определения
Информация о пользователе
Сведения о пользователе, включая имя пользователя, ключ, репутацию, квоту и историческую отправку статистики
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя пользователя
|
username | string |
Имя пользователя (используется для проверки подлинности SMTP) |
|
Время создания
|
created_at | string |
Дата и время создания учетной записи Mandrill пользователя в формате UTC в формате YYY-MM-DD HH:MM:SS |
|
Общедоступный идентификатор
|
public_id | string |
Уникальный, постоянный идентификатор для этого пользователя |
|
Репутация
|
reputation | integer |
Репутация пользователя в масштабе от 0 до 100, с 75 обычно является "хорошей" репутацией |
|
Почасовая квота
|
hourly_quota | integer |
Максимальное количество сообщений электронной почты Mandrill будет доставляться для этого пользователя каждый час. Любые сообщения электронной почты, кроме этого, будут приняты и помещены в очередь для последующей доставки. Пользователи с более высокой репутацией будут иметь более высокие почасовые квоты |
|
Задержка
|
backlog | integer |
Количество сообщений электронной почты, в очереди для доставки из-за превышения ежемесячных или почасовых квот |
|
статистика
|
stats | Stats |
сводная сводка по отправке статистики учетной записи |
Статистика
сводная сводка по отправке статистики учетной записи
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Сегодня
|
today | StatStruct |
Структуру для хранения сведений о статистике, эта структура используется для статистики на сегодняшний день, last_7_days, last_30_days, last_60_days, last_90_days и all_time |
|
last_7_days
|
last_7_days | StatStruct |
Структуру для хранения сведений о статистике, эта структура используется для статистики на сегодняшний день, last_7_days, last_30_days, last_60_days, last_90_days и all_time |
|
last_30_days
|
last_30_days | StatStruct |
Структуру для хранения сведений о статистике, эта структура используется для статистики на сегодняшний день, last_7_days, last_30_days, last_60_days, last_90_days и all_time |
|
last_60_days
|
last_60_days | StatStruct |
Структуру для хранения сведений о статистике, эта структура используется для статистики на сегодняшний день, last_7_days, last_30_days, last_60_days, last_90_days и all_time |
|
last_90_days
|
last_90_days | StatStruct |
Структуру для хранения сведений о статистике, эта структура используется для статистики на сегодняшний день, last_7_days, last_30_days, last_60_days, last_90_days и all_time |
|
all_time
|
all_time | StatStruct |
Структуру для хранения сведений о статистике, эта структура используется для статистики на сегодняшний день, last_7_days, last_30_days, last_60_days, last_90_days и all_time |
StatStruct
Структуру для хранения сведений о статистике, эта структура используется для статистики на сегодняшний день, last_7_days, last_30_days, last_60_days, last_90_days и all_time
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Sent
|
sent | integer |
Количество отправленных сообщений электронной почты для этого пользователя |
|
Жесткие отскоки
|
hard_bounces | integer |
Количество сообщений электронной почты, которые трудно отскочили для этого пользователя |
|
Мягкие отскоки
|
soft_bounces | integer |
Количество обратимых сообщений электронной почты для этого пользователя |
|
Брак
|
rejects | integer |
Количество отклоненных сообщений электронной почты для отправки этого пользователя |
|
Жалобы
|
complaints | integer |
Количество жалоб на спам для этого пользователя |
|
Отмены подписки
|
unsubs | integer |
Количество отмены подписки для этого пользователя |
|
Уникальные открытия
|
unique_opens | integer |
Количество открытых сообщений электронной почты для этого пользователя |
|
Клики
|
clicks | integer |
Число URL-адресов, которые были нажаты для этого пользователя до сих пор |
|
Уникальные щелчки
|
unique_clicks | integer |
Количество уникальных щелчков по электронной почте, отправленных этому пользователю |
SendMessageResponse
Сведения о сообщении для каждого получателя, содержащего ключ "email" с адресом электронной почты, и сведения о состоянии сообщения для этого получателя
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Адрес электронной почты
|
string |
Адрес электронной почты получателя |
|
|
Отправка состояния
|
status | string |
Состояние отправки получателя : "отправлено", "в очереди", "запланировано", "отклонено" или "недопустимо" |
|
Отклонение причины
|
reject_reason | string |
Причина отклонения, если состояние получателя "отклонено" — одно из "жесткого отскока", "soft-bounce", "спам", "unsub", "custom", "invalid-sender", "invalid-sender", "invalid", "test-mode-limit", "unsigned" или "rule |
|
Идентификатор сообщения
|
_id | string |
Уникальный идентификатор сообщения |
ListScheduledInfo
Сведения о конкретном событии SMTP
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Электронная почта получателя
|
string |
Адрес электронной почты получателя |
|
|
Состояние получателя
|
status | string |
Состояние отправки получателя : "отправлено", "в очереди", "запланировано", "отклонено" или "недопустимо" |
|
Причина отклонения
|
reject_reason | string |
Причина отклонения, если состояние получателя "отклонено" — одно из "жесткого отказа", "soft-bounce", "спам", "unsub", "custom", "invalid-sender", "invalid-sender", "invalid", "test-mode-limit", "unsigned" или "rule" |
|
Идентификатор сообщения
|
_id | string |
Уникальный идентификатор сообщения |