Mailgun (wersja zapoznawcza)
Aplikacja Mailgun udostępnia zaawansowane interfejsy API do wysyłania, odbierania, śledzenia i przechowywania wiadomości e-mail. Użyj tego łącznika, aby zautomatyzować przepływy pracy dostarczania wiadomości e-mail i komunikacji bez pisania kodu.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt biznesowy | |
|---|---|
| Nazwa | Kanał pomocy technicznej |
| adres URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| Metadane łącznika | |
|---|---|
| Publisher | Sinch Szwecja AB |
| Witryna internetowa | https://www.mailgun.com |
| Zasady ochrony prywatności | https://www.mailgun.com/legal/privacy-policy/ |
| Kategorie | Marketing; Sprzedaż i CRM |
Nazwa łącznika
Mailgun
Podsumowanie łącznika
Łącznik Mailgun umożliwia Power Automate użytkownikom wysyłanie wiadomości e-mail, pobieranie informacji o domenie poczty Mailgun, weryfikowanie poszczególnych adresów e-mail, przesyłanie zadań weryfikacji zbiorczej poczty e-mail i pobieranie wyników weryfikacji zbiorczej przy użyciu konta Mailgun.
Kontakt biznesowy
Adres URL kontaktu: https://help.mailgun.com/hc/en-us
Pomoc techniczna/kontaktowy adres e-mail: support@mailgun.com
Adres URL rejestracji: https://signup.mailgun.com/
Requirements
- Konto Mailgun. Jeśli go nie masz, zarejestruj się pod adresem https://signup.mailgun.com/.
- Klucz interfejsu API usługi Mailgun lub klucz wysyłania domeny.
- Prawidłowy region interfejsu API mailgun dla Twojego konta: USA lub UE.
- Do wysyłania wiadomości e-mail domena wysyłająca wiadomość e-mail. Wysyłanie produkcyjne wymaga zweryfikowanej domeny.
- W przypadku akcji weryfikacji uzyskaj dostęp do funkcji Mailgun Validate.
Domeny piaskownicy mogą służyć do testowania początkowego, ale są ograniczone do autoryzowanych adresatów.
Jak uzyskać poświadczenia
Ten łącznik używa uwierzytelniania klucza interfejsu API Mailgun. Zaloguj się do usługi Mailgun Panel sterowania i utwórz klucz interfejsu API z poziomu zabezpieczeń interfejsu API lub utwórz klucz interfejsu API wysyłającego specyficzne dla domeny na podstawie ustawień domeny wysyłającej.
Łącznik używa uwierzytelniania podstawowego jako api nazwy użytkownika i klucza interfejsu API Mailgun jako hasła. Podczas konfigurowania połączenia wybierz region interfejsu API Mailgun, który odpowiada Twojemu kontu.
Obsługiwane operacje
Ten łącznik obsługuje następujące operacje:
-
Send Email: Wyślij wiadomość e-mail przy użyciu domeny wysyłającej mailgun. -
Get Domain Information: Pobierz informacje o domenie mailgun. -
Validate Email Address: Zweryfikuj indywidualny adres e-mail. -
Submit Bulk Validation Job: Prześlij zadanie weryfikacji zbiorczej wiadomości e-mail. -
Get Bulk Validation Results: pobieranie wyników weryfikacji zbiorczej wiadomości e-mail.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Nazwa | Typ | Opis | Wymagane |
|---|---|---|---|
| klucz interfejsu API | securestring | Prywatny klucz interfejsu API Mailgun | True |
| Region poczty | ciąg | Wybierz pozycję Mailgun US lub Mailgun EU | True |
Akcje
| Pobieranie domen |
Pobierz listę domen. Można filtrować według stanu lub urzędu. Lista jest podzielony na strony i ograniczona do 1000 elementów na stronę. |
| Pobieranie szczegółów domeny |
Pobiera reprezentację JSON domeny, która zawiera szczegółowe informacje o stanie i ustawieniach domeny. |
| Uzyskiwanie wyników weryfikacji zbiorczej |
Pobiera stan zadania weryfikacji zbiorczej i wyniki podsumowania dla wcześniej przesłanego zadania. |
| Walidacja zbiorczej poczty e-mail |
Przekaż plik CSV z kolumną nagłówka wiadomości e-mail i uruchom zadanie weryfikacji zbiorczej przy użyciu interfejsu API V4 usługi Mailgun. |
| Weryfikowanie wiadomości e-mail |
Weryfikuje adres e-mail przy użyciu usługi sprawdzania poprawności aplikacji Mailgun i zwraca wyniki dostarczania. |
| Wyślij e-mail |
Wysyła wiadomość e-mail przy użyciu konta Mailgun za pośrednictwem pól formularzy wieloczęściowych zgodnych z interfejsem API wiadomości Mailgun. |
Pobieranie domen
Pobierz listę domen. Można filtrować według stanu lub urzędu. Lista jest podzielony na strony i ograniczona do 1000 elementów na stronę.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Maksymalna liczba elementów. Maksymalna: 1000. Ustawienie domyślne: 100 |
|
|
Pomiń
|
skip | integer |
Pobierz listę elementów rozpoczynających się od nth elementu. Wartość domyślna: 0 |
|
|
State
|
state | string |
Pobieraj tylko domeny o określonym stanie. Może być aktywny, niezweryfikowany lub wyłączony. |
|
|
Sortuj
|
sort | string |
Prawidłowe opcje sortowania to nazwa (asc), name:asc lub name:desc. |
|
|
Władza
|
authority | string |
Pobieraj tylko domeny z określonym urzędem. |
|
|
Search
|
search | string |
Wyszukaj domeny według podanej częściowej lub pełnej nazwy. Nie obsługuje symboli wieloznacznych. |
|
|
Uwzględnij konta podrzędne
|
include_subaccounts | boolean |
Wyszukaj w każdej domenie, która należy do dowolnego konta podrzędnego w ramach tego konta. Wartość domyślna: false. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
total_count
|
total_count | integer |
Łączna liczba domen |
|
items
|
items | array of object |
Lista domen |
|
id
|
items.id | string |
Unikatowy identyfikator domeny |
|
nazwa
|
items.name | string |
W pełni kwalifikowana nazwa domeny zarejestrowana w aplikacji Mailgun |
|
stan
|
items.state | string |
Bieżący stan weryfikacji domeny |
|
typ
|
items.type | string |
Klasyfikacja domeny. Możliwe wartości są niestandardowe lub piaskownicy |
|
utworzono_o
|
items.created_at | string |
Znacznik czasu wskazujący, kiedy domena została utworzona w formacie RFC1123 |
|
is_disabled
|
items.is_disabled | boolean |
Wskazuje, czy domena jest obecnie wyłączona |
|
require_tls
|
items.require_tls | boolean |
Jeśli wartość true Mailgun będzie wysyłać tylko wiadomości za pośrednictwem połączenia TLS |
|
skip_verification
|
items.skip_verification | boolean |
Jeśli wartość true Mailgun nie zweryfikuje certyfikatu i nazwy hosta podczas konfigurowania połączenia TLS |
|
smtp_login
|
items.smtp_login | string |
Nazwa użytkownika logowania SMTP dla domeny |
|
smtp_password
|
items.smtp_password | string |
Opcjonalne hasło SMTP dla domeny używanej do uwierzytelniania SMTP |
|
spam_action
|
items.spam_action | string |
Akcja do wykonania, gdy wiadomość jest oflagowana jako spam. Opcje są wyłączone, tag lub blok |
|
symbol wieloznaczny
|
items.wildcard | boolean |
Wskazuje, czy domena jest domeną z symbolami wieloznacznymi i może odbierać wiadomości e-mail dla dowolnej poddomeny |
|
subaccount_id
|
items.subaccount_id | string |
Identyfikator konta podrzędnego, do którego należy domena |
|
tracking_host
|
items.tracking_host | string |
Zostanie otwarty niestandardowy host śledzenia dla domeny używanej do śledzenia i kliknięć |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Jeśli wartość true Mailgun automatycznie zarządza konfiguracją rekordów DKIM i rekordów DNS |
|
web_prefix
|
items.web_prefix | string |
Prefiks poddomeny używany do otwierania i klikania przycisków śledzenia |
|
web_scheme
|
items.web_scheme | string |
Schemat protokołu używany do śledzenia |
|
archive_to
|
items.archive_to | string |
Adres URL, do którego zostanie wysłana kopia każdej pomyślnie dostarczonej wiadomości |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Jeśli prawdziwe komunikaty przychodzące do tej domeny zostaną zaszyfrowane |
|
message_ttl
|
items.message_ttl | integer |
Określa czas wygaśnięcia (TTL) w sekundach na pobieranie zarówno przychodzących, jak i wychodzących komunikatów |
Pobieranie szczegółów domeny
Pobiera reprezentację JSON domeny, która zawiera szczegółowe informacje o stanie i ustawieniach domeny.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa domeny
|
name | True | string |
Nazwa domeny, którą chcesz pobrać |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
domain.id | string |
Unikatowy identyfikator domeny |
|
nazwa
|
domain.name | string |
W pełni kwalifikowana nazwa domeny zarejestrowana w aplikacji Mailgun |
|
stan
|
domain.state | string |
Bieżący stan weryfikacji domeny |
|
typ
|
domain.type | string |
Klasyfikacja domeny. Możliwe wartości są niestandardowe lub piaskownicy |
|
utworzono_o
|
domain.created_at | string |
Znacznik czasu wskazujący, kiedy domena została utworzona w formacie RFC1123 |
|
is_disabled
|
domain.is_disabled | boolean |
Wskazuje, czy domena jest obecnie wyłączona |
|
require_tls
|
domain.require_tls | boolean |
Jeśli wartość true Mailgun będzie wysyłać tylko wiadomości za pośrednictwem połączenia TLS |
|
skip_verification
|
domain.skip_verification | boolean |
Jeśli wartość true Mailgun nie zweryfikuje certyfikatu i nazwy hosta podczas konfigurowania połączenia TLS |
|
smtp_login
|
domain.smtp_login | string |
Nazwa użytkownika logowania SMTP dla domeny |
|
smtp_password
|
domain.smtp_password | string |
Opcjonalne hasło SMTP dla domeny używanej do uwierzytelniania SMTP |
|
spam_action
|
domain.spam_action | string |
Akcja do wykonania, gdy wiadomość jest oflagowana jako spam. Opcje są wyłączone, tag lub blok |
|
symbol wieloznaczny
|
domain.wildcard | boolean |
Wskazuje, czy domena jest domeną z symbolami wieloznacznymi i może odbierać wiadomości e-mail dla dowolnej poddomeny |
|
subaccount_id
|
domain.subaccount_id | string |
Identyfikator konta podrzędnego, do którego należy domena |
|
tracking_host
|
domain.tracking_host | string |
Zostanie otwarty niestandardowy host śledzenia dla domeny używanej do śledzenia i kliknięć |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Jeśli wartość true Mailgun automatycznie zarządza konfiguracją rekordów DKIM i rekordów DNS |
|
web_prefix
|
domain.web_prefix | string |
Prefiks poddomeny używany do otwierania i klikania przycisków śledzenia |
|
web_scheme
|
domain.web_scheme | string |
Schemat protokołu używany do śledzenia |
|
archive_to
|
domain.archive_to | string |
Adres URL, do którego zostanie wysłana kopia każdej pomyślnie dostarczonej wiadomości |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Jeśli prawdziwe komunikaty przychodzące do tej domeny zostaną zaszyfrowane |
|
message_ttl
|
domain.message_ttl | integer |
Określa czas wygaśnięcia (TTL) w sekundach na pobieranie zarówno przychodzących, jak i wychodzących komunikatów |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Lista rekordów DNS wymaganych do odbierania wiadomości e-mail |
|
is_active
|
receiving_dns_records.is_active | boolean |
Wskazuje, czy rekord DNS jest obecnie aktywny |
|
Buforowane
|
receiving_dns_records.cached | array of string |
Lista wartości buforowanych poczty e-mail dla rekordu DNS |
|
nazwa
|
receiving_dns_records.name | string |
Nazwa rekordu DNS, jeśli ma to zastosowanie |
|
priorytet
|
receiving_dns_records.priority | string |
Wartość priorytetu dla rekordów DNS MX |
|
record_type
|
receiving_dns_records.record_type | string |
Typ rekordu DNS, takiego jak MX, TXT lub CNAME |
|
prawidłowy
|
receiving_dns_records.valid | string |
Wskazuje, czy rekord DNS jest prawidłowy |
|
value
|
receiving_dns_records.value | string |
Oczekiwana wartość rekordu DNS |
|
sending_dns_records
|
sending_dns_records | array of object |
Lista rekordów DNS wymaganych do wysyłania wiadomości e-mail |
|
is_active
|
sending_dns_records.is_active | boolean |
Wskazuje, czy rekord DNS jest obecnie aktywny |
|
Buforowane
|
sending_dns_records.cached | array of string |
Lista wartości buforowanych poczty e-mail dla rekordu DNS |
|
nazwa
|
sending_dns_records.name | string |
Nazwa rekordu DNS, jeśli ma to zastosowanie |
|
priorytet
|
sending_dns_records.priority | string |
Wartość priorytetu dla rekordów DNS MX |
|
record_type
|
sending_dns_records.record_type | string |
Typ rekordu DNS, takiego jak MX, TXT lub CNAME |
|
prawidłowy
|
sending_dns_records.valid | string |
Wskazuje, czy rekord DNS jest prawidłowy |
|
value
|
sending_dns_records.value | string |
Oczekiwana wartość rekordu DNS |
Uzyskiwanie wyników weryfikacji zbiorczej
Pobiera stan zadania weryfikacji zbiorczej i wyniki podsumowania dla wcześniej przesłanego zadania.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania
|
list_id | True | string |
Identyfikator zadania zwrócony z żądania weryfikacji zbiorczej. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator zadania
|
id | string |
Identyfikator zadania |
|
Identyfikator zadania
|
list_id | string |
Nazwa listy zadań |
|
Stan zadania
|
status | string |
Bieżący stan zadania |
|
Data utworzenia
|
created_at | integer |
Po utworzeniu zadania (sygnatura czasowa systemu Unix) |
|
Adres URL pobierania pliku CSV
|
download_url.csv | string |
Adres URL umożliwiający pobranie wszystkich wyników jako pliku CSV |
|
Adres URL pobierania wyselekcjonowanych plików CSV
|
download_url.curated_csv | string |
Adres URL pobierania wyników wyselekcjonowanych jako plik CSV |
|
Adres URL pobierania kodu JSON
|
download_url.json | string |
Adres URL umożliwiający pobranie wszystkich wyników jako pliku JSON |
|
Adres URL pobierania wyselekcjonowanych danych JSON
|
download_url.curated_json | string |
Adres URL pobierania wyselekcjonowanych wyników jako pliku JSON |
|
Łączna ilość
|
quantity | integer |
Łączna liczba rekordów w zadaniu |
|
Przetworzone rekordy
|
records_processed | integer |
Liczba przetworzonych rekordów do tej pory |
|
Liczba elementów dostarczanych
|
summary.result.deliverable | integer |
Liczba adresów dostarczanych |
|
Niemożliwa do odzyskania liczba
|
summary.result.undeliverable | integer |
Liczba niemożliwych do dostarczenia adresów |
|
Przechwyć wszystkie liczby
|
summary.result.catch_all | integer |
Liczba adresów catch-all |
|
Nie wysyłaj liczby
|
summary.result.do_not_send | integer |
Liczba adresów oflagowanych jako nie wysyłaj |
|
Zaakceptuj wszystkie liczby
|
summary.result.accept_all | integer |
Liczba adresów akceptowanych |
|
Nieznana liczba
|
summary.result.unknown | integer |
Liczba adresów z nieznaną możliwością dostarczania |
|
Liczba wysokiego ryzyka
|
summary.risk.high | integer |
Liczba adresów wysokiego ryzyka |
|
Średnia liczba ryzyka
|
summary.risk.medium | integer |
Liczba średniego ryzyka |
|
Liczba niskich ryzyk
|
summary.risk.low | integer |
Liczba adresów o niskim ryzyku |
|
Nieznana liczba ryzyka
|
summary.risk.unknown | integer |
Liczba adresów o nieznanym ryzyku |
|
Liczba bardzo zaangażowanych
|
summary.engagement.highly_engaged | integer |
Liczba adresów o wysokim zaangażowaniu |
|
Liczba zaangażowanych
|
summary.engagement.engaged | integer |
Liczba adresów zaangażowanych |
|
Liczba niezaangażowanych
|
summary.engagement.disengaged | integer |
Liczba niezaangażowanych adresów |
|
Liczba botów
|
summary.engagement.bot | integer |
Liczba adresów botów |
|
Liczba narzekań
|
summary.engagement.complainer | integer |
Liczba adresów skarg |
|
Brak liczby danych
|
summary.engagement.no_data | integer |
Liczba adresów bez danych zakontraktowania |
Walidacja zbiorczej poczty e-mail
Przekaż plik CSV z kolumną nagłówka wiadomości e-mail i uruchom zadanie weryfikacji zbiorczej przy użyciu interfejsu API V4 usługi Mailgun.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa listy zadań
|
list_id | True | string |
Parametr ścieżki identyfikujący zadanie weryfikacji zbiorczej. |
|
Plik CSV
|
file | True | file |
Plik CSV do przekazania. Plik musi zawierać nagłówek o nazwie email. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator zadania (nazwa listy)
|
id | string |
Identyfikator zadania (nazwa listy) |
|
Komunikat serwera
|
message | string |
Komunikat o stanie z usługi Mailgun |
Weryfikowanie wiadomości e-mail
Weryfikuje adres e-mail przy użyciu usługi sprawdzania poprawności aplikacji Mailgun i zwraca wyniki dostarczania.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres e-mail
|
address | True | string |
Adres e-mail do zweryfikowania. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Adres e-mail
|
address | string |
Zweryfikowany adres e-mail |
|
Jest prawidłowy
|
is_valid | boolean |
Czy mailgun uważa adres za prawidłowy |
|
Weryfikacja skrzynki pocztowej
|
mailbox_verification | string |
Stan weryfikacji skrzynki pocztowej |
|
Czy adres jednorazowy
|
is_disposable_address | boolean |
Czy adres pochodzi od dostawcy jednorazowego |
|
Czy adres roli
|
is_role_address | boolean |
Czy adres jest adresem opartym na rolach |
|
Przyczyna walidacji
|
reason | array of string |
Przyczyny weryfikacji zwrócone przez mailgun (puste, gdy są prawidłowe) |
|
Poziom ryzyka
|
risk | string |
Poziom ryzyka przypisany przez Mailgun |
|
Wynik
|
result | string |
Wynik dostarczania mailgun (na przykład dostarczany lub niemożliwy do uzyskania) |
|
Adres główny
|
root_address | string |
Znormalizowany adres główny |
|
Wyświetlana nazwa
|
parts.display_name | string |
Część wyświetlana nazwy adresu |
|
Domena
|
parts.domain | string |
Część adresu w domenie |
|
Część lokalna
|
parts.local_part | string |
Lokalna część adresu |
Wyślij e-mail
Wysyła wiadomość e-mail przy użyciu konta Mailgun za pośrednictwem pól formularzy wieloczęściowych zgodnych z interfejsem API wiadomości Mailgun.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa domeny
|
domain_name | True | string |
Domena do wysłania wiadomości e-mail z |
|
Z adresu e-mail
|
from | True | string |
Adres e-mail, z poziomu których zostanie wysłana wiadomość. |
|
Do adresu e-mail
|
to | True | string |
Adres e-mail adresata. |
|
Temat
|
subject | True | string |
Temat wiadomości e-mail. |
|
Treść wiadomości e-mail (tekst)
|
text | string |
Treść wiadomości e-mail w postaci zwykłego tekstu. |
|
|
Treść wiadomości e-mail (HTML)
|
html | html |
Treść wiadomości e-mail w formacie HTML. |
|
|
Adres e-mail CC
|
cc | string |
Adres e-mail adresata kopii dwutlenku węgla. |
|
|
Adres e-mail BCC
|
bcc | string |
Niewidomy adres e-mail adresata kopii węgla. |
|
|
adres e-mail Reply-To
|
h:Reply-To | string |
Gdzie należy dostarczyć odpowiedzi. |
|
|
Załącznik
|
attachment | file |
Załącznik pliku do dołączenia do wiadomości. |
|
|
Tags
|
o:tag | array |
Co najmniej jeden tag do grupowania i filtrowania wiadomości e-mail w aplikacji Mailgun (do 10 na wiadomość). |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator komunikatu
|
id | string |
Unikatowy identyfikator przypisany do komunikatu w kolejce |
|
Komunikat o stanie
|
message | string |
Stan czytelny dla człowieka z funkcji Mailgun (na przykład w kolejce. Dziękuję. |