Mailform (предварительная версия)
Самый простой способ распечатать и почтовые письма и открытки: USPS First Class, Certified, Priority and Priority Express Mail.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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) |
| Контакт | |
|---|---|
| Имя | Поддержка mailform |
| URL | https://help.mailform.io |
| Адрес электронной почты | support@mailform.io |
| Метаданные соединителя | |
|---|---|
| Publisher | Mailform, Inc. |
| Website | https://www.mailform.io |
| Privacy Policy (Политика конфиденциальности) | https://www.mailform.io/privacy |
| Условия предоставления услуг | https://www.mailform.io/terms |
| Категории | Управление бизнесом; Маркетинг |
Соединитель Mailform позволяет потокам в среде Power Automate отправлять физическую почту: предоставьте подтверждение PDF и некоторые спецификации печати, такие как цветная и черная и белая печать или дуплексная печать, и Mailform будет печатать документ в спецификацию, ввести его в соответствующий конверт, добавить публикацию и передать ее в USPS (и в ближайшее время, FedEx) от вашего имени. Соединитель предоставляет один, простой способ сделать это: например, вы можете иметь поток, который реагирует на новую регистрацию пользователя, отправив им маркетинговые документы или отправив клиенту открытку с купоном через 30 дней после отправки заказа.
Предпосылки
Для продолжения вам потребуется следующее:
- Учетная запись Mailform с допустимой ненулевой кредитной учетной записью (для оплаты заданий печати и почты). Регистрация бесплатно в Mailform
Получение учетных данных
Чтобы получить учетные данные, выполните приведенные действия.
- Войдите в учетную запись Mailform в Mailform
- Перейдите к параметрам выставления счетов, перейдя к выставлению счетов в Mailform
- Нажмите кнопку "Кредит на счет покупки ", а затем выберите параметр $25.00 , чтобы добавить минимальный объем кредита к вашей учетной записи.
- Завершите процесс оплаты: это создаст кредитную учетную запись и добавит кредит в вашу учетную запись.
- Перейдите к параметрам доступа к API, щелкнув вкладку "ДОСТУП к API" или перейдя к API mailform API Access
- Нажмите кнопку NEW API TOKEN , а затем присвойте маркер метке (например , Power Automate Testing). Во время тестирования можно включить режим тестирования для этого ключа: все запросы API будут приняты и проверены, но фактические сообщения не будут отправлены. Заказы в режиме тестирования будут приняты, а затем немедленно отменены и не повлияют на ваш кредитный баланс.
- Будет показан новый маркер API: скопируйте его вниз, так как он не будет отображаться когда-либо снова. Обратите внимание, что маркеры API тестового режима никогда не могут быть переключаются из тестового режима: когда вы будете готовы к работе, вам потребуется создать новый маркер API.
Начало работы с соединителем
Просмотр этого руководства в Интернете
Чтобы продемонстрировать использование Mailform, мы создадим поток, который отправит флайер с кодом купона на мой день рождения. В редакторе Power Automate:
- Создайте новый поток, нажав кнопку "Создать".
- Выберите параметр "Запланированный облачный поток".
- Назовите поток и задайте дату и частоту (в данном случае каждые 12 месяцев 27 декабря 2023 г.).
- Нажмите кнопку "Создать".
- Щелкните значок плюса и нажмите кнопку "Добавить действие".
- В диалоговом окне найдите Mailform, а затем выберите "Печать" и "Почта" письмо или открытку с помощью действия Mailform.
- Заполните адреса получателя и отправителя.
- Заполните документ и печатать спецификации: сначала щелкните параметр "Дополнительные параметры", а затем выберите URL-адрес, а затем введите значение https://www.mailform.io/samples/sampleflyer.pdf. Затем выберите параметр "Дополнительные параметры", а затем выберите цвет, а затем нажмите кнопку "Да".
- Нажмите кнопку "Сохранить" в верхней части редактора, и мы закончим. При выполнении потока заказ будет помещен в учетную запись Mailform, связанную с ключом API.
Известные проблемы и ограничения
- Проверка печати должна быть меньше 40 МБ: если pdf-документ, который вы отправляете, составляет более 40 МБ, необходимо предварительно обработать его, чтобы уменьшить размер файла.
Распространенные ошибки и средства устранения неполадок
N/A
Часто задаваемые вопросы
N/A
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Ключ API mailform, используемый для этого подключения | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Возвращает прошедшего проверку подлинности пользователя |
Получение сведений о прошедшем проверку подлинности пользователя Mailform |
| Возвращает существующий заказ |
Получение существующего заказа, созданного с помощью API |
| Печать и почта письма или открытки с помощью Mailform |
Создает новый заказ mailform, предоставляя правописание печати, а также сведения о заказе (класс обслуживания, цвет/черный и белый, односторонняя и двусторонняя печать и многое другое) |
Возвращает прошедшего проверку подлинности пользователя
Получение сведений о прошедшем проверку подлинности пользователя Mailform
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | string | |
|
электронная почта
|
string | ||
|
имя
|
name | string | |
|
id
|
balance.id | string | |
|
количество
|
balance.amount | integer | |
|
currency
|
balance.currency | string |
Возвращает существующий заказ
Получение существующего заказа, созданного с помощью API
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор заказа почты
|
id | True | string |
Идентификатор заказа Mailform |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
код
|
error.code | string |
код ошибки |
|
сообщение
|
error.message | string |
сообщение об ошибке |
|
details
|
details | string |
другие сведения |
|
success
|
success | boolean |
значение true для успешного выполнения |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
услуга
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |
Печать и почта письма или открытки с помощью Mailform
Создает новый заказ mailform, предоставляя правописание печати, а также сведения о заказе (класс обслуживания, цвет/черный и белый, односторонняя и двусторонняя печать и многое другое)
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Файл
|
file | file |
Pdf-документ для отправки |
|
|
URL
|
url | string |
URL-адрес из PDF-файла будет скачан |
|
|
Справочник по клиенту
|
customer_reference | string |
Необязательная ссылка на клиента, присоединенная к заказу |
|
|
Служба доставки
|
service | True | string |
Используемая служба доставки. Должно быть одним из указанных значений. |
|
Веб-перехватчик уведомлений
|
webhook | string |
Веб-перехватчик, который должен получать уведомления о обновлении заказа для этого заказа |
|
|
Одна/двойная сторона
|
simplex | boolean |
Значение true, если документ должен быть напечатан на одной странице на листе, значение false, если документ можно распечатать на обеих сторонах листа. |
|
|
Цвет/черный и белый
|
color | boolean |
Значение true, если документ должен быть напечатан цветом, значение false, если документ должен быть напечатан в черно-белом |
|
|
Включение неструктурированного конверта
|
flat | boolean |
Значение true, если документ должен быть отправлен в плоском конверте, значение false, если оно допустимо для отправки документа в свернутый документ |
|
|
Включение обратного конверта
|
return_envelope | boolean |
Значение True, если документ должен быть отправлен с помощью обратного конверта. Не указывайте, требуется ли конверт возврата |
|
|
Использование реальной метки
|
stamp | boolean |
Значение true, если документ ДОЛЖЕН использовать реальную метку почты, значение false, если оно приемлемо для отправки документа с использованием лимитной почты или отпечаток |
|
|
Сообщение с открыткой
|
message | string |
Сообщение, которое должно быть напечатано на стороне карточки, отличной от рисунка. Обязательный, если для службы задано значение USPS_POSTCARD |
|
|
Имя получателя
|
to.name | True | string |
Имя получателя этого конверта или открытки |
|
Получатель компании или организации
|
to.organization | string |
Организация или компания получателя |
|
|
Адрес улицы получателя
|
to.address1 | True | string |
Номер улицы и имя получателя |
|
Номер набора получателей, комнаты, пола и единицы
|
to.address2 | string |
Номер номера или номера получателя |
|
|
Город получателей
|
to.city | True | string |
Адресный город получателя |
|
Состояние получателя или локальность
|
to.state | True | string |
Состояние адреса получателя |
|
Почтовый код получателя или почтовый индекс
|
to.postcode | True | string |
Почтовый код или почтовый индекс получателя |
|
Страна получателя
|
to.country | string |
Адресная страна получателя |
|
|
Имя отправителя
|
from.name | True | string |
Имя отправителя |
|
Компания отправителя или организация
|
from.organization | string |
Организация или компания отправителя |
|
|
Адрес улицы отправителя
|
from.address1 | True | string |
Номер улицы и имя отправителя |
|
Номер отправителя, комната, этаж или номер единицы
|
from.address2 | string |
Номер набора или номера отправителя |
|
|
Город отправителя
|
from.city | True | string |
Адресный город отправителя |
|
Состояние отправителя или локальность
|
from.state | True | string |
Состояние адреса отправителя |
|
Почтовый код отправителя или почтовый индекс
|
from.postcode | True | string |
Почтовый код или почтовый индекс отправителя |
|
Страна отправителя
|
from.country | string |
Адресная страна отправителя |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
код
|
error.code | string |
код ошибки |
|
сообщение
|
error.message | string |
сообщение об ошибке |
|
details
|
details | string |
другие сведения |
|
success
|
success | boolean |
значение true для успешного выполнения |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
услуга
|
data.lineitems.service | string |