Mailgun (preview)
Mailgun biedt krachtige API's voor het verzenden, ontvangen, bijhouden en opslaan van e-mail. Gebruik deze connector om werkstromen voor e-mailbezorging en communicatie te automatiseren zonder code te schrijven.
Deze connector is beschikbaar in de volgende producten en regio's:
| Service | Class | Regio's |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logische apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Naam | Ondersteuningskanaal |
| URL | https://help.mailgun.com/hc/en-us |
| E-mailadres | support@mailgun.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Sinch Sweden AB |
| Website | https://www.mailgun.com |
| Privacybeleid | https://www.mailgun.com/legal/privacy-policy/ |
| Categorieën | Marketing; Verkoop en CRM |
Naam van de connector
Mailgun
Samenvatting van connector
Met de Mailgun-connector kunnen Power Automate gebruikers e-mail verzenden, Mailgun-domeingegevens ophalen, afzonderlijke e-mailadressen valideren, bulksgewijze e-mailvalidatietaken verzenden en bulkvalidatieresultaten ophalen met hun Mailgun-account.
Contact
URL van contactpersoon: https://help.mailgun.com/hc/en-us
E-mail voor ondersteuning/contactpersoon: support@mailgun.com
Registratie-URL: https://signup.mailgun.com/
Behoeften
- Een Mailgun-account. Als u er nog geen hebt, meldt u zich aan bij https://signup.mailgun.com/.
- Een Mailgun API-sleutel of domein die een sleutel verzendt.
- De juiste Mailgun-API-regio voor uw account: VS of EU.
- Voor het verzenden van e-mail, een Mailgun verzenden domein. Voor het verzenden van productie is een geverifieerd domein vereist.
- Voor validatieacties heeft u toegang tot Mailgun Validate.
Sandbox-domeinen kunnen worden gebruikt voor eerste tests, maar zijn beperkt tot geautoriseerde ontvangers.
Referenties ophalen
Deze connector maakt gebruik van verificatie van de Mailgun-API-sleutel. Meld u aan bij de Mailgun-Configuratiescherm en maak een API-sleutel op basis van API Security of maak een domeinspecifieke verzendende API-sleutel op basis van uw instellingen voor het verzenden van domeinen.
De connector maakt gebruik van basisverificatie met api als gebruikersnaam en de Mailgun API-sleutel als het wachtwoord. Selecteer tijdens het instellen van de verbinding de Mailgun-API-regio die overeenkomt met uw account.
Ondersteunde bewerkingen
Deze connector ondersteunt de volgende bewerkingen:
-
Send Email: Verzend een e-mail met behulp van een Mailgun verzenden domein. -
Get Domain Information: Mailgun-domeingegevens ophalen. -
Validate Email Address: Valideer een afzonderlijk e-mailadres. -
Submit Bulk Validation Job: Verzend een validatietaak voor bulksgewijze e-mail. -
Get Bulk Validation Results: Validatieresultaten voor bulk-e-mail ophalen.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Type | Beschrijving | Required |
|---|---|---|---|
| API-sleutel | beveiligde string | De persoonlijke API-sleutel van Mailgun | True |
| Mailgun-regio | snaar | Selecteer Mailgun US of Mailgun EU | True |
Acties
| Bulk-e-mailvalidatie |
Upload een CSV met een kolom met een e-mailkop en start een bulkvalidatietaak met behulp van de V4-API van Mailgun. |
| Bulkvalidatieresultaten ophalen |
Haalt de status van de bulkvalidatietaak en samenvattingsresultaten voor een eerder ingediende taak op. |
| Domeindetails ophalen |
Haalt de JSON-weergave op van een domein met details over de status en instellingen van het domein. |
| Domeinen ophalen |
Haal de lijst met domeinen op. Kan worden gefilterd op staat of instantie. De lijst is gepagineerd en beperkt tot 1000 items per pagina. |
| E-mail valideren |
Valideert een e-mailadres met behulp van de validatieservice van Mailgun en retourneert resultaten van de levering. |
| Een e-mail verzenden |
Hiermee verzendt u een e-mailbericht met uw Mailgun-account via formuliervelden met meerdere onderdelen die compatibel zijn met de berichten-API van Mailgun. |
Bulk-e-mailvalidatie
Upload een CSV met een kolom met een e-mailkop en start een bulkvalidatietaak met behulp van de V4-API van Mailgun.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Naam van takenlijst
|
list_id | True | string |
Padparameter die de bulkvalidatietaak identificeert. |
|
CSV-bestand
|
file | True | file |
CSV-bestand dat moet worden geüpload. Het bestand moet een koptekst met de naam e-mail bevatten. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Taak-id (lijstnaam)
|
id | string |
Taak-id (lijstnaam) |
|
Serverbericht
|
message | string |
Statusbericht van Mailgun |
Bulkvalidatieresultaten ophalen
Haalt de status van de bulkvalidatietaak en samenvattingsresultaten voor een eerder ingediende taak op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Job-ID
|
list_id | True | string |
De taak-id die is geretourneerd uit de bulkvalidatieaanvraag. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Job-ID
|
id | string |
Taak-id |
|
Job-ID
|
list_id | string |
Naam van takenlijst |
|
Taakstatus
|
status | string |
Huidige taakstatus |
|
Gemaakt op
|
created_at | integer |
Toen de taak is gemaakt (Unix-tijdstempel) |
|
CSV-download-URL
|
download_url.csv | string |
URL voor het downloaden van alle resultaten als csv-bestand |
|
Gecureerde CSV-download-URL
|
download_url.curated_csv | string |
URL voor het downloaden van gecureerde resultaten als een CSV-bestand |
|
JSON-download-URL
|
download_url.json | string |
URL voor het downloaden van alle resultaten als een JSON-bestand |
|
Gecureerde JSON-download-URL
|
download_url.curated_json | string |
URL voor het downloaden van gecureerde resultaten als een JSON-bestand |
|
Totale hoeveelheid
|
quantity | integer |
Totaal aantal records in de taak |
|
Verwerkte records
|
records_processed | integer |
Aantal verwerkte records tot nu toe |
|
Aantal producten
|
summary.result.deliverable | integer |
Aantal productadressen |
|
Undeliverable Count
|
summary.result.undeliverable | integer |
Aantal onbestelbare adressen |
|
Catch All Count
|
summary.result.catch_all | integer |
Aantal catch-all-adressen |
|
Aantal niet verzenden
|
summary.result.do_not_send | integer |
Aantal adressen dat is gemarkeerd als niet verzenden |
|
Alle aantallen accepteren
|
summary.result.accept_all | integer |
Aantal geaccepteerde adressen |
|
Onbekend aantal
|
summary.result.unknown | integer |
Aantal adressen met onbekende afleverbaarheid |
|
Hoog aantal risico's
|
summary.risk.high | integer |
Aantal adressen met een hoog risico |
|
Gemiddeld aantal risico's
|
summary.risk.medium | integer |
Aantal adressen met gemiddeld risico |
|
Laag aantal risico's
|
summary.risk.low | integer |
Aantal adressen met een laag risico |
|
Onbekend aantal risico's
|
summary.risk.unknown | integer |
Aantal adressen met onbekend risico |
|
Hoog betrokken aantal
|
summary.engagement.highly_engaged | integer |
Aantal zeer betrokken adressen |
|
Verloofd aantal
|
summary.engagement.engaged | integer |
Aantal betrokken adressen |
|
Niet-uitgeschakeld aantal
|
summary.engagement.disengaged | integer |
Aantal niet-uitgeschakelde adressen |
|
Aantal bots
|
summary.engagement.bot | integer |
Aantal botadressen |
|
Aantal klachten
|
summary.engagement.complainer | integer |
Aantal klaagadressen |
|
Geen gegevensaantal
|
summary.engagement.no_data | integer |
Aantal adressen zonder afspraakgegevens |
Domeindetails ophalen
Haalt de JSON-weergave op van een domein met details over de status en instellingen van het domein.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Domeinnaam
|
name | True | string |
De naam van het domein dat u wilt ophalen |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
id
|
domain.id | string |
Unieke id van het domein |
|
naam
|
domain.name | string |
Volledig gekwalificeerde domeinnaam geregistreerd bij Mailgun |
|
state
|
domain.state | string |
Huidige verificatiestatus van het domein |
|
type
|
domain.type | string |
Classificatie van het domein. Mogelijke waarden zijn aangepast of sandbox |
|
aangemaakt_op
|
domain.created_at | string |
Tijdstempel die aangeeft wanneer het domein is gemaakt in RFC1123 indeling |
|
is_disabled
|
domain.is_disabled | boolean |
Geeft aan of het domein momenteel is uitgeschakeld |
|
require_tls
|
domain.require_tls | boolean |
Als waar Mailgun alleen berichten verzendt via een TLS-verbinding |
|
skip_verification
|
domain.skip_verification | boolean |
Als waar Mailgun het certificaat en de hostnaam niet verifieert bij het instellen van een TLS-verbinding |
|
smtp_login
|
domain.smtp_login | string |
SMTP-aanmeldingsnaam voor het domein |
|
smtp_password
|
domain.smtp_password | string |
Optioneel SMTP-wachtwoord voor het domein dat wordt gebruikt voor SMTP-verificatie |
|
spam_action
|
domain.spam_action | string |
Actie die moet worden ondernomen wanneer een bericht wordt gemarkeerd als spam. Opties zijn uitgeschakeld, tag of blok |
|
jokerteken
|
domain.wildcard | boolean |
Geeft aan of het domein een domein met jokertekens is en e-mailberichten kan ontvangen voor elk subdomein |
|
subaccount_id
|
domain.subaccount_id | string |
De subaccount-id waartoe het domein behoort |
|
tracking_host
|
domain.tracking_host | string |
Aangepaste traceringshost voor het domein dat wordt gebruikt voor het bijhouden wordt geopend en klikken |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Als waar Mailgun DKIM-sleutelgeneratie en DNS-recordconfiguratie automatisch beheert |
|
web_prefix
|
domain.web_prefix | string |
Subdomeinvoorvoegsel dat wordt gebruikt voor openen en klikken op bijhouden |
|
web_scheme
|
domain.web_scheme | string |
Protocolschema dat wordt gebruikt voor het bijhouden |
|
archive_to
|
domain.archive_to | string |
URL waarnaar een kopie van elk bericht met succes wordt geplaatst |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Als binnenkomende berichten naar dit domein waar zijn, worden versleuteld |
|
message_ttl
|
domain.message_ttl | integer |
Hiermee geeft u de time-to-live (TTL) in seconden op voor het ophalen van zowel binnenkomende als uitgaande berichten |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Lijst met DNS-records die zijn vereist voor het ontvangen van e-mailberichten |
|
is_active
|
receiving_dns_records.is_active | boolean |
Geeft aan of de DNS-record momenteel actief is |
|
in cache opgeslagen
|
receiving_dns_records.cached | array of string |
Lijst met mailgun-waarden in cache voor de DNS-record |
|
naam
|
receiving_dns_records.name | string |
Naam van de DNS-record, indien van toepassing |
|
voorrang
|
receiving_dns_records.priority | string |
Prioriteitswaarde voor MX DNS-records |
|
record_type
|
receiving_dns_records.record_type | string |
Type DNS-record, zoals MX, TXT of CNAME |
|
geldig
|
receiving_dns_records.valid | string |
Geeft aan of de DNS-record geldig is |
|
value
|
receiving_dns_records.value | string |
Verwachte waarde van de DNS-record |
|
sending_dns_records
|
sending_dns_records | array of object |
Lijst met VEREISTE DNS-records voor het verzenden van e-mailberichten |
|
is_active
|
sending_dns_records.is_active | boolean |
Geeft aan of de DNS-record momenteel actief is |
|
in cache opgeslagen
|
sending_dns_records.cached | array of string |
Lijst met mailgun-waarden in cache voor de DNS-record |
|
naam
|
sending_dns_records.name | string |
Naam van de DNS-record, indien van toepassing |
|
voorrang
|
sending_dns_records.priority | string |
Prioriteitswaarde voor MX DNS-records |
|
record_type
|
sending_dns_records.record_type | string |
Type DNS-record, zoals MX, TXT of CNAME |
|
geldig
|
sending_dns_records.valid | string |
Geeft aan of de DNS-record geldig is |
|
value
|
sending_dns_records.value | string |
Verwachte waarde van de DNS-record |
Domeinen ophalen
Haal de lijst met domeinen op. Kan worden gefilterd op staat of instantie. De lijst is gepagineerd en beperkt tot 1000 items per pagina.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Maximum aantal items. Max: 1000. Standaardwaarde: 100 |
|
|
Overslaan
|
skip | integer |
Haal de lijst met items op die beginnen bij het nde element. Standaardwaarde: 0 |
|
|
State
|
state | string |
Alleen domeinen met een specifieke status ophalen. Kan actief, niet geverifieerd of uitgeschakeld zijn. |
|
|
Sorteren
|
sort | string |
Geldige sorteeropties zijn naam (asc), naam:asc of naam:desc. |
|
|
Autoriteit
|
authority | string |
Alleen domeinen ophalen met een specifieke instantie. |
|
|
Orders zoeken
|
search | string |
Zoekdomeinen op basis van de opgegeven gedeeltelijke of volledige naam. Ondersteunt geen jokertekens. |
|
|
Subaccounts opnemen
|
include_subaccounts | boolean |
Zoek op elk domein dat deel uitmaakt van alle subaccounts onder dit account. Standaard: onwaar. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
total_count
|
total_count | integer |
Totaal aantal domeinen |
|
items
|
items | array of object |
Lijst met domeinen |
|
id
|
items.id | string |
Unieke id van het domein |
|
naam
|
items.name | string |
Volledig gekwalificeerde domeinnaam geregistreerd bij Mailgun |
|
state
|
items.state | string |
Huidige verificatiestatus van het domein |
|
type
|
items.type | string |
Classificatie van het domein. Mogelijke waarden zijn aangepast of sandbox |
|
aangemaakt_op
|
items.created_at | string |
Tijdstempel die aangeeft wanneer het domein is gemaakt in RFC1123 indeling |
|
is_disabled
|
items.is_disabled | boolean |
Geeft aan of het domein momenteel is uitgeschakeld |
|
require_tls
|
items.require_tls | boolean |
Als waar Mailgun alleen berichten verzendt via een TLS-verbinding |
|
skip_verification
|
items.skip_verification | boolean |
Als waar Mailgun het certificaat en de hostnaam niet verifieert bij het instellen van een TLS-verbinding |
|
smtp_login
|
items.smtp_login | string |
SMTP-aanmeldingsnaam voor het domein |
|
smtp_password
|
items.smtp_password | string |
Optioneel SMTP-wachtwoord voor het domein dat wordt gebruikt voor SMTP-verificatie |
|
spam_action
|
items.spam_action | string |
Actie die moet worden ondernomen wanneer een bericht wordt gemarkeerd als spam. Opties zijn uitgeschakeld, tag of blok |
|
jokerteken
|
items.wildcard | boolean |
Geeft aan of het domein een domein met jokertekens is en e-mailberichten kan ontvangen voor elk subdomein |
|
subaccount_id
|
items.subaccount_id | string |
De subaccount-id waartoe het domein behoort |
|
tracking_host
|
items.tracking_host | string |
Aangepaste traceringshost voor het domein dat wordt gebruikt voor het bijhouden wordt geopend en klikken |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Als waar Mailgun DKIM-sleutelgeneratie en DNS-recordconfiguratie automatisch beheert |
|
web_prefix
|
items.web_prefix | string |
Subdomeinvoorvoegsel dat wordt gebruikt voor openen en klikken op bijhouden |
|
web_scheme
|
items.web_scheme | string |
Protocolschema dat wordt gebruikt voor het bijhouden |
|
archive_to
|
items.archive_to | string |
URL waarnaar een kopie van elk bericht met succes wordt geplaatst |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Als binnenkomende berichten naar dit domein waar zijn, worden versleuteld |
|
message_ttl
|
items.message_ttl | integer |
Hiermee geeft u de time-to-live (TTL) in seconden op voor het ophalen van zowel binnenkomende als uitgaande berichten |
E-mail valideren
Valideert een e-mailadres met behulp van de validatieservice van Mailgun en retourneert resultaten van de levering.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
E-mailadres
|
address | True | string |
Het e-mailadres dat moet worden gevalideerd. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
E-mailadres
|
address | string |
Het e-mailadres dat is gevalideerd |
|
Is het geldig
|
is_valid | boolean |
Of Mailgun het geldige adres beschouwt |
|
Postvakverificatie
|
mailbox_verification | string |
Status van postvakverificatie |
|
Is wegwerpadres
|
is_disposable_address | boolean |
Of het adres afkomstig is van een wegwerpprovider |
|
Is roladres
|
is_role_address | boolean |
Of het adres een op rollen gebaseerd adres is |
|
Reden van validatie
|
reason | array of string |
Validatieredenen geretourneerd door Mailgun (leeg indien geldig) |
|
Risiconiveau
|
risk | string |
Risiconiveau toegewezen door Mailgun |
|
Result
|
result | string |
Resultaat mailgun-afleverbaarheid (bijvoorbeeld product of onbestelbaar) |
|
Hoofdadres
|
root_address | string |
Genormaliseerd hoofdadres |
|
weergavenaam
|
parts.display_name | string |
Weergavenaamgedeelte van het adres |
|
Domein
|
parts.domain | string |
Domeingedeelte van het adres |
|
Lokaal onderdeel
|
parts.local_part | string |
Lokaal deel van het adres |
Een e-mail verzenden
Hiermee verzendt u een e-mailbericht met uw Mailgun-account via formuliervelden met meerdere onderdelen die compatibel zijn met de berichten-API van Mailgun.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Domeinnaam
|
domain_name | True | string |
Het domein waaruit de e-mail moet worden verzonden |
|
Van e-mailadres
|
from | True | string |
Het e-mailadres van het bericht wordt verzonden. |
|
Naar e-mailadres
|
to | True | string |
E-mailadres van geadresseerde. |
|
Onderwerp
|
subject | True | string |
Het onderwerp van het e-mailbericht. |
|
Hoofdtekst van e-mail (tekst)
|
text | string |
Hoofdtekst zonder opmaak van het e-mailbericht. |
|
|
Hoofdtekst van e-mail (HTML)
|
html | html |
HTML-hoofdtekst van het e-mailbericht. |
|
|
CC-e-mailadres
|
cc | string |
E-mailadres van geadresseerde voor carbonkopie. |
|
|
BCC-e-mailadres
|
bcc | string |
E-mailadres van geadresseerde voor blind carbon copy. |
|
|
Reply-To e-mailadres
|
h:Reply-To | string |
Waar antwoorden moeten worden bezorgd. |
|
|
Bijlage
|
attachment | file |
Bestandsbijlage die bij het bericht moet worden opgenomen. |
|
|
Tags
|
o:tag | array |
Een of meer tags voor het groeperen en filteren van e-mailberichten in Mailgun (maximaal 10 per bericht). |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Bericht-id
|
id | string |
Unieke id die is toegewezen aan het bericht in de wachtrij |
|
Statusbericht
|
message | string |
Leesbare status van Mailgun (bijvoorbeeld In wachtrij geplaatst. Bedankt.) |