Mailform (Preview)
Nejjednodušší způsob, jak vytisknout a odeslat dopisy a pohlednice: USPS First Class, Certified, Priority a Priority Express Mail.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Power Automate | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Podpora e-mailového formuláře |
| URL | https://help.mailform.io |
| support@mailform.io |
| Metadata konektoru | |
|---|---|
| Vydavatel | Mailform, Inc. |
| Internetová stránka | https://www.mailform.io |
| Zásady ochrany osobních údajů | https://www.mailform.io/privacy |
| Podmínky služby | https://www.mailform.io/terms |
| Kategorie | Řízení podniku; Marketing |
Konektor Mailform umožňuje tokům v prostředí Power Automate odesílat fyzickou poštu: poskytují doklad o formátu PDF a některé specifikace tisku, jako je barevný/černobílý tisk nebo jednoduchý/duplexní tisk, a Mailform vytiskne dokument do specifikace, vloží ho do příslušné obálky, přidá postage a předá ho do USPS (a brzy, FedEx) vaším jménem. Konektor nabízí jednu jednoduchou metodu, jak to udělat: můžete mít například tok, který reaguje na registraci nového uživatele odesláním marketingových dokumentů nebo odesláním zákazníka pohlednici s kupónem 30 dnů po odeslání objednávky.
Požadavky
Abyste mohli pokračovat, budete potřebovat následující:
- Účet Mailform s platným, nenulovým kreditním účtem (pro platby za tiskové a poštovní úlohy). Registrace zdarma v Mailformu
Jak získat přihlašovací údaje
Získání přihlašovacích údajů:
- Přihlaste se ke svému účtu Mailform ve službě Mailform.
- Přejděte do nastavení fakturace na webu Mailform Billing.
- Klikněte na tlačítko Kredit nákupního účtu a potom kliknutím na možnost 25,00 USD přidejte do svého účtu minimální částku kreditu.
- Dokončete proces platby: Tím vytvoříte platební účet a přidáte kredit na váš účet.
- Přejděte do nastavení přístupu k rozhraní API kliknutím na kartu PŘÍSTUP k rozhraní API nebo na webu Mailform API Access.
- Klikněte na tlačítko NOVÝ TOKEN rozhraní API a dejte tokenu popisek (například Testování Power Automate). Při testování můžete pro tento klíč povolit testovací režim: všechny požadavky rozhraní API budou přijaty a ověřeny, ale nebudou odeslány žádné skutečné e-maily. Objednávky testovacího režimu budou přijaty a okamžitě zrušeny a nebudou mít vliv na zůstatek kreditu.
- Zobrazí se nový token rozhraní API: zkopírujte ho dolů, protože se už nikdy nezobrazí . Mějte na paměti, že tokeny rozhraní API testovacího režimu se nikdy nedají přepnout z testovacího režimu: až budete připraveni k živému provozu, budete muset vytvořit nový token rozhraní API.
Začínáme s konektorem
Abychom si ukázali použití mailformu, vytvoříme tok, který pošle leták s kódem kupónu na mé narozeniny. V editoru Power Automate:
- Kliknutím na tlačítko Vytvořit vytvořte nový tok.
- Vyberte možnost Naplánovaný tok cloudu.
- Pojmenujte tok a nastavte datum a frekvenci (v tomto případě každých 12 měsíců 27. prosince 2023).
- Klikněte na tlačítko Vytvořit.
- Klikněte na ikonu plus a klikněte na Přidat akci.
- V dialogovém okně vyhledejte položku Mailform a pak pomocí akce Formulář pošty vyberte tisk a odeslání dopisu nebo pohlednice.
- Vyplňte adresy příjemce a odesílatele.
- Vyplňte specifikace dokumentu a tisku: nejprve klikněte na možnost Upřesnit parametry a pak vyberte adresu URL a zadejte hodnotu https://www.mailform.io/samples/sampleflyer.pdf. Potom klikněte na možnost Upřesnit parametry a pak vyberte barvu a pak vyberte Ano.
- Klikněte na tlačítko Uložit v horní části editoru a máme hotovo. Po spuštění toku se objednávka umístí do účtu Mailform přidruženého k klíči rozhraní API.
Známé problémy a omezení
- Tisky musí být menší než 40 MB: Pokud je dokument PDF, který odesíláte, větší než 40 MB, budete ho muset předem zpracovat, aby se zmenšila velikost souboru.
Běžné chyby a nápravné prostředky
N/A
časté otázky
N/A
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Klíč rozhraní API | securestring | Klíč rozhraní API mailformu, který se má použít pro toto připojení | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Vytiskne a odešle dopis nebo pohlednici pomocí formuláře Mailform. |
Vytvoří novou objednávku formuláře Pošty tak, že poskytne doklad o tisku a také podrobnosti objednávky (třída služby, barva/černá a bílá, jednostranný/oboustranný tisk a další). |
| Získá existující objednávku. |
Načtení existující objednávky vytvořené prostřednictvím rozhraní API |
| Získá ověřeného uživatele. |
Načtení informací o ověřeném uživateli mailformu |
Vytiskne a odešle dopis nebo pohlednici pomocí formuláře Mailform.
Vytvoří novou objednávku formuláře Pošty tak, že poskytne doklad o tisku a také podrobnosti objednávky (třída služby, barva/černá a bílá, jednostranný/oboustranný tisk a další).
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
File
|
file | file |
Dokument PDF, který se má poslat e-mailem |
|
|
URL
|
url | string |
Adresa URL z PDF se stáhne. |
|
|
Referenční informace pro zákazníky
|
customer_reference | string |
Volitelný odkaz na zákazníka, který se má připojit k objednávce |
|
|
Delivery Service
|
service | True | string |
Doručovací služba, která se má použít. Musí to být jedna ze zadaných hodnot. |
|
Webhook oznámení
|
webhook | string |
Webhook, který by měl dostávat oznámení o aktualizacích objednávek této objednávky |
|
|
Jednoduché nebo oboustranné
|
simplex | boolean |
Hodnota True, pokud má být dokument vytištěn na list o jednu stránku, nepravda, pokud lze dokument vytisknout na obě strany listu. |
|
|
Barva/černá a bílá
|
color | boolean |
Hodnota True, pokud má být dokument vytištěn barevně, nepravda, pokud má být dokument vytištěn černobíle |
|
|
Zahrnout plochou obálku
|
flat | boolean |
Hodnota True, pokud musí být dokument zasílána v ploché obálce, nepravda, pokud je přijatelné poslat dokument přeložený |
|
|
Zahrnout zpáteční obálku
|
return_envelope | boolean |
Hodnota True, pokud musí být dokument zasílána se zpáteční obálkou. Nezadávejte, pokud není potřeba žádná zpáteční obálka. |
|
|
Použít skutečné razítko
|
stamp | boolean |
Hodnota True, pokud dokument musí používat skutečné razítko poštovného, nepravda, pokud je přijatelné odeslat dokument pomocí měřeného poštovného nebo otisku. |
|
|
Zpráva pohlednice
|
message | string |
Zpráva, která se má vytisknout na stranu bez obrázku pohlednice. Vyžaduje se, pokud je služba nastavená na USPS_POSTCARD |
|
|
Jméno příjemce
|
to.name | True | string |
Jméno příjemce této obálky nebo pohlednice |
|
Příjemce – společnost nebo organizace
|
to.organization | string |
Organizace nebo společnost příjemce |
|
|
Adresa příjemce
|
to.address1 | True | string |
Číslo ulice a jméno příjemce |
|
Apartmá s příjemcem, pokoj, podlaha/ číslo jednotky
|
to.address2 | string |
Apartmá nebo číslo pokoje příjemce |
|
|
Město příjemce
|
to.city | True | string |
Město adresy příjemce |
|
State/Locality příjemce
|
to.state | True | string |
Stav adresy příjemce |
|
Psč příjemce / PSČ
|
to.postcode | True | string |
Psč nebo PSČ příjemce |
|
Země příjemce
|
to.country | string |
Země adresy příjemce |
|
|
Jméno odesílatele
|
from.name | True | string |
Jméno odesílatele |
|
Sender Company /Organization
|
from.organization | string |
Organizace nebo společnost odesílatele |
|
|
Poštovní adresa odesílatele
|
from.address1 | True | string |
Číslo ulice a jméno odesílatele |
|
Sender Suite/Room/Floor/Unit Number
|
from.address2 | string |
Apartmá nebo číslo místnosti odesílatele |
|
|
Město odesílatele
|
from.city | True | string |
Město adresy odesílatele |
|
Stav/lokalita odesílatele
|
from.state | True | string |
Stav adresy odesílatele |
|
Psč/PSČ odesílatele
|
from.postcode | True | string |
Psč nebo PSČ odesílatele |
|
Země odesílatele
|
from.country | string |
Země adresy odesílatele |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
kód
|
error.code | string |
kód chyby |
|
zpráva
|
error.message | string |
zpráva o chybě |
|
Podrobnosti
|
details | string |
další podrobnosti |
|
úspěch
|
success | boolean |
true při úspěchu |
|
identifikační číslo
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
identifikační číslo
|
data.lineitems.id | string | |
|
služba
|
data.lineitems.service | string |
Získá existující objednávku.
Načtení existující objednávky vytvořené prostřednictvím rozhraní API
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID objednávky poštovního formuláře
|
id | True | string |
ID objednávky formuláře pošty |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
kód
|
error.code | string |
kód chyby |
|
zpráva
|
error.message | string |
zpráva o chybě |
|
Podrobnosti
|
details | string |
další podrobnosti |
|
úspěch
|
success | boolean |
true při úspěchu |
|
identifikační číslo
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
identifikační číslo
|
data.lineitems.id | string | |
|
služba
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |
Získá ověřeného uživatele.
Načtení informací o ověřeném uživateli mailformu
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
identifikační číslo
|
id | string | |
|
e-mail
|
string | ||
|
název
|
name | string | |
|
identifikační číslo
|
balance.id | string | |
|
částky
|
balance.amount | integer | |
|
měna
|
balance.currency | string |