E-Mailform (Vorschau)
Die einfachste Möglichkeit zum Drucken und Versenden von Briefen und Postkarten: USPS First Class, Certified, Priority und Priority Express Mail.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Mailform-Unterstützung |
| URL | https://help.mailform.io |
| support@mailform.io |
| Connectormetadaten | |
|---|---|
| Herausgeber | Mailform, Inc. |
| Webseite | https://www.mailform.io |
| Datenschutzrichtlinie | https://www.mailform.io/privacy |
| Nutzungsbedingungen | https://www.mailform.io/terms |
| Kategorien | Unternehmensführung; Marketing |
Der Mailform-Connector ermöglicht Flüssen in der Power Automate-Umgebung das Senden physischer E-Mails: Stellen Sie einen PDF-Nachweis und einige Druckspezifikationen wie Farb-/Schwarzweißdruck oder simplex/Duplexdruck bereit, und Mailform druckt das Dokument so, dass es in einem geeigneten Umschlag angegeben, Posteingang hinzugefügt und an die USPS übergeben wird (und bald, FedEx) in Ihrem Auftrag. Der Connector bietet eine einzige, einfache Methode, um dies zu tun: Sie können z. B. einen Fluss haben, der auf eine neue Benutzeranmeldung reagiert, indem Sie sie Marketingdokumente senden oder einen Kunden eine Postkarte mit einem Coupon 30 Tage nach dem Versand ihrer Bestellung senden.
Voraussetzungen
Sie benötigen Folgendes, um fortzufahren:
- Ein Mailform-Konto mit einem gültigen, nicht nulligen Kreditkonto (zum Bezahlen ihrer Druck- und E-Mail-Aufträge). Registrieren Sie sich kostenlos bei Mailform
So erhalten Sie Anmeldeinformationen
So rufen Sie Anmeldeinformationen ab:
- Melden Sie sich bei Ihrem Mailform-Konto bei Mailform an
- Wechseln Sie zu Ihren Abrechnungseinstellungen, indem Sie die Mailform-Abrechnung besuchen
- Klicken Sie auf die Schaltfläche " Kreditwürdigkeit kaufen", und klicken Sie dann auf die Option "25,00 $ ", um ihrem Konto den Mindestbetrag der Gutschrift hinzuzufügen.
- Führen Sie den Zahlungsvorgang aus: Dadurch wird ein Kreditkonto erstellt und Ihrem Konto Guthaben hinzugefügt.
- Wechseln Sie zu den API-Zugriffseinstellungen, indem Sie auf die Registerkarte "API ACCESS" oder auf "Mailform-API-Zugriff" klicken.
- Klicken Sie auf die Schaltfläche "NEUES API-TOKEN ", und geben Sie dem Token eine Bezeichnung (z. B. Power Automate-Tests). Beim Testen können Sie den Testmodus für diesen Schlüssel aktivieren: Alle API-Anforderungen werden akzeptiert und überprüft, aber es werden keine tatsächlichen E-Mails gesendet. Testmodusbestellungen werden akzeptiert und dann sofort storniert und wirken sich nicht auf Ihren Kreditsaldo aus.
- Das neue API-Token wird angezeigt: Kopieren Sie es nach unten, da es nicht mehr angezeigt wird. Beachten Sie, dass API-Token im Testmodus niemals aus dem Testmodus gewechselt werden können: Wenn Sie bereit sind, live zu gehen, müssen Sie ein neues API-Token erstellen.
Erste Schritte mit Ihrem Connector
Dieses Lernprogramm online anzeigen
Um die Verwendung von Mailform zu demonstrieren, erstellen wir einen Fluss, der einen Flyer mit einem Gutscheincode zu meinem Geburtstag sendet. Im Power Automate-Editor:
- Erstellen Sie einen neuen Fluss, indem Sie auf die Schaltfläche "Erstellen" klicken.
- Wählen Sie die Option "Geplanter Cloudfluss" aus.
- Benennen Sie den Fluss, und legen Sie das Datum und die Häufigkeit fest (in diesem Fall alle 12 Monate am 27. Dezember 2023).
- Klicken Sie auf die Schaltfläche "Erstellen".
- Klicken Sie auf das Plussymbol, und klicken Sie auf "Aktion hinzufügen".
- Suchen Sie im Dialogfeld nach "E-Mailform", und wählen Sie dann die Option "Drucken" und "Postkarten" mit der Aktion "E-Mailform" aus.
- Geben Sie die Empfänger- und Absenderadressen ein.
- Füllen Sie die Dokument- und Druckspezifikationen aus: Klicken Sie zuerst auf die Option "Erweiterte Parameter", und wählen Sie dann die URL aus, und geben Sie dann den Wert https://www.mailform.io/samples/sampleflyer.pdfein. Klicken Sie dann auf die Option "Erweiterte Parameter", und wählen Sie dann "Farbe" aus, und wählen Sie dann "Ja" aus.
- Klicken Sie oben im Editor auf die Schaltfläche "Speichern", und fertig. Wenn der Fluss ausgeführt wird, wird die Bestellung innerhalb des Mailform-Kontos platziert, das dem API-Schlüssel zugeordnet ist.
Bekannte Probleme und Einschränkungen
- Drucknachweise müssen kleiner als 40 MB sein: Wenn das PDF-Dokument, das Sie versenden, mehr als 40 MB beträgt, müssen Sie sie vorab verarbeiten, um die Dateigröße zu verringern.
Häufige Fehler und Abhilfemaßnahmen
N/A
Häufig gestellte Fragen
N/A
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der Mailform-API-Schlüssel, der für diese Verbindung verwendet werden soll | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Druckt und mailt einen Brief oder eine Postkarte mithilfe von Mailform |
Erstellt eine neue Mailform-Bestellung, indem der Drucknachweis sowie die Bestelldetails bereitgestellt werden (Serviceklasse, Farbe/Schwarzweiß, einseitiger/doppelseitiger Druck und mehr) |
| Ruft den authentifizierten Benutzer ab |
Abrufen von Informationen zum authentifizierten Mailform-Benutzer |
| Ruft eine vorhandene Bestellung ab. |
Abrufen einer vorhandenen Bestellung, die über die API erstellt wurde |
Druckt und mailt einen Brief oder eine Postkarte mithilfe von Mailform
Erstellt eine neue Mailform-Bestellung, indem der Drucknachweis sowie die Bestelldetails bereitgestellt werden (Serviceklasse, Farbe/Schwarzweiß, einseitiger/doppelseitiger Druck und mehr)
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
file | file |
Das zu sendende PDF-Dokument |
|
|
URL
|
url | string |
DIE URL aus PDF wird heruntergeladen. |
|
|
Kundenreferenz
|
customer_reference | string |
Optionaler Kundenverweis, der an die Bestellung angefügt werden soll |
|
|
Zustellungsdienst
|
service | True | string |
Der zu verwendende Zustellungsdienst. Muss einer der angegebenen Werte sein |
|
Benachrichtigungswebhook
|
webhook | string |
Der Webhook, der Benachrichtigungen zu Bestellupdates für diese Bestellung erhalten soll |
|
|
Single/Double Sided
|
simplex | boolean |
True, wenn das Dokument auf ein Blatt gedruckt werden soll, false, wenn das Dokument auf beiden Seiten eines Blatts gedruckt werden kann |
|
|
Farbe/Schwarz und Weiß
|
color | boolean |
True, wenn das Dokument in Farbe gedruckt werden soll, false, wenn das Dokument in Schwarzweiß gedruckt werden soll |
|
|
Flacher Briefumschlag einschließen
|
flat | boolean |
True, wenn das Dokument in einem flachen Umschlag gepostet werden muss, false, wenn es akzeptabel ist, das Dokument gefaltet zu senden |
|
|
Briefumschlag einschließen
|
return_envelope | boolean |
True, wenn das Dokument mit einem Briefumschlag per E-Mail versehen werden muss. Geben Sie nicht an, ob kein Rückgabeumschlag erforderlich ist. |
|
|
Verwenden eines echten Stempels
|
stamp | boolean |
True, wenn das Dokument einen echten Briefmarken verwenden muss, false, wenn es akzeptabel ist, das Dokument per getakteter Post oder einem Impressum zu senden |
|
|
Postkartennachricht
|
message | string |
Die Nachricht, die auf der Nichtbildseite einer Postkarte gedruckt werden soll. Erforderlich, wenn der Dienst auf USPS_POSTCARD festgelegt ist |
|
|
Empfängername
|
to.name | True | string |
Der Name des Empfängers dieses Umschlags oder dieser Postkarte |
|
Empfängerunternehmen/Organisation
|
to.organization | string |
Die Organisation oder das Unternehmen des Empfängers |
|
|
Adresse des Empfängers
|
to.address1 | True | string |
Die Straßennummer und der Name des Empfängers |
|
Empfängersuite/Raum/Boden/Einheitsnummer
|
to.address2 | string |
Die Suite oder die Raumnummer des Empfängers |
|
|
Empfängerstadt
|
to.city | True | string |
Die Adresse des Empfängers |
|
Empfängerstatus/Gebietsschema
|
to.state | True | string |
Der Adressstatus des Empfängers |
|
Postcode/Postleitzahl des Empfängers
|
to.postcode | True | string |
Postleitzahl oder Postleitzahl des Empfängers |
|
Empfängerland
|
to.country | string |
Das Adressland des Empfängers |
|
|
Absendername
|
from.name | True | string |
Der Name des Absenders |
|
Sender Company/Organization
|
from.organization | string |
Die Organisation oder das Unternehmen des Absenders |
|
|
Adresse des Absenders
|
from.address1 | True | string |
Die Straßennummer und der Name des Absenders |
|
Sender Suite/Room/Floor/Unit Number
|
from.address2 | string |
Die Suite oder die Raumnummer des Absenders |
|
|
Sender City
|
from.city | True | string |
Die Adresse des Absenders |
|
Sender State/Locality
|
from.state | True | string |
Der Adressstatus des Absenders |
|
Absender Postcode/Postleitzahl
|
from.postcode | True | string |
Postleitzahl oder Postleitzahl des Absenders |
|
Absenderland
|
from.country | string |
Das Adressland des Absenders |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Code
|
error.code | string |
Fehlercode |
|
message
|
error.message | string |
Fehlermeldung |
|
details
|
details | string |
Weitere Details |
|
Erfolgreich
|
success | boolean |
true bei Erfolg |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
Dienstleistung
|
data.lineitems.service | string |
Ruft den authentifizierten Benutzer ab
Abrufen von Informationen zum authentifizierten Mailform-Benutzer
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | string | |
|
E-Mail
|
string | ||
|
name
|
name | string | |
|
id
|
balance.id | string | |
|
Menge
|
balance.amount | integer | |
|
Währung
|
balance.currency | string |
Ruft eine vorhandene Bestellung ab.
Abrufen einer vorhandenen Bestellung, die über die API erstellt wurde
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
E-Mail-Bestell-ID
|
id | True | string |
Die ID der E-Mail-Bestellung |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Code
|
error.code | string |
Fehlercode |
|
message
|
error.message | string |
Fehlermeldung |
|
details
|
details | string |
Weitere Details |
|
Erfolgreich
|
success | boolean |
true bei Erfolg |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
Dienstleistung
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |