Mailgun (előzetes verzió)
A Mailgun hatékony API-kat biztosít az e-mailek küldéséhez, fogadásához, nyomon követéséhez és tárolásához. Ezzel az összekötő használatával kódírás nélkül automatizálhatja az e-mail-kézbesítési és kommunikációs munkafolyamatokat.
Ez az összekötő a következő termékekben és régiókban érhető el:
| Service | Class | Regions |
|---|---|---|
| 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 Apps | 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) |
| Kapcsolat | |
|---|---|
| Név | Támogatási csatorna |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| Összekötő metaadatai | |
|---|---|
| Kiadó | Sinch Svédország AB |
| Webhely | https://www.mailgun.com |
| Adatvédelmi irányelvek | https://www.mailgun.com/legal/privacy-policy/ |
| Categories | Marketing; Értékesítés és CRM |
Összekötő neve
Mailgun
Összekötő összegzése
A Mailgun-összekötő lehetővé teszi, hogy Power Automate felhasználók e-mailt küldjenek, lekérjék a Mailgun tartományadatait, érvényesítsék az egyes e-mail-címeket, tömeges e-mail-érvényesítési feladatokat küldjenek, és tömeges érvényesítési eredményeket kérjenek le a Mailgun-fiókjukkal.
Kapcsolat
Kapcsolattartó URL-címe: https://help.mailgun.com/hc/en-us
Támogatási/kapcsolattartási e-mail: support@mailgun.com
Regisztrációs URL-cím: https://signup.mailgun.com/
Requirements
- Egy Mailgun-fiók. Ha nincs ilyenje, regisztráljon a webhelyen https://signup.mailgun.com/.
- Mailgun API-kulcs vagy tartományküldési kulcs.
- A fiók megfelelő Mailgun API-régiója: USA vagy EU.
- Az e-mailek küldéséhez egy Mailgun küldő tartományt. Az éles küldéshez ellenőrzött tartomány szükséges.
- Az érvényesítési műveletekhez hozzáférés a Mailgun Validate szolgáltatáshoz.
A tesztkörnyezeti tartományok használhatók kezdeti teszteléshez, de csak jogosult címzettekre korlátozódnak.
Hitelesítő adatok lekérése
Ez az összekötő Mailgun API-kulcshitelesítést használ. Jelentkezzen be a Mailgun Vezérlőpult, és hozzon létre egy API-kulcsot az API Securityből, vagy hozzon létre egy tartományspecifikus küldési API-kulcsot a küldési tartomány beállításaiból.
Az összekötő alapszintű hitelesítést api használ felhasználónévként, jelszóként pedig a Mailgun API-kulcsot. A kapcsolat beállítása során válassza ki a fióknak megfelelő Mailgun API-régiót.
Támogatott műveletek
Ez az összekötő a következő műveleteket támogatja:
-
Send Email: E-mail küldése a Mailgun küldő tartomány használatával. -
Get Domain Information: A Mailgun tartomány adatainak lekérése. -
Validate Email Address: Egyéni e-mail-cím ellenőrzése. -
Submit Bulk Validation Job: Küldjön be egy tömeges e-mail-érvényesítési feladatot. -
Get Bulk Validation Results: Tömeges e-mail-érvényesítési eredmények lekérése.
Kapcsolat létrehozása
Az összekötő a következő hitelesítési típusokat támogatja:
| Default | 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 | Leírás | Szükséges |
|---|---|---|---|
| API-kulcs | securestring | A Mailgun privát API-kulcsa | True |
| Mailgun régió | karakterlánc | Válassza a Mailgun US vagy a Mailgun EU lehetőséget | True |
Műveletek
| E-mail ellenőrzése |
Ellenőrzi az e-mail-címet a Mailgun érvényesítési szolgáltatásával, és visszaadja a kézbesítési eredményeket. |
| E-mail küldése |
E-mailt küld a Mailgun-fiókjával a Mailgun üzenet api-jával kompatibilis többrészes űrlapmezőkön keresztül. |
| Tartomány részleteinek lekérése |
Lekéri egy tartomány JSON-ábrázolását, amely a tartomány állapotával és beállításaival kapcsolatos részleteket tartalmazza. |
| Tartományok lekérése |
A tartományok listájának lekérése. Az állapot vagy a hatóság szerint szűrhető. A lista lapszámozott, és oldalanként legfeljebb 1000 elemet tartalmazhat. |
| Tömeges e-mail-ellenőrzés |
Töltsön fel egy CSV-t egy e-mail fejlécoszlopával, és indítsa el a tömeges érvényesítési feladatot a Mailgun V4 API-jával. |
| Tömeges érvényesítési eredmények lekérése |
Lekéri a korábban elküldött feladatok tömeges érvényesítési feladatának állapotát és összegzési eredményeit. |
E-mail ellenőrzése
Ellenőrzi az e-mail-címet a Mailgun érvényesítési szolgáltatásával, és visszaadja a kézbesítési eredményeket.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
E-mail cím
|
address | True | string |
Az érvényesítendő e-mail-cím. |
Válaszok
| Név | Elérési út | Típus | Description |
|---|---|---|---|
|
E-mail cím
|
address | string |
Az érvényesített e-mail-cím |
|
Érvényes
|
is_valid | boolean |
Azt jelzi, hogy a Mailgun érvényesnek tartja-e a címet |
|
Postaláda ellenőrzése
|
mailbox_verification | string |
Postaláda-ellenőrzési állapot |
|
Eldobható cím
|
is_disposable_address | boolean |
Azt jelzi, hogy a cím eldobható szolgáltatótól származik-e |
|
Szerepkör címe
|
is_role_address | boolean |
Szerepköralapú cím-e a cím? |
|
Érvényesítési ok
|
reason | array of string |
A Mailgun által visszaadott érvényesítési okok (üres, ha érvényes) |
|
Kockázati szint
|
risk | string |
A Mailgun által hozzárendelt kockázati szint |
|
Result
|
result | string |
A mailgun kézbesítési eredménye (például kézbesíthető vagy kézbesíthetetlen) |
|
Gyökércím
|
root_address | string |
Normalizált gyökércím |
|
Megjelenítendő név
|
parts.display_name | string |
A cím névrészének megjelenítése |
|
Szakterület
|
parts.domain | string |
A cím tartományrésze |
|
Helyi rész
|
parts.local_part | string |
A cím helyi része |
E-mail küldése
E-mailt küld a Mailgun-fiókjával a Mailgun üzenet api-jával kompatibilis többrészes űrlapmezőkön keresztül.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Dómainnév
|
domain_name | True | string |
Az e-mailt küldő tartomány |
|
E-mail-címről
|
from | True | string |
Az üzenet e-mail-címe. |
|
E-mail-címre
|
to | True | string |
Címzett e-mail címe. |
|
Tárgy
|
subject | True | string |
Az e-mail tárgya. |
|
E-mail törzse (szöveg)
|
text | string |
Az e-mail egyszerű szövegtörzse. |
|
|
E-mail törzse (HTML)
|
html | html |
Az e-mail HTML-törzse. |
|
|
MÁSOLATOT KAP e-mail-cím
|
cc | string |
A másolat címzettjének e-mail-címe. |
|
|
Titkos másolat e-mail-címe
|
bcc | string |
Vak szén-dioxid-másolat címzett e-mail-címe. |
|
|
Reply-To e-mail-cím
|
h:Reply-To | string |
Ahol válaszokat kell kézbesíteni. |
|
|
Attachment
|
attachment | file |
Az üzenethez mellékelendő fájlmelléklet. |
|
|
Tags
|
o:tag | array |
Egy vagy több címkével csoportosíthatja és szűrheti az e-maileket a Mailgunban (üzenetenként legfeljebb 10). |
Válaszok
| Név | Elérési út | Típus | Description |
|---|---|---|---|
|
Üzenet azonosítója
|
id | string |
Az üzenetsorhoz rendelt egyedi azonosító |
|
Állapotüzenet
|
message | string |
Ember által olvasható állapot a Mailgunból (például queued. Köszönöm.) |
Tartomány részleteinek lekérése
Lekéri egy tartomány JSON-ábrázolását, amely a tartomány állapotával és beállításaival kapcsolatos részleteket tartalmazza.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Dómainnév
|
name | True | string |
A lekérni kívánt tartomány neve |
Válaszok
| Név | Elérési út | Típus | Description |
|---|---|---|---|
|
id
|
domain.id | string |
A tartomány egyedi azonosítója |
|
név
|
domain.name | string |
A Mailgunban regisztrált teljes tartománynév |
|
state
|
domain.state | string |
A tartomány aktuális ellenőrzési állapota |
|
típus
|
domain.type | string |
A tartomány besorolása. A lehetséges értékek egyéniek vagy tesztkörnyezetek |
|
létrehozás_időpontja
|
domain.created_at | string |
A tartomány RFC1123 formátumú létrehozásának idejét jelző időbélyeg |
|
is_disabled
|
domain.is_disabled | boolean |
Azt jelzi, hogy a tartomány jelenleg le van-e tiltva |
|
require_tls
|
domain.require_tls | boolean |
Ha az igaz Mailgun csak TLS-kapcsolaton keresztül küld üzeneteket |
|
skip_verification
|
domain.skip_verification | boolean |
Ha az igaz Mailgun nem ellenőrzi a tanúsítványt és a gazdagépnevet a TLS-kapcsolat beállításakor |
|
smtp_login
|
domain.smtp_login | string |
SMTP bejelentkezési felhasználónév a tartományhoz |
|
smtp_password
|
domain.smtp_password | string |
Nem kötelező SMTP-jelszó az SMTP-hitelesítéshez használt tartományhoz |
|
spam_action
|
domain.spam_action | string |
Az üzenetek levélszemétként való megjelölésekor végrehajtandó művelet. A beállítások le vannak tiltva, címke vagy blokk |
|
helyettesítő karakter
|
domain.wildcard | boolean |
Azt jelzi, hogy a tartomány helyettesítő karakteres tartomány-e, és e-maileket fogadhat-e bármely altartományhoz |
|
subaccount_id
|
domain.subaccount_id | string |
Az alfiók azonosítója, amelyhez a tartomány tartozik |
|
tracking_host
|
domain.tracking_host | string |
Megnyílik a nyomon követéshez használt tartomány egyéni nyomkövetési állomása, és rákattint |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Ha az igaz Mailgun automatikusan kezeli a DKIM-kulcsgenerálást és a DNS-rekordkonfigurációt |
|
web_prefix
|
domain.web_prefix | string |
A megnyitáshoz és a kattintáskövetéshez használt altartomány-előtag |
|
web_scheme
|
domain.web_scheme | string |
Nyomkövetéshez használt protokollséma |
|
archive_to
|
domain.archive_to | string |
URL- cím, amelybe az egyes sikeresen kézbesített üzenetek egy-egy példánya fel lesz adva |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Ha a tartományba érkező valódi bejövő üzenetek titkosítva lesznek |
|
message_ttl
|
domain.message_ttl | integer |
Másodpercben megadja az élettartamot (TTL) a bejövő és a kimenő üzenetek beolvasásához |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Az e-mailek fogadásához szükséges DNS-rekordok listája |
|
is_active
|
receiving_dns_records.is_active | boolean |
Azt jelzi, hogy a DNS-rekord jelenleg aktív-e |
|
Gyorsítótárazott
|
receiving_dns_records.cached | array of string |
A DNS-rekord Mailgun által gyorsítótárazott értékeinek listája |
|
név
|
receiving_dns_records.name | string |
A DNS-rekord neve, ha van |
|
elsőbbség
|
receiving_dns_records.priority | string |
Az MX DNS-rekordok prioritási értéke |
|
record_type
|
receiving_dns_records.record_type | string |
DNS-rekord típusa, például MX, TXT vagy CNAME |
|
érvényes
|
receiving_dns_records.valid | string |
Azt jelzi, hogy a DNS-rekord érvényes-e |
|
value
|
receiving_dns_records.value | string |
A DNS-rekord várt értéke |
|
sending_dns_records
|
sending_dns_records | array of object |
Az e-mailek küldéséhez szükséges DNS-rekordok listája |
|
is_active
|
sending_dns_records.is_active | boolean |
Azt jelzi, hogy a DNS-rekord jelenleg aktív-e |
|
Gyorsítótárazott
|
sending_dns_records.cached | array of string |
A DNS-rekord Mailgun által gyorsítótárazott értékeinek listája |
|
név
|
sending_dns_records.name | string |
A DNS-rekord neve, ha van |
|
elsőbbség
|
sending_dns_records.priority | string |
Az MX DNS-rekordok prioritási értéke |
|
record_type
|
sending_dns_records.record_type | string |
DNS-rekord típusa, például MX, TXT vagy CNAME |
|
érvényes
|
sending_dns_records.valid | string |
Azt jelzi, hogy a DNS-rekord érvényes-e |
|
value
|
sending_dns_records.value | string |
A DNS-rekord várt értéke |
Tartományok lekérése
A tartományok listájának lekérése. Az állapot vagy a hatóság szerint szűrhető. A lista lapszámozott, és oldalanként legfeljebb 1000 elemet tartalmazhat.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Elemek maximális száma. Max: 1000. Alapértelmezett: 100 |
|
|
Kihagyás
|
skip | integer |
Az elemek listájának lekérése az n. elemtől kezdve. Alapértelmezett: 0 |
|
|
State
|
state | string |
Csak adott állapotú tartományok lekérése. Lehet aktív, nem ellenőrzött vagy letiltott. |
|
|
Sort
|
sort | string |
Az érvényes rendezési beállítások a következők: név (asc), name:asc vagy name:desc. |
|
|
Hatóság
|
authority | string |
Csak adott szolgáltatóval rendelkező tartományok lekérése. |
|
|
Kereső
|
search | string |
Keressen tartományokat a megadott részleges vagy teljes név alapján. Nem támogatja a helyettesítő karaktereket. |
|
|
Alfiókok belefoglalása
|
include_subaccounts | boolean |
Keressen minden olyan tartományra, amely a fiók bármely alfiókjába tartozik. Alapértelmezett: hamis. |
Válaszok
| Név | Elérési út | Típus | Description |
|---|---|---|---|
|
total_count
|
total_count | integer |
Tartományok teljes száma |
|
items
|
items | array of object |
Tartományok listája |
|
id
|
items.id | string |
A tartomány egyedi azonosítója |
|
név
|
items.name | string |
A Mailgunban regisztrált teljes tartománynév |
|
state
|
items.state | string |
A tartomány aktuális ellenőrzési állapota |
|
típus
|
items.type | string |
A tartomány besorolása. A lehetséges értékek egyéniek vagy tesztkörnyezetek |
|
létrehozás_időpontja
|
items.created_at | string |
A tartomány RFC1123 formátumú létrehozásának idejét jelző időbélyeg |
|
is_disabled
|
items.is_disabled | boolean |
Azt jelzi, hogy a tartomány jelenleg le van-e tiltva |
|
require_tls
|
items.require_tls | boolean |
Ha az igaz Mailgun csak TLS-kapcsolaton keresztül küld üzeneteket |
|
skip_verification
|
items.skip_verification | boolean |
Ha az igaz Mailgun nem ellenőrzi a tanúsítványt és a gazdagépnevet a TLS-kapcsolat beállításakor |
|
smtp_login
|
items.smtp_login | string |
SMTP bejelentkezési felhasználónév a tartományhoz |
|
smtp_password
|
items.smtp_password | string |
Nem kötelező SMTP-jelszó az SMTP-hitelesítéshez használt tartományhoz |
|
spam_action
|
items.spam_action | string |
Az üzenetek levélszemétként való megjelölésekor végrehajtandó művelet. A beállítások le vannak tiltva, címke vagy blokk |
|
helyettesítő karakter
|
items.wildcard | boolean |
Azt jelzi, hogy a tartomány helyettesítő karakteres tartomány-e, és e-maileket fogadhat-e bármely altartományhoz |
|
subaccount_id
|
items.subaccount_id | string |
Az alfiók azonosítója, amelyhez a tartomány tartozik |
|
tracking_host
|
items.tracking_host | string |
Megnyílik a nyomon követéshez használt tartomány egyéni nyomkövetési állomása, és rákattint |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Ha az igaz Mailgun automatikusan kezeli a DKIM-kulcsgenerálást és a DNS-rekordkonfigurációt |
|
web_prefix
|
items.web_prefix | string |
A megnyitáshoz és a kattintáskövetéshez használt altartomány-előtag |
|
web_scheme
|
items.web_scheme | string |
Nyomkövetéshez használt protokollséma |
|
archive_to
|
items.archive_to | string |
URL- cím, amelybe az egyes sikeresen kézbesített üzenetek egy-egy példánya fel lesz adva |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Ha a tartományba érkező valódi bejövő üzenetek titkosítva lesznek |
|
message_ttl
|
items.message_ttl | integer |
Másodpercben megadja az élettartamot (TTL) a bejövő és a kimenő üzenetek beolvasásához |
Tömeges e-mail-ellenőrzés
Töltsön fel egy CSV-t egy e-mail fejlécoszlopával, és indítsa el a tömeges érvényesítési feladatot a Mailgun V4 API-jával.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Feladatlista neve
|
list_id | True | string |
A tömeges érvényesítési feladatot azonosító elérési útparaméter. |
|
CSV-fájl
|
file | True | file |
Feltöltendő CSV-fájl. A fájlnak tartalmaznia kell egy e-mail nevű fejlécet. |
Válaszok
| Név | Elérési út | Típus | Description |
|---|---|---|---|
|
Feladatazonosító (lista neve)
|
id | string |
Feladatazonosító (lista neve) |
|
Kiszolgálói üzenet
|
message | string |
Állapotüzenet a Mailguntól |
Tömeges érvényesítési eredmények lekérése
Lekéri a korábban elküldött feladatok tömeges érvényesítési feladatának állapotát és összegzési eredményeit.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Feladatazonosító
|
list_id | True | string |
A tömeges érvényesítési kérelemből visszaadott feladatazonosító. |
Válaszok
| Név | Elérési út | Típus | Description |
|---|---|---|---|
|
Feladatazonosító
|
id | string |
Feladatazonosító |
|
Feladatazonosító
|
list_id | string |
Feladatlista neve |
|
Feladat állapota
|
status | string |
Aktuális feladat állapota |
|
Létrehozás dátuma:
|
created_at | integer |
A feladat létrehozásakor (Unix időbélyeg) |
|
CSV letöltési URL-címe
|
download_url.csv | string |
URL-cím az összes eredmény CSV-fájlként való letöltéséhez |
|
Válogatott CSV letöltési URL-címe
|
download_url.curated_csv | string |
A válogatott eredmények CSV-fájlként való letöltéséhez használt URL-cím |
|
JSON letöltési URL-címe
|
download_url.json | string |
Az összes találat JSON-fájlként való letöltésének URL-címe |
|
Válogatott JSON letöltési URL-cím
|
download_url.curated_json | string |
A válogatott eredmények JSON-fájlként való letöltéséhez használt URL-cím |
|
Teljes mennyiség
|
quantity | integer |
A feladat rekordjainak teljes száma |
|
Feldolgozott rekordok
|
records_processed | integer |
Az eddig feldolgozott rekordok száma |
|
Termékszám
|
summary.result.deliverable | integer |
Termékcímek száma |
|
Nem kézbesíthető darabszám
|
summary.result.undeliverable | integer |
Nem kézbesíthető címek száma |
|
Az összes szám elfogása
|
summary.result.catch_all | integer |
Az összes fogási cím száma |
|
Ne küldjön darabszámot
|
summary.result.do_not_send | integer |
A nem küldésként megjelölt címek száma |
|
Az összes szám elfogadása
|
summary.result.accept_all | integer |
Az elfogadó címek száma |
|
Ismeretlen darabszám
|
summary.result.unknown | integer |
Ismeretlen kézbesítésű címek száma |
|
Magas kockázatszám
|
summary.risk.high | integer |
Magas kockázatú címek száma |
|
Közepes kockázatszám
|
summary.risk.medium | integer |
Közepes kockázatú címek száma |
|
Alacsony kockázatú számok
|
summary.risk.low | integer |
Alacsony kockázatú címek száma |
|
Ismeretlen kockázatszám
|
summary.risk.unknown | integer |
Ismeretlen kockázattal rendelkező címek száma |
|
Nagy érdeklődésű szám
|
summary.engagement.highly_engaged | integer |
Magas érdeklődésű címek száma |
|
Aktívak száma
|
summary.engagement.engaged | integer |
A bevont címek száma |
|
Leválasztott darabszám
|
summary.engagement.disengaged | integer |
A leválasztott címek száma |
|
Robotok száma
|
summary.engagement.bot | integer |
Robotcímek száma |
|
Panaszkodók száma
|
summary.engagement.complainer | integer |
Panaszbejelentői címek száma |
|
Nincs adatszám
|
summary.engagement.no_data | integer |
Az előjegyzési adatok nélküli címek száma |