Levelezőlap (előzetes verzió)

A legegyszerűbb módja a levelek és képeslapok nyomtatásának és levelezésének: USPS First Class, Certified, Priority és Priority Express Mail.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	prémium	Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket: - Azure Government-régiók - Azure China-régiók - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások	prémium	Az összes Power Apps-régió , kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Power Automate	prémium	Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)

Érintkezés
Név	Levelezési űrlap támogatása
URL	https://help.mailform.io
Email	support@mailform.io

Összekötő metaadatai
Kiadó	Mailform, Inc.
Webhely	https://www.mailform.io
Adatvédelmi irányelvek	https://www.mailform.io/privacy
Szolgáltatási feltételek	https://www.mailform.io/terms
Kategóriák	Üzletvezetés; Marketing

A Mailform-összekötő lehetővé teszi, hogy a Power Automate környezetben lévő folyamatok fizikai e-maileket küldjenek: pdf-dokumentumot és néhány nyomtatási specifikációt, például szín-/fekete-fehér nyomtatást vagy simplex/duplex nyomtatást, a Mailform pedig specifikációra nyomtatja a dokumentumot, egy megfelelő borítékba csomagolja, postai küldeményt ad hozzá, és átadja az USPS-nek (és hamarosan, FedEx) az Ön nevében. Az összekötő egyetlen egyszerű módszert kínál erre: lehet például egy folyamat, amely reagál egy új felhasználó regisztrálására marketingdokumentumok küldésével, vagy egy ügyfélnek egy képeslapot küld egy kuponnal 30 nappal a megrendelés kiszállítása után.

Előfeltételek

A folytatáshoz a következőkre lesz szüksége:

Érvényes, nem nulla kredittel rendelkező Mailform-fiók (a nyomtatási és a levelezési feladatokért való fizetéshez). Ingyenes regisztráció a Mailformban

Hitelesítő adatok lekérése

Hitelesítő adatok beszerzése:

Jelentkezzen be a Mailform-fiókjába a Mailformban
Nyissa meg a Számlázási beállításokat a Mailform Billing webhelyre kattintva
Kattintson a Fiókhitel vásárlása gombra, majd a $25.00 lehetőségre a minimális jóváírás hozzáadásához.
Fejezze be a fizetési folyamatot: ezzel létrehoz egy kreditszámlát, és hitelt ad a fiókjához.
Nyissa meg az API Access beállításait az API ACCESS fülre kattintva vagy a Mailform API Access felkeresésével
Kattintson a NEW API TOKEN gombra, majd adjon meg egy címkét a jogkivonatnak (például a Power Automate teszteléséhez). A tesztelés során engedélyezheti a tesztmódot ehhez a kulcshoz: a rendszer minden API-kérést elfogad és ellenőriz, de nem küld tényleges e-mailt. A tesztmódú rendeléseket a rendszer elfogadja, majd azonnal lemondja, és nem befolyásolja a kreditegyenlegét.
Megjelenik az új API-jogkivonat: másolja le, mert nem jelenik meg többé. Vegye figyelembe, hogy a tesztmódú API-jogkivonatok soha nem kapcsolhatók ki a tesztelési módból: ha készen áll az élő módban való használatra, létre kell hoznia egy új API-jogkivonatot.

Ismerkedés az összekötővel

Az oktatóanyag online megtekintése

A Mailform használatának bemutatásához létrehozunk egy folyamatot, amely egy kuponkódot tartalmazó szórólapot küld a születésnapomra. A Power Automate szerkesztőben:

Hozzon létre egy új folyamatot a Létrehozás gombra kattintva.
Válassza az Ütemezett felhőáramlás lehetőséget.
Nevezze el a folyamatot, és adja meg a dátumot és a gyakoriságot (ebben az esetben 2023. december 27-én 12 havonta).
Kattintson a Létrehozás gombra.
Kattintson a plusz ikonra, és kattintson a Művelet hozzáadása elemre.
A párbeszédpanelen keresse meg a Mailformot, majd a Levélforma művelet használatával jelölje ki a Nyomtatás és a Levél levél vagy képeslap lehetőséget.
Adja meg a címzett és a feladó címét.
Töltse ki a dokumentumot és a nyomtatási specifikációkat: először kattintson a Speciális paraméterek lehetőségre, majd válassza az URL-címet, majd adja meg az értéket https://www.mailform.io/samples/sampleflyer.pdf. Ezután kattintson a Speciális paraméterek lehetőségre, majd válassza a színt, majd az Igen lehetőséget.
Kattintson a Szerkesztő tetején található Mentés gombra, és elkészültünk. A folyamat futtatásakor a rendelés az API-kulccsal társított Mailform-fiókba kerül.

Ismert problémák és korlátozások

A nyomtatási igazolásoknak 40 MB-nál kisebbnek kell lenniük: ha a levélben küldött PDF-dokumentum mérete meghaladja a 40 MB-ot, a fájlméret csökkentése érdekében elő kell feldolgoznia.

Gyakori hibák és jogorvoslatok

N/A

GYIK

N/A

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:


Alapértelmezett	A kapcsolat létrehozásának paraméterei.	Minden régió	Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Kötelező
API-kulcs	securestring	A kapcsolathoz használandó Mailform API-kulcs	True

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	100	60 másodperc

Műveletek

A hitelesített felhasználó lekérdezése	A hitelesített Mailform-felhasználó adatainak lekérése
Levél vagy képeslap nyomtatása és küldése a Mailform használatával	Új Mailform-rendelést hoz létre a nyomtatási bizonylat és a rendelés részleteinek megadásával (szolgáltatási osztály, szín/fekete-fehér, egyoldalas/kétoldalas nyomtatás stb.)
Meglévő rendelés lekérése	Az API-val létrehozott meglévő rendelés lekérése

A hitelesített felhasználó lekérdezése

Műveletazonosító:: GetUser

A hitelesített Mailform-felhasználó adatainak lekérése

Válaszok

Name	Elérési út	Típus
azonosító	id	string
e-mail	email	string
név	name	string
azonosító	balance.id	string
mennyiség	balance.amount	integer
pénznem	balance.currency	string

Levél vagy képeslap nyomtatása és küldése a Mailform használatával

Műveletazonosító:: CreateOrder

Új Mailform-rendelést hoz létre a nyomtatási bizonylat és a rendelés részleteinek megadásával (szolgáltatási osztály, szín/fekete-fehér, egyoldalas/kétoldalas nyomtatás stb.)

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
File	file		file	A küldendő PDF-dokumentum
URL	url		string	A PDF-ből származó URL-cím le lesz töltve
Ügyfélhivatkozás	customer_reference		string	A rendeléshez csatolandó opcionális ügyfélhivatkozás
Kézbesítési szolgáltatás	service	True	string	A használni kívánt kézbesítési szolgáltatás. A megadott értékek egyikének kell lennie
Értesítési webhook	webhook		string	A webhook, amely értesítést kap a rendelés frissítéséről
Egyoldalas/kétoldalas	simplex		boolean	Igaz, ha a dokumentumot egy lapra kell nyomtatni, hamis, ha a dokumentum a lap mindkét oldalára nyomtatható
Szín/Fekete > Fehér	color		boolean	Igaz, ha a dokumentumot színesen kell nyomtatni, hamis, ha a dokumentumot fekete-fehérre kell nyomtatni
Lapos boríték belefoglalása	flat		boolean	Igaz, ha a dokumentumot lapos borítékban kell postára adni, hamis, ha elfogadható a hajtogatott dokumentum elküldése
Visszatérési boríték belefoglalása	return_envelope		boolean	Igaz, ha a dokumentumot visszaküldési borítékkal kell postára adni. Ne adja meg, hogy nincs-e szükség visszaküldési borítékra
Valós bélyeg használata	stamp		boolean	Igaz, ha a dokumentumnak valódi postai bélyegzőt kell használnia, hamis, ha elfogadható a dokumentum forgalmi díjas postai cím vagy lenyomat használatával történő elküldése
Képeslap üzenete	message		string	A képeslap nem kép oldalára nyomtatandó üzenet. Kötelező, ha a szolgáltatás USPS_POSTCARD
Címzett neve	to.name	True	string	A boríték vagy képeslap címzettjének neve
Címzett vállalat/szervezet	to.organization		string	A címzett szervezete vagy vállalata
Címzett utcacíme	to.address1	True	string	A címzett utcaszáma és neve
Címzett lakosztálya/szobája/emelete/egységszáma	to.address2		string	A címzett lakosztálya vagy szobaszáma
Címzett város	to.city	True	string	A címzett címvárosa
Címzett állapota/területi állapota	to.state	True	string	A címzett címállapota
Címzett irányítószáma/irányítószáma	to.postcode	True	string	A címzett irányítószáma vagy irányítószáma
Címzett országa	to.country		string	A címzett cím szerinti országa
Feladó neve	from.name	True	string	A feladó neve
Feladó cége/szervezete	from.organization		string	A feladó szervezete vagy vállalata
Feladó utcacíme	from.address1	True	string	A feladó utcaszáma és neve
Feladói csomag/szoba/emelet/egységszám	from.address2		string	A feladó csomag- vagy szobaszáma
Feladó városa	from.city	True	string	A feladó címvárosa
Feladó állapota/területi állapota	from.state	True	string	A feladó címállapota
Feladó irányítószáma/irányítószáma	from.postcode	True	string	A feladó irányítószáma vagy irányítószáma
Feladó országa	from.country		string	A feladó címének országa

Válaszok

Name	Elérési út	Típus	Description
kód	error.code	string	hibakód
üzenet	error.message	string	Hibaüzenet
details	details	string	egyéb részletek
siker	success	boolean	igaz a sikerre
azonosító	data.id	string
lineitems	data.lineitems	array of object
azonosító	data.lineitems.id	string
szolgáltatás	data.lineitems.service	string

Meglévő rendelés lekérése

Műveletazonosító:: GetOrder

Az API-val létrehozott meglévő rendelés lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Levélforma rendelésazonosítója	id	True	string	A Mailform-rendelés azonosítója

Válaszok

Name	Elérési út	Típus	Description
kód	error.code	string	hibakód
üzenet	error.message	string	Hibaüzenet
details	details	string	egyéb részletek
siker	success	boolean	igaz a sikerre
azonosító	data.id	string
lineitems	data.lineitems	array of object
azonosító	data.lineitems.id	string
szolgáltatás	data.lineitems.service	string
tracking_number	data.lineitems.tracking_number	string