Mailgun (Preview)
Mailgun poskytuje výkonná rozhraní API pro odesílání, přijímání, sledování a ukládání e-mailů. Pomocí tohoto konektoru můžete automatizovat pracovní postupy doručování e-mailů a komunikace bez psaní kódu.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Oblasti |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logické aplikace | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Azure Government oblastí – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Automatizace napájení | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Jméno | Kanál podpory |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| Metadata konektoru | |
|---|---|
| Vydavatel | Sinch Švédsko AB |
| Internetová stránka | https://www.mailgun.com |
| Zásady ochrany osobních údajů | https://www.mailgun.com/legal/privacy-policy/ |
| Kategorie | Marketing; Sales and CRM |
Název konektoru
Mailgun
Souhrn konektoru
Konektor Mailgun umožňuje Power Automate uživatelům odesílat e-maily, načítat informace o doméně Mailgun, ověřovat jednotlivé e-mailové adresy, odesílat úlohy hromadného ověření e-mailu a načítat výsledky hromadného ověření pomocí účtu Mailgun.
Kontakt
Adresa URL kontaktu: https://help.mailgun.com/hc/en-us
Podpora / kontaktní e-mail: support@mailgun.com
Přihlašovací adresa URL: https://signup.mailgun.com/
Požadavky
- Účet Mailgun. Pokud ho nemáte, zaregistrujte se na adrese https://signup.mailgun.com/.
- Klíč rozhraní API Mailgun nebo klíč odesílající doménu
- Správná oblast rozhraní Mailgun API pro váš účet: USA nebo EU.
- Pro odesílání e-mailů odešlete doménu Mailgun. Odesílání v produkčním prostředí vyžaduje ověřenou doménu.
- K akcím ověření se dostanete přes Mailgun Validate.
Domény sandboxu je možné použít k počátečnímu testování, ale jsou omezené na autorizované příjemce.
Jak získat přihlašovací údaje
Tento konektor používá ověřování pomocí klíče rozhraní Mailgun API. Přihlaste se k Ovládací panely Mailgun a vytvořte klíč rozhraní API ze zabezpečení rozhraní API nebo vytvořte klíč rozhraní API specifický pro doménu odesílající klíč rozhraní API z nastavení odesílající domény.
Konektor používá jako uživatelské jméno základní ověřování api a klíč rozhraní Mailgun API jako heslo. Během instalace připojení vyberte oblast rozhraní API Mailgun, která odpovídá vašemu účtu.
Podporované operace
Tento konektor podporuje následující operace:
-
Send Email: Odešlete e-mail pomocí odesílající domény Mailgun. -
Get Domain Information: Načíst informace o doméně Mailgun. -
Validate Email Address: Ověřte individuální e-mailovou adresu. -
Submit Bulk Validation Job: Odešlete úlohu hromadného ověření e-mailu. -
Get Bulk Validation Results: Načtěte výsledky hromadného ověření e-mailu.
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| Default | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Jméno | Typ | Popis | Povinné |
|---|---|---|---|
| klíč rozhraní API | securestring | Privátní klíč rozhraní API Mailgun | Pravdivé |
| Oblast Mailgun | řetězec | Vyberte Mailgun US nebo Mailgun EU | Pravdivé |
Akce
| Hromadné ověření e-mailu |
Nahrajte soubor CSV se sloupcem záhlaví e-mailu a spusťte úlohu hromadného ověření pomocí rozhraní API V4 mailgunu. |
| Odeslat e-mail |
Odešle e-mail pomocí účtu Mailgun prostřednictvím polí formuláře s více částmi kompatibilními s rozhraním API pro zprávy mailgunu. |
| Ověření e-mailu |
Ověří e-mailovou adresu pomocí ověřovací služby Mailgun a vrátí výsledky doručení. |
| Získání domén |
Získejte seznam domén. Je možné filtrovat podle státu nebo autority. Seznam je stránkovaný a omezený na 1 000 položek na stránku. |
| Získání podrobností o doméně |
Načte reprezentaci JSON domény, která obsahuje podrobnosti o stavu a nastavení domény. |
| Získání výsledků hromadného ověření |
Načte stav úlohy hromadného ověření a souhrnné výsledky pro dříve odeslanou úlohu. |
Hromadné ověření e-mailu
Nahrajte soubor CSV se sloupcem záhlaví e-mailu a spusťte úlohu hromadného ověření pomocí rozhraní API V4 mailgunu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Název seznamu úloh
|
list_id | True | string |
Parametr cesty, který identifikuje úlohu hromadného ověření. |
|
Soubor CSV
|
file | True | file |
Soubor CSV, který chcete nahrát. Soubor musí obsahovat hlavičku s názvem e-mail. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID úlohy (název seznamu)
|
id | string |
Identifikátor úlohy (název seznamu) |
|
Zpráva serveru
|
message | string |
Stavová zpráva z Mailgunu |
Odeslat e-mail
Odešle e-mail pomocí účtu Mailgun prostřednictvím polí formuláře s více částmi kompatibilními s rozhraním API pro zprávy mailgunu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Název domény
|
domain_name | True | string |
Doména, ze které se má e-mail odeslat |
|
Z e-mailové adresy
|
from | True | string |
E-mailová adresa, ze které bude zpráva odeslána. |
|
Na e-mailovou adresu
|
to | True | string |
E-mailová adresa příjemce |
|
Předmět
|
subject | True | string |
Předmět e-mailu. |
|
Text e-mailu (text)
|
text | string |
Text e-mailu ve formátu prostého textu |
|
|
Text e-mailu (HTML)
|
html | html |
Text HTML e-mailu |
|
|
E-mailová adresa CC
|
cc | string |
E-mailová adresa příjemce uhlíkové kopie |
|
|
E-mailová adresa skryté kopie
|
bcc | string |
E-mailová adresa příjemce slepé kopie. |
|
|
Reply-To e-mailová adresa
|
h:Reply-To | string |
Kde by měly být doručeny odpovědi. |
|
|
Příloha
|
attachment | file |
Soubor přílohy, která se má zahrnout do zprávy. |
|
|
Tags
|
o:tag | array |
Jedna nebo více značek pro seskupení a filtrování e-mailů v Mailgunu (až 10 na zprávu) |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID zprávy
|
id | string |
Jedinečný identifikátor přiřazený ke zprávě ve frontě |
|
Stavová zpráva
|
message | string |
Stav čitelný člověkem z Mailgunu (například Zařazeno do fronty). Děkujeme.) |
Ověření e-mailu
Ověří e-mailovou adresu pomocí ověřovací služby Mailgun a vrátí výsledky doručení.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
E-mailová adresa
|
address | True | string |
E-mailová adresa, kterou chcete ověřit. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
E-mailová adresa
|
address | string |
Ověřená e-mailová adresa |
|
Je platný.
|
is_valid | boolean |
Zda Mailgun považuje adresu za platnou. |
|
Ověření poštovní schránky
|
mailbox_verification | string |
Stav ověření poštovní schránky |
|
Je uvolnitelná adresa
|
is_disposable_address | boolean |
Zda je adresa od poskytovatele na jedno použití |
|
Je adresa role
|
is_role_address | boolean |
Určuje, jestli se jedná o adresu založenou na rolích. |
|
Důvod ověření
|
reason | array of string |
Důvody ověření vrácené službou Mailgun (prázdné, pokud jsou platné) |
|
Úroveň rizika
|
risk | string |
Úroveň rizika přiřazená službou Mailgun |
|
Result
|
result | string |
Výsledek dodávky mailgunu (například dodávky nebo nedoručitelné) |
|
Kořenová adresa
|
root_address | string |
Normalizovaná kořenová adresa |
|
Zobrazit název
|
parts.display_name | string |
Část zobrazovaného názvu adresy |
|
Doména
|
parts.domain | string |
Doménová část adresy |
|
Místní část
|
parts.local_part | string |
Místní část adresy |
Získání domén
Získejte seznam domén. Je možné filtrovat podle státu nebo autority. Seznam je stránkovaný a omezený na 1 000 položek na stránku.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Maximální počet položek Max: 1000. Výchozí hodnota: 100 |
|
|
Přeskočit
|
skip | integer |
Získejte seznam položek začínajících nth elementem. Výchozí hodnota: 0 |
|
|
Kraj
|
state | string |
Získejte pouze domény s konkrétním stavem. Může být aktivní, neověřená nebo zakázaná. |
|
|
Sort
|
sort | string |
Platné možnosti řazení jsou název (asc), name:asc nebo name:desc. |
|
|
Autorita
|
authority | string |
Získejte pouze domény s konkrétní autoritou. |
|
|
Search
|
search | string |
Prohledat domény podle zadaného částečného nebo kompletního názvu Nepodporuje zástupné kóty. |
|
|
Zahrnout dílčí účty
|
include_subaccounts | boolean |
Vyhledejte každou doménu, která patří k libovolnému podúčtu pod tímto účtem. Výchozí hodnota: false. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
total_count
|
total_count | integer |
Celkový počet domén |
|
items
|
items | array of object |
Seznam domén |
|
id
|
items.id | string |
Jedinečný identifikátor domény |
|
Jméno
|
items.name | string |
Plně kvalifikovaný název domény zaregistrovaný v Mailgunu |
|
stav
|
items.state | string |
Aktuální stav ověření domény |
|
typ
|
items.type | string |
Klasifikace domény Možné hodnoty jsou vlastní nebo sandbox |
|
datum_vytvoření
|
items.created_at | string |
Časové razítko označující, kdy byla doména vytvořena ve formátu RFC1123 |
|
is_disabled
|
items.is_disabled | boolean |
Určuje, jestli je doména aktuálně zakázaná. |
|
require_tls
|
items.require_tls | boolean |
Pokud true Mailgun bude odesílat zprávy pouze přes připojení TLS |
|
skip_verification
|
items.skip_verification | boolean |
Pokud true Mailgun při nastavování připojení TLS neověří certifikát a název hostitele |
|
smtp_login
|
items.smtp_login | string |
Přihlašovací uživatelské jméno SMTP pro doménu |
|
smtp_password
|
items.smtp_password | string |
Volitelné heslo SMTP pro doménu použitou k ověřování SMTP |
|
spam_action
|
items.spam_action | string |
Akce, která se má provést, když je zpráva označená příznakem spamu Možnosti jsou zakázané, značky nebo bloky. |
|
zástupný znak
|
items.wildcard | boolean |
Označuje, jestli je doména zástupným znakem a může přijímat e-maily pro libovolnou subdoménu. |
|
subaccount_id
|
items.subaccount_id | string |
ID podúčtu, do které doména patří |
|
tracking_host
|
items.tracking_host | string |
Otevře se vlastní hostitel sledování pro doménu použitou ke sledování a kliknutí. |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Pokud true Mailgun spravuje generování klíčů DKIM a konfiguraci záznamů DNS automaticky |
|
web_prefix
|
items.web_prefix | string |
Předpona subdomény používaná k otevření a kliknutí na sledování |
|
web_scheme
|
items.web_scheme | string |
Schéma protokolu používané ke sledování |
|
archive_to
|
items.archive_to | string |
Adresa URL, do které se publikuje kopie každé úspěšně doručené zprávy |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Pokud budou v této doméně zašifrovány skutečné příchozí zprávy. |
|
message_ttl
|
items.message_ttl | integer |
Určuje hodnotu TTL (Time to Live) v sekundách pro načítání příchozích i odchozích zpráv. |
Získání podrobností o doméně
Načte reprezentaci JSON domény, která obsahuje podrobnosti o stavu a nastavení domény.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Název domény
|
name | True | string |
Název domény, kterou chcete načíst |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
id
|
domain.id | string |
Jedinečný identifikátor domény |
|
Jméno
|
domain.name | string |
Plně kvalifikovaný název domény zaregistrovaný v Mailgunu |
|
stav
|
domain.state | string |
Aktuální stav ověření domény |
|
typ
|
domain.type | string |
Klasifikace domény Možné hodnoty jsou vlastní nebo sandbox |
|
datum_vytvoření
|
domain.created_at | string |
Časové razítko označující, kdy byla doména vytvořena ve formátu RFC1123 |
|
is_disabled
|
domain.is_disabled | boolean |
Určuje, jestli je doména aktuálně zakázaná. |
|
require_tls
|
domain.require_tls | boolean |
Pokud true Mailgun bude odesílat zprávy pouze přes připojení TLS |
|
skip_verification
|
domain.skip_verification | boolean |
Pokud true Mailgun při nastavování připojení TLS neověří certifikát a název hostitele |
|
smtp_login
|
domain.smtp_login | string |
Přihlašovací uživatelské jméno SMTP pro doménu |
|
smtp_password
|
domain.smtp_password | string |
Volitelné heslo SMTP pro doménu použitou k ověřování SMTP |
|
spam_action
|
domain.spam_action | string |
Akce, která se má provést, když je zpráva označená příznakem spamu Možnosti jsou zakázané, značky nebo bloky. |
|
zástupný znak
|
domain.wildcard | boolean |
Označuje, jestli je doména zástupným znakem a může přijímat e-maily pro libovolnou subdoménu. |
|
subaccount_id
|
domain.subaccount_id | string |
ID podúčtu, do které doména patří |
|
tracking_host
|
domain.tracking_host | string |
Otevře se vlastní hostitel sledování pro doménu použitou ke sledování a kliknutí. |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Pokud true Mailgun spravuje generování klíčů DKIM a konfiguraci záznamů DNS automaticky |
|
web_prefix
|
domain.web_prefix | string |
Předpona subdomény používaná k otevření a kliknutí na sledování |
|
web_scheme
|
domain.web_scheme | string |
Schéma protokolu používané ke sledování |
|
archive_to
|
domain.archive_to | string |
Adresa URL, do které se publikuje kopie každé úspěšně doručené zprávy |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Pokud budou v této doméně zašifrovány skutečné příchozí zprávy. |
|
message_ttl
|
domain.message_ttl | integer |
Určuje hodnotu TTL (Time to Live) v sekundách pro načítání příchozích i odchozích zpráv. |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Seznam záznamů DNS vyžadovaných pro příjem e-mailů |
|
is_active
|
receiving_dns_records.is_active | boolean |
Určuje, jestli je záznam DNS aktuálně aktivní. |
|
uložená v mezipaměti
|
receiving_dns_records.cached | array of string |
Seznam hodnot uložených v mezipaměti Mailgun pro záznam DNS |
|
Jméno
|
receiving_dns_records.name | string |
Název záznamu DNS, pokud je k dispozici |
|
priorita
|
receiving_dns_records.priority | string |
Hodnota priority pro záznamy DNS MX |
|
record_type
|
receiving_dns_records.record_type | string |
Typ záznamu DNS, jako je MX, TXT nebo CNAME |
|
platný
|
receiving_dns_records.valid | string |
Určuje, jestli je záznam DNS platný. |
|
value
|
receiving_dns_records.value | string |
Očekávaná hodnota záznamu DNS |
|
sending_dns_records
|
sending_dns_records | array of object |
Seznam záznamů DNS požadovaných pro odesílání e-mailů |
|
is_active
|
sending_dns_records.is_active | boolean |
Určuje, jestli je záznam DNS aktuálně aktivní. |
|
uložená v mezipaměti
|
sending_dns_records.cached | array of string |
Seznam hodnot uložených v mezipaměti Mailgun pro záznam DNS |
|
Jméno
|
sending_dns_records.name | string |
Název záznamu DNS, pokud je k dispozici |
|
priorita
|
sending_dns_records.priority | string |
Hodnota priority pro záznamy DNS MX |
|
record_type
|
sending_dns_records.record_type | string |
Typ záznamu DNS, jako je MX, TXT nebo CNAME |
|
platný
|
sending_dns_records.valid | string |
Určuje, jestli je záznam DNS platný. |
|
value
|
sending_dns_records.value | string |
Očekávaná hodnota záznamu DNS |
Získání výsledků hromadného ověření
Načte stav úlohy hromadného ověření a souhrnné výsledky pro dříve odeslanou úlohu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID úlohy
|
list_id | True | string |
Identifikátor úlohy vrácený z žádosti o hromadné ověření. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID úlohy
|
id | string |
Identifikátor úlohy |
|
ID úlohy
|
list_id | string |
Název seznamu úloh |
|
Stav úlohy
|
status | string |
Aktuální stav úlohy |
|
Vytvořeno v
|
created_at | integer |
Po vytvoření úlohy (časové razítko Unixu) |
|
Adresa URL pro stažení souboru CSV
|
download_url.csv | string |
Adresa URL pro stažení všech výsledků jako souboru CSV |
|
Kurátorovaná adresa URL pro stažení SOUBORU CSV
|
download_url.curated_csv | string |
Adresa URL ke stažení kurátorovaných výsledků jako souboru CSV |
|
Adresa URL pro stažení JSON
|
download_url.json | string |
Adresa URL pro stažení všech výsledků jako souboru JSON |
|
Kurátorovaná adresa URL pro stažení JSON
|
download_url.curated_json | string |
Adresa URL pro stažení kurátorovaných výsledků jako souboru JSON |
|
Celkové množství
|
quantity | integer |
Celkový počet záznamů v úloze |
|
Zpracované záznamy
|
records_processed | integer |
Počet dosud zpracovaných záznamů |
|
Počet dodávek
|
summary.result.deliverable | integer |
Počet adres dodávek |
|
Neschválitelný počet
|
summary.result.undeliverable | integer |
Počet nedoručitelných adres |
|
Catch All Count
|
summary.result.catch_all | integer |
Počet adres catch-all |
|
Neodesílat počet
|
summary.result.do_not_send | integer |
Počet adres označených příznakem, že se neodesílají |
|
Přijmout všechny počty
|
summary.result.accept_all | integer |
Počet adres pro přijetí |
|
Neznámý počet
|
summary.result.unknown | integer |
Počet adres s neznámou dostupností |
|
Vysoký počet rizik
|
summary.risk.high | integer |
Počet vysoce rizikových adres |
|
Střední počet rizik
|
summary.risk.medium | integer |
Počet středně rizikových adres |
|
Nízký počet rizik
|
summary.risk.low | integer |
Počet adres s nízkým rizikem |
|
Neznámý počet rizik
|
summary.risk.unknown | integer |
Počet adres s neznámým rizikem |
|
Počet vysoce aktivních
|
summary.engagement.highly_engaged | integer |
Počet vysoce aktivních adres |
|
Počet zapojení
|
summary.engagement.engaged | integer |
Počet zasílaných adres |
|
Odpojený počet
|
summary.engagement.disengaged | integer |
Počet nespravovaných adres |
|
Počet robotů
|
summary.engagement.bot | integer |
Počet adres robota |
|
Počet stěžovačů
|
summary.engagement.complainer | integer |
Počet adres stěžovače |
|
Žádný počet dat
|
summary.engagement.no_data | integer |
Počet adres bez dat rezervace |