Mailgun (Vorschau)
Mailgun bietet leistungsstarke APIs zum Senden, Empfangen, Nachverfolgen und Speichern von E-Mails. Verwenden Sie diesen Connector, um E-Mail-Übermittlungs- und Kommunikationsworkflows zu automatisieren, ohne Code zu schreiben.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Service | 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 | Standard | 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 | Supportkanal |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Sinch Schweden AB |
| Website | https://www.mailgun.com |
| Datenschutzrichtlinie | https://www.mailgun.com/legal/privacy-policy/ |
| Kategorien | Marketing; Vertrieb und CRM |
Name des Connectors
Mailgun
Connectorzusammenfassung
Mit dem Mailgun-Connector können Power Automate Benutzer E-Mails senden, E-Mail-Domäneninformationen abrufen, einzelne E-Mail-Adressen überprüfen, Massenüberprüfungsaufträge senden und Massenüberprüfungsergebnisse mithilfe ihres Mailgun-Kontos abrufen.
Kontakt
Kontakt-URL: https://help.mailgun.com/hc/en-us
Support-/Kontakt-E-Mail: support@mailgun.com
Anmelde-URL: https://signup.mailgun.com/
Anforderungen
- Ein Mailgun-Konto. Wenn Sie keins haben, melden Sie sich bei https://signup.mailgun.com/.
- Ein Mailgun-API-Schlüssel oder domänenversandenden Schlüssel.
- Die richtige Mailgun-API-Region für Ihr Konto: USA oder EU.
- Zum Senden von E-Mails wird eine Mailgun-Domäne gesendet. Für das Senden der Produktion ist eine überprüfte Domäne erforderlich.
- Für Überprüfungsaktionen greifen Sie auf "Mailgun Validate" zu.
Sandkastendomänen können für anfängliche Tests verwendet werden, sind jedoch auf autorisierte Empfänger beschränkt.
So erhalten Sie Anmeldeinformationen
Dieser Connector verwendet die Mailgun-API-Schlüsselauthentifizierung. Melden Sie sich bei der Mailgun-Systemsteuerung an, und erstellen Sie einen API-Schlüssel aus DER API-Sicherheit, oder erstellen Sie einen domänenspezifischen Sende-API-Schlüssel aus Ihren sendenden Domäneneinstellungen.
Der Connector verwendet die Standardauthentifizierung api als Benutzername und den Mailgun-API-Schlüssel als Kennwort. Wählen Sie während der Verbindungseinrichtung die Mailgun-API-Region aus, die Ihrem Konto entspricht.
Unterstützte Vorgänge
Dieser Connector unterstützt die folgenden Vorgänge:
-
Send Email: Senden Sie eine E-Mail mit einer Mailgun-Sendedomäne. -
Get Domain Information: Abrufen von E-Mailgun-Domäneninformationen. -
Validate Email Address: Überprüfen einer einzelnen E-Mail-Adresse. -
Submit Bulk Validation Job: Senden eines Massen-E-Mail-Überprüfungsauftrags. -
Get Bulk Validation Results: Abrufen der Ergebnisse der Massen-E-Mail-Überprüfung.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Default
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 | Beschreibung | Required |
|---|---|---|---|
| API-Schlüssel | Securestring | Der private API-Schlüssel "Mailgun" | True |
| Mailgun-Region | Schnur | Select Mailgun US or Mailgun EU | True |
Aktionen
| Abrufen von Domänen |
Ruft die Liste der Domänen ab. Kann nach Bundesland oder Autorität gefiltert werden. Die Liste ist ausgelagert und auf 1000 Elemente pro Seite beschränkt. |
| Abrufen von Domänendetails |
Ruft DIE JSON-Darstellung einer Domäne ab, die Details zum Status und den Einstellungen der Domäne enthält. |
| E-Mail senden |
Sendet eine E-Mail mit Ihrem Mailgun-Konto über mehrteilige Formularfelder, die mit der Nachrichten-API von Mailgun kompatibel sind. |
| E-Mail überprüfen |
Überprüft eine E-Mail-Adresse mithilfe des Überprüfungsdiensts von Mailgun und gibt Ergebnisse der Lieferbarkeit zurück. |
| Massen-E-Mail-Überprüfung |
Laden Sie eine CSV-Datei mit einer Spalte für die E-Mail-Kopfzeile hoch, und starten Sie einen Massenüberprüfungsauftrag mithilfe der V4-API von Mailgun. |
| Massenüberprüfungsergebnisse abrufen |
Ruft den Status des Massenüberprüfungsauftrags und die Zusammenfassungsergebnisse für einen zuvor übermittelten Auftrag ab. |
Abrufen von Domänen
Ruft die Liste der Domänen ab. Kann nach Bundesland oder Autorität gefiltert werden. Die Liste ist ausgelagert und auf 1000 Elemente pro Seite beschränkt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Maximale Anzahl von Elementen. Max: 1000. Standard: 100 |
|
|
Überspringen
|
skip | integer |
Ruft die Liste der Elemente ab dem nth-Element ab. Standardwert: 0 |
|
|
State
|
state | string |
Rufen Sie nur Domänen mit einem bestimmten Zustand ab. Kann entweder aktiv, nicht überprüft oder deaktiviert sein. |
|
|
Sortieren
|
sort | string |
Gültige Sortieroptionen sind Name (asc), name:asc oder name:desc. |
|
|
Autorität
|
authority | string |
Rufen Sie nur Domänen mit einer bestimmten Autorität ab. |
|
|
Search
|
search | string |
Durchsuchen Sie Domänen nach dem angegebenen teil- oder vollständigen Namen. Unterstützt keine Wildcards. |
|
|
Unterkonten einschließen
|
include_subaccounts | boolean |
Suchen Sie nach jeder Domäne, die zu allen Unterkonten unter diesem Konto gehört. Standardwert: false. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
total_count
|
total_count | integer |
Gesamtzahl der Domänen |
|
items
|
items | array of object |
Liste der Domänen |
|
id
|
items.id | string |
Eindeutiger Bezeichner der Domäne |
|
Name
|
items.name | string |
Vollqualifizierter Domänenname, der bei Mailgun registriert ist |
|
state
|
items.state | string |
Aktueller Überprüfungsstatus der Domäne |
|
Art
|
items.type | string |
Klassifizierung der Domäne. Mögliche Werte sind benutzerdefinierte oder Sandkasten |
|
erstellt_am
|
items.created_at | string |
Zeitstempel, der angibt, wann die Domäne im RFC1123 Format erstellt wurde |
|
is_disabled
|
items.is_disabled | boolean |
Gibt an, ob die Domäne derzeit deaktiviert ist. |
|
require_tls
|
items.require_tls | boolean |
Wenn true Mailgun nur Nachrichten über eine TLS-Verbindung sendet |
|
skip_verification
|
items.skip_verification | boolean |
Wenn "true Mailgun" das Zertifikat und den Hostnamen beim Einrichten einer TLS-Verbindung nicht überprüft |
|
smtp_login
|
items.smtp_login | string |
SMTP-Anmeldename für die Domäne |
|
smtp_password
|
items.smtp_password | string |
Optionales SMTP-Kennwort für die Domäne, die für die SMTP-Authentifizierung verwendet wird |
|
spam_action
|
items.spam_action | string |
Aktion, die ausgeführt werden soll, wenn eine Nachricht als Spam gekennzeichnet wird. Optionen sind deaktiviert, Tag oder Block |
|
Wildcard
|
items.wildcard | boolean |
Gibt an, ob es sich bei der Domäne um eine Wildcarddomäne handelt und E-Mails für jede Unterdomäne empfangen kann. |
|
subaccount_id
|
items.subaccount_id | string |
Die Unterkonto-ID, zu der die Domäne gehört |
|
tracking_host
|
items.tracking_host | string |
Benutzerdefinierter Tracking-Host für die Domäne, die für die Nachverfolgung verwendet wird, wird geöffnet und Klicks |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Wenn true Mailgun die DKIM-Schlüsselgenerierung und die DNS-Eintragskonfiguration automatisch verwaltet |
|
web_prefix
|
items.web_prefix | string |
Unterdomänenpräfix, das zum Öffnen und Klicken zum Nachverfolgen verwendet wird |
|
web_scheme
|
items.web_scheme | string |
Für die Nachverfolgung verwendete Protokollschema |
|
archive_to
|
items.archive_to | string |
URL, in der eine Kopie jeder erfolgreich zugestellten Nachricht veröffentlicht wird |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Wenn true eingehende Nachrichten an diese Domäne verschlüsselt werden |
|
message_ttl
|
items.message_ttl | integer |
Gibt die TTL (Time-to-Live) in Sekunden zum Abrufen eingehender und ausgehender Nachrichten an. |
Abrufen von Domänendetails
Ruft DIE JSON-Darstellung einer Domäne ab, die Details zum Status und den Einstellungen der Domäne enthält.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Domänenname
|
name | True | string |
Der Name der Domäne, die Sie abrufen möchten |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
domain.id | string |
Eindeutiger Bezeichner der Domäne |
|
Name
|
domain.name | string |
Vollqualifizierter Domänenname, der bei Mailgun registriert ist |
|
state
|
domain.state | string |
Aktueller Überprüfungsstatus der Domäne |
|
Art
|
domain.type | string |
Klassifizierung der Domäne. Mögliche Werte sind benutzerdefinierte oder Sandkasten |
|
erstellt_am
|
domain.created_at | string |
Zeitstempel, der angibt, wann die Domäne im RFC1123 Format erstellt wurde |
|
is_disabled
|
domain.is_disabled | boolean |
Gibt an, ob die Domäne derzeit deaktiviert ist. |
|
require_tls
|
domain.require_tls | boolean |
Wenn true Mailgun nur Nachrichten über eine TLS-Verbindung sendet |
|
skip_verification
|
domain.skip_verification | boolean |
Wenn "true Mailgun" das Zertifikat und den Hostnamen beim Einrichten einer TLS-Verbindung nicht überprüft |
|
smtp_login
|
domain.smtp_login | string |
SMTP-Anmeldename für die Domäne |
|
smtp_password
|
domain.smtp_password | string |
Optionales SMTP-Kennwort für die Domäne, die für die SMTP-Authentifizierung verwendet wird |
|
spam_action
|
domain.spam_action | string |
Aktion, die ausgeführt werden soll, wenn eine Nachricht als Spam gekennzeichnet wird. Optionen sind deaktiviert, Tag oder Block |
|
Wildcard
|
domain.wildcard | boolean |
Gibt an, ob es sich bei der Domäne um eine Wildcarddomäne handelt und E-Mails für jede Unterdomäne empfangen kann. |
|
subaccount_id
|
domain.subaccount_id | string |
Die Unterkonto-ID, zu der die Domäne gehört |
|
tracking_host
|
domain.tracking_host | string |
Benutzerdefinierter Tracking-Host für die Domäne, die für die Nachverfolgung verwendet wird, wird geöffnet und Klicks |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Wenn true Mailgun die DKIM-Schlüsselgenerierung und die DNS-Eintragskonfiguration automatisch verwaltet |
|
web_prefix
|
domain.web_prefix | string |
Unterdomänenpräfix, das zum Öffnen und Klicken zum Nachverfolgen verwendet wird |
|
web_scheme
|
domain.web_scheme | string |
Für die Nachverfolgung verwendete Protokollschema |
|
archive_to
|
domain.archive_to | string |
URL, in der eine Kopie jeder erfolgreich zugestellten Nachricht veröffentlicht wird |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Wenn true eingehende Nachrichten an diese Domäne verschlüsselt werden |
|
message_ttl
|
domain.message_ttl | integer |
Gibt die TTL (Time-to-Live) in Sekunden zum Abrufen eingehender und ausgehender Nachrichten an. |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Liste der für den Empfang von E-Mails erforderlichen DNS-Einträge |
|
is_active
|
receiving_dns_records.is_active | boolean |
Gibt an, ob der DNS-Eintrag zurzeit aktiv ist. |
|
Zwischengespeichert
|
receiving_dns_records.cached | array of string |
Liste der zwischengespeicherten Werte für den DNS-Eintrag |
|
Name
|
receiving_dns_records.name | string |
Name des DNS-Eintrags, falls zutreffend |
|
Priorität
|
receiving_dns_records.priority | string |
Prioritätswert für MX-DNS-Einträge |
|
record_type
|
receiving_dns_records.record_type | string |
Dns-Eintragstyp wie MX, TXT oder CNAME |
|
Gültig
|
receiving_dns_records.valid | string |
Gibt an, ob der DNS-Eintrag gültig ist. |
|
value
|
receiving_dns_records.value | string |
Erwarteter Wert des DNS-Eintrags |
|
sending_dns_records
|
sending_dns_records | array of object |
Liste der zum Senden von E-Mails erforderlichen DNS-Einträge |
|
is_active
|
sending_dns_records.is_active | boolean |
Gibt an, ob der DNS-Eintrag zurzeit aktiv ist. |
|
Zwischengespeichert
|
sending_dns_records.cached | array of string |
Liste der zwischengespeicherten Werte für den DNS-Eintrag |
|
Name
|
sending_dns_records.name | string |
Name des DNS-Eintrags, falls zutreffend |
|
Priorität
|
sending_dns_records.priority | string |
Prioritätswert für MX-DNS-Einträge |
|
record_type
|
sending_dns_records.record_type | string |
Dns-Eintragstyp wie MX, TXT oder CNAME |
|
Gültig
|
sending_dns_records.valid | string |
Gibt an, ob der DNS-Eintrag gültig ist. |
|
value
|
sending_dns_records.value | string |
Erwarteter Wert des DNS-Eintrags |
E-Mail senden
Sendet eine E-Mail mit Ihrem Mailgun-Konto über mehrteilige Formularfelder, die mit der Nachrichten-API von Mailgun kompatibel sind.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Domänenname
|
domain_name | True | string |
Die Domäne, von der die E-Mail gesendet werden soll |
|
Von E-Mail-Adresse
|
from | True | string |
Die E-Mail-Adresse, von der die Nachricht gesendet wird. |
|
An E-Mail-Adresse
|
to | True | string |
E-Mail-Adresse des Empfängers. |
|
Betreff
|
subject | True | string |
Der Betreff der E-Mail. |
|
E-Mail-Text (Text)
|
text | string |
Nur-Text der E-Mail. |
|
|
E-Mail-Text (HTML)
|
html | html |
HTML-Textkörper der E-Mail. |
|
|
CC-E-Mail-Adresse
|
cc | string |
E-Mail-Adresse des Empfängers per Carbon copy. |
|
|
BCC-E-Mail-Adresse
|
bcc | string |
E-Mail-Adresse des Blindkopieempfängers. |
|
|
Reply-To E-Mail-Adresse
|
h:Reply-To | string |
Wo Antworten übermittelt werden sollen. |
|
|
Anhang
|
attachment | file |
Dateianlage, die in die Nachricht eingeschlossen werden soll. |
|
|
Tags
|
o:tag | array |
Ein oder mehrere Tags zum Gruppieren und Filtern von E-Mails in Mailgun (bis zu 10 pro Nachricht). |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Meldungs-ID
|
id | string |
Eindeutiger Bezeichner, der der in die Warteschlange eingereihten Nachricht zugewiesen ist |
|
Statusmeldung
|
message | string |
Lesbarer Status von Mailgun (z. B. in der Warteschlange). Vielen Dank.) |
E-Mail überprüfen
Überprüft eine E-Mail-Adresse mithilfe des Überprüfungsdiensts von Mailgun und gibt Ergebnisse der Lieferbarkeit zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
E‑Mail-Adresse
|
address | True | string |
Die zu überprüfende E-Mail-Adresse. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
E‑Mail-Adresse
|
address | string |
Die E-Mail-Adresse, die überprüft wurde |
|
Ist gültig
|
is_valid | boolean |
Gibt an, ob Mailgun die Adresse als gültig betrachtet. |
|
Postfachüberprüfung
|
mailbox_verification | string |
Postfachüberprüfungsstatus |
|
Ist Einwegadresse
|
is_disposable_address | boolean |
Gibt an, ob die Adresse von einem einwegbaren Anbieter stammt. |
|
Ist Rollenadresse
|
is_role_address | boolean |
Gibt an, ob es sich bei der Adresse um eine rollenbasierte Adresse handelt. |
|
Überprüfungsgrund
|
reason | array of string |
Überprüfungsgründe, die von Mailgun zurückgegeben werden (leer, wenn gültig) |
|
Risikostufe
|
risk | string |
Risikostufe, die von Mailgun zugewiesen wurde |
|
Result
|
result | string |
Ergebnis der Lieferfähigkeit von Mailgun (z. B. Lieferumfang oder nicht zustellbar) |
|
Stammadresse
|
root_address | string |
Normalisierte Stammadresse |
|
Anzeigename
|
parts.display_name | string |
Anzeigenameteil der Adresse |
|
Domäne
|
parts.domain | string |
Domänenteil der Adresse |
|
Lokales Webpart
|
parts.local_part | string |
Lokaler Teil der Adresse |
Massen-E-Mail-Überprüfung
Laden Sie eine CSV-Datei mit einer Spalte für die E-Mail-Kopfzeile hoch, und starten Sie einen Massenüberprüfungsauftrag mithilfe der V4-API von Mailgun.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Auftragslistenname
|
list_id | True | string |
Path-Parameter, der den Massenüberprüfungsauftrag identifiziert. |
|
CSV-Datei
|
file | True | file |
CSV-Datei, die hochgeladen werden soll. Die Datei muss eine Kopfzeile mit dem Namen "E-Mail" enthalten. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Auftrags-ID (Listenname)
|
id | string |
Auftragsbezeichner (Listenname) |
|
Servernachricht
|
message | string |
Statusmeldung von Mailgun |
Massenüberprüfungsergebnisse abrufen
Ruft den Status des Massenüberprüfungsauftrags und die Zusammenfassungsergebnisse für einen zuvor übermittelten Auftrag ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Auftrags-ID
|
list_id | True | string |
Der Auftragsbezeichner, der von der Massenüberprüfungsanforderung zurückgegeben wird. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Auftrags-ID
|
id | string |
Auftragsbezeichner |
|
Auftrags-ID
|
list_id | string |
Auftragslistenname |
|
Auftragsstatus
|
status | string |
Aktueller Auftragsstatus |
|
Erstellt am
|
created_at | integer |
Wann der Auftrag erstellt wurde (Unix-Zeitstempel) |
|
CSV-Download-URL
|
download_url.csv | string |
URL zum Herunterladen aller Ergebnisse als CSV-Datei |
|
Kuratierte CSV-Download-URL
|
download_url.curated_csv | string |
URL zum Herunterladen kuratierter Ergebnisse als CSV-Datei |
|
JSON-Download-URL
|
download_url.json | string |
URL zum Herunterladen aller Ergebnisse als JSON-Datei |
|
Kuratierte JSON-Download-URL
|
download_url.curated_json | string |
URL zum Herunterladen kuratierter Ergebnisse als JSON-Datei |
|
Gesamtmenge
|
quantity | integer |
Gesamtzahl der Datensätze im Auftrag |
|
Verarbeitete Datensätze
|
records_processed | integer |
Anzahl der bisher verarbeiteten Datensätze |
|
Lieferumfangsanzahl
|
summary.result.deliverable | integer |
Anzahl der Lieferadressen |
|
Nicht zustellbare Anzahl
|
summary.result.undeliverable | integer |
Anzahl nicht zustellbarer Adressen |
|
Alle zählen abfangen
|
summary.result.catch_all | integer |
Anzahl der Catch-All-Adressen |
|
Anzahl nicht senden
|
summary.result.do_not_send | integer |
Anzahl der Adressen, die als "Nicht senden" gekennzeichnet sind |
|
Alle Anzahl annehmen
|
summary.result.accept_all | integer |
Anzahl der akzeptierten Adressen |
|
Unbekannte Anzahl
|
summary.result.unknown | integer |
Anzahl der Adressen mit unbekannter Lieferfähigkeit |
|
Hohe Risikoanzahl
|
summary.risk.high | integer |
Anzahl von Adressen mit hohem Risiko |
|
Mittlere Risikoanzahl
|
summary.risk.medium | integer |
Anzahl der Mittelrisikoadressen |
|
Niedrige Risikoanzahl
|
summary.risk.low | integer |
Anzahl der Risikoadressen |
|
Unbekannte Risikoanzahl
|
summary.risk.unknown | integer |
Anzahl der Adressen mit unbekanntem Risiko |
|
Sehr engagierte Anzahl
|
summary.engagement.highly_engaged | integer |
Anzahl der stark engagierten Adressen |
|
Anzahl engagierter Benutzer
|
summary.engagement.engaged | integer |
Anzahl der engagierten Adressen |
|
Nicht eingegagte Anzahl
|
summary.engagement.disengaged | integer |
Anzahl nicht eingegagter Adressen |
|
Bot-Anzahl
|
summary.engagement.bot | integer |
Anzahl der Botadressen |
|
Beschwereranzahl
|
summary.engagement.complainer | integer |
Anzahl der Beschwerdeadressen |
|
Keine Datenanzahl
|
summary.engagement.no_data | integer |
Anzahl der Adressen ohne Einsatzdaten |