Mandrill
Mandrill to transakcyjny interfejs API poczty e-mail dla użytkowników mailChimp. Jest niezawodny, zaawansowany i idealny do wysyłania wiadomości e-mail opartych na danych, w tym ukierunkowanego handlu elektronicznego i spersonalizowanych wiadomości jeden do jednego.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | 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 | 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 | |
|---|---|
| Name | Microsoft |
| adres URL |
Obsługa usługi Microsoft LogicApps Pomoc techniczna usługi Microsoft Power Automate Obsługa usługi Microsoft Power Apps |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://mandrill.com/ |
| Zasady ochrony prywatności | https://mailchimp.com/legal/privacy/ |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Udostępnialne |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API usługi Mandrill | securestring | Klucz interfejsu API usługi Mandrill | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 1200 | 60 sekund |
Akcje
| Bieżące informacje o użytkowniku |
Zwróć informacje o użytkowniku połączonym z interfejsem API. |
| Wyślij wiadomość e-mail (wersja 2) |
Wyślij nową wiadomość transakcyjną za pośrednictwem usługi Mandrill. |
| Wyślij wiadomość e-mail [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Wyślij wiadomość e-mail (wersja 2).
|
| Wyświetl zaplanowaną wiadomość |
Wysyła zapytania do zaplanowanych wiadomości e-mail. |
Bieżące informacje o użytkowniku
Zwróć informacje o użytkowniku połączonym z interfejsem API.
Zwraca
informacje o użytkowniku, w tym nazwa użytkownika, klucz, reputacja, limit przydziału i historyczne statystyki wysyłania
- Body
- UserInfo
Wyślij wiadomość e-mail (wersja 2)
Wyślij nową wiadomość transakcyjną za pośrednictwem usługi Mandrill.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Zawartość wiadomości
|
html | html |
Pełna zawartość do wysłania |
|
|
Temat
|
subject | True | string |
Temat wiadomości |
|
Z adresu e-mail
|
from_email | True | string |
Adres e-mail nadawcy |
|
Od nazwy
|
from_name | string |
Nazwa e-mail nadawcy |
|
|
Email
|
True | string |
Adres e-mail odbiorcy |
|
|
Name
|
name | string |
Nazwa wyświetlana odbiorcy |
|
|
Wyślij jako
|
type | string |
Typ wysyłania (do, cc, bcc) |
|
|
Dodatkowe nagłówki
|
headers | string |
Dodatkowe nagłówki do dodania do wiadomości (większość nagłówków jest dozwolona) |
|
|
Czy ten komunikat jest ważny (prawda/fałsz)?
|
important | boolean |
Niezależnie od tego, czy ten komunikat jest ważny, i powinien zostać dostarczony przed nieważnym komunikatem |
|
|
Czy śledzić, kiedy zostanie otwarty komunikat (prawda/fałsz)?
|
track_opens | boolean |
Czy włączyć otwarte śledzenie komunikatu |
|
|
Czy śledzić kliknięcia dla tej wiadomości (prawda/fałsz)?
|
track_clicks | boolean |
Czy włączyć śledzenie kliknięć dla komunikatu |
|
|
Czy wypełnić wiadomość tekstowa, jeśli nie istnieje (prawda/fałsz)?
|
auto_text | boolean |
Określa, czy automatycznie wygenerować część tekstową dla wiadomości, które nie mają podanego tekstu |
|
|
Wbudowane style CSS w wiadomości HTML (prawda/fałsz)?
|
inline_css | boolean |
Niezależnie od tego, czy wszystkie style CSS podane w komunikacie HTML mają być automatycznie wbudowane — tylko w przypadku dokumentów HTML mniejszych niż 256 KB rozmiaru |
|
|
Czy usunąć ciąg zapytania z adresu URL w zagregowanych danych (prawda/fałsz)?
|
url_strip_qs | boolean |
Czy usunąć ciąg zapytania z adresów URL podczas agregowania śledzonych danych adresu URL |
|
|
Czy pokazać wszystkich adresatów w wierszu "Do" (prawda/fałsz)?
|
preserve_recipients | boolean |
Czy udostępnić wszystkich adresatów w nagłówku "Do" dla każdej wiadomości e-mail |
|
|
Czy usunąć rejestrowanie zawartości (prawda/fałsz)?
|
view_content_link | boolean |
Określa, czy rejestrować zawartość. Ustaw wartość false, aby usunąć rejestrowanie zawartości dla poufnych wiadomości e-mail |
|
|
Opcjonalny adres BCC
|
bcc_address | string |
Opcjonalny adres do otrzymania dokładnej kopii wiadomości e-mail każdego adresata |
|
|
Niestandardowa domena do śledzenia
|
tracking_domain | string |
Domena niestandardowa do użycia do śledzenia otwiera się i klika zamiast mandrillapp.com |
|
|
Etykiety
|
tags | array of string |
Tablica ciągów do tagowania komunikatu. Statystyki są gromadzone przy użyciu tagów, chociaż przechowujemy tylko pierwsze 100, więc nie powinno to być unikatowe ani często zmieniane. Tagi powinny mieć co najmniej 50 znaków. Wszystkie tagi rozpoczynające się od podkreślenia są zarezerwowane do użytku wewnętrznego i spowodują błędy. |
|
|
Typ MIME
|
type | string |
Typ MIME załącznika |
|
|
Nazwa pliku
|
name | string |
Nazwa pliku załącznika |
|
|
Content
|
content | byte |
Zawartość załącznika |
|
|
Wyślij o
|
send_at | string |
Gdy ta wiadomość powinna zostać wysłana jako znacznik czasu UTC w formacie RRRR-MM-DD HH:MM:SS. Jeśli określisz czas w przeszłości, wiadomość zostanie wysłana natychmiast. Dodatkowa opłata dotyczy zaplanowanej poczty e-mail, a ta funkcja jest dostępna tylko dla kont z dodatnim saldem. |
|
|
Czy włączyć async (prawda/fałsz)?
|
async | boolean |
Włączanie trybu wysyłania w tle zoptymalizowanego pod kątem wysyłania zbiorczego |
|
|
Nazwa dedykowanej puli adresów IP
|
ip_pool | string |
Nazwa dedykowanej puli adresów IP, która powinna być używana do wysyłania komunikatu |
Zwraca
- response
- array of SendMessageResponse
Wyślij wiadomość e-mail [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Wyślij wiadomość e-mail (wersja 2).
Wyślij nową wiadomość transakcyjną za pośrednictwem usługi Mandrill.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Tekst HTML
|
html | string |
Pełna zawartość HTML do wysłania |
|
|
Zawartość tekstowa wiadomości
|
text | True | string |
Zawartość pełnotekstowa do wysłania |
|
Temat
|
subject | True | string |
Temat wiadomości |
|
Z adresu e-mail
|
from_email | True | string |
Adres e-mail nadawcy |
|
Od nazwy
|
from_name | string |
Nazwa e-mail nadawcy |
|
|
Email
|
True | string |
Adres e-mail odbiorcy |
|
|
Name
|
name | string |
Nazwa wyświetlana odbiorcy |
|
|
Wyślij jako
|
type | string |
Typ wysyłania (do, cc, bcc) |
|
|
Dodatkowe nagłówki
|
headers | string |
Dodatkowe nagłówki do dodania do wiadomości (większość nagłówków jest dozwolona) |
|
|
Czy ten komunikat jest ważny (prawda/fałsz)?
|
important | boolean |
Niezależnie od tego, czy ten komunikat jest ważny, i powinien zostać dostarczony przed nieważnym komunikatem |
|
|
Czy śledzić, kiedy zostanie otwarty komunikat (prawda/fałsz)?
|
track_opens | boolean |
Czy włączyć otwarte śledzenie komunikatu |
|
|
Czy śledzić kliknięcia dla tej wiadomości (prawda/fałsz)?
|
track_clicks | boolean |
Czy włączyć śledzenie kliknięć dla komunikatu |
|
|
Czy wypełnić wiadomość tekstowa, jeśli nie istnieje (prawda/fałsz)?
|
auto_text | boolean |
Określa, czy automatycznie wygenerować część tekstową dla wiadomości, które nie mają podanego tekstu |
|
|
Czy wypełnić komunikat HTML, jeśli nie istnieje (prawda/fałsz)?
|
auto_html | boolean |
Określa, czy automatycznie generować część HTML dla komunikatów, które nie mają podanego kodu HTML |
|
|
Wbudowane style CSS w wiadomości HTML (prawda/fałsz)?
|
inline_css | boolean |
Niezależnie od tego, czy wszystkie style CSS podane w komunikacie HTML mają być automatycznie wbudowane — tylko w przypadku dokumentów HTML mniejszych niż 256 KB rozmiaru |
|
|
Czy usunąć ciąg zapytania z adresu URL w zagregowanych danych (prawda/fałsz)?
|
url_strip_qs | boolean |
Czy usunąć ciąg zapytania z adresów URL podczas agregowania śledzonych danych adresu URL |
|
|
Czy pokazać wszystkich adresatów w wierszu "Do" (prawda/fałsz)?
|
preserve_recipients | boolean |
Czy udostępnić wszystkich adresatów w nagłówku "Do" dla każdej wiadomości e-mail |
|
|
Czy usunąć rejestrowanie zawartości (prawda/fałsz)?
|
view_content_link | boolean |
Określa, czy rejestrować zawartość. Ustaw wartość false, aby usunąć rejestrowanie zawartości dla poufnych wiadomości e-mail |
|
|
Opcjonalny adres BCC
|
bcc_address | string |
Opcjonalny adres do otrzymania dokładnej kopii wiadomości e-mail każdego adresata |
|
|
Niestandardowa domena do śledzenia
|
tracking_domain | string |
Domena niestandardowa do użycia do śledzenia otwiera się i klika zamiast mandrillapp.com |
|
|
Etykiety
|
tags | array of string |
Tablica ciągów do tagowania komunikatu. Statystyki są gromadzone przy użyciu tagów, chociaż przechowujemy tylko pierwsze 100, więc nie powinno to być unikatowe ani często zmieniane. Tagi powinny mieć co najmniej 50 znaków. Wszystkie tagi rozpoczynające się od podkreślenia są zarezerwowane do użytku wewnętrznego i spowodują błędy. |
|
|
Typ MIME
|
type | string |
Typ MIME załącznika |
|
|
Nazwa pliku
|
name | string |
Nazwa pliku załącznika |
|
|
Content
|
content | byte |
Zawartość załącznika |
|
|
Wyślij o
|
send_at | string |
Gdy ta wiadomość powinna zostać wysłana jako znacznik czasu UTC w formacie RRRR-MM-DD HH:MM:SS. Jeśli określisz czas w przeszłości, wiadomość zostanie wysłana natychmiast. Dodatkowa opłata dotyczy zaplanowanej poczty e-mail, a ta funkcja jest dostępna tylko dla kont z dodatnim saldem. |
|
|
Czy włączyć async (prawda/fałsz)?
|
async | boolean |
Włączanie trybu wysyłania w tle zoptymalizowanego pod kątem wysyłania zbiorczego |
|
|
Nazwa dedykowanej puli adresów IP
|
ip_pool | string |
Nazwa dedykowanej puli adresów IP, która powinna być używana do wysyłania komunikatu |
Zwraca
- response
- array of SendMessageResponse
Wyświetl zaplanowaną wiadomość
Wysyła zapytania do zaplanowanych wiadomości e-mail.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Do
|
To | string |
Opcjonalny adres e-mail adresata, aby ograniczyć wyniki do |
Zwraca
- response
- array of ListScheduledInfo
Definicje
Informacje o użytkowniku
informacje o użytkowniku, w tym nazwa użytkownika, klucz, reputacja, limit przydziału i historyczne statystyki wysyłania
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Nazwa użytkownika
|
username | string |
Nazwa użytkownika (używana do uwierzytelniania SMTP) |
|
Utworzono w
|
created_at | string |
Data i godzina utworzenia konta usługi Mandrill użytkownika jako ciąg UTC w formacie RRRR-MM-DD HH:MM:SS |
|
Identyfikator publiczny
|
public_id | string |
Unikatowy, trwały identyfikator tego użytkownika |
|
Reputacja
|
reputation | integer |
Reputacja użytkownika w skali od 0 do 100, z 75 ogólnie jest "dobrą" reputacją |
|
Limit przydziału godzinowego
|
hourly_quota | integer |
Maksymalna liczba wiadomości e-mail w usłudze Mandrill będzie dostarczana dla tego użytkownika co godzinę. Wszelkie wiadomości e-mail poza tym zostaną zaakceptowane i wysłane do kolejki w celu późniejszego dostarczenia. Użytkownicy o wyższej reputacji będą mieli wyższe limity przydziału godzinowego |
|
Zaległość
|
backlog | integer |
Liczba wiadomości e-mail, które są kolejkowane do dostarczenia z powodu przekroczenia limitów przydziału miesięcznego lub godzinowego |
|
Statystyki
|
stats | Stats |
agregacja podsumowania statystyk wysyłania konta |
Stats
agregacja podsumowania statystyk wysyłania konta
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Dzisiaj
|
today | StatStruct |
Struktura do przechowywania informacji o statystykach, ta struktura jest udostępniana w statystykach dla dzisiejszych, last_7_days, last_30_days, last_60_days, last_90_days i all_time |
|
last_7_days
|
last_7_days | StatStruct |
Struktura do przechowywania informacji o statystykach, ta struktura jest udostępniana w statystykach dla dzisiejszych, last_7_days, last_30_days, last_60_days, last_90_days i all_time |
|
last_30_days
|
last_30_days | StatStruct |
Struktura do przechowywania informacji o statystykach, ta struktura jest udostępniana w statystykach dla dzisiejszych, last_7_days, last_30_days, last_60_days, last_90_days i all_time |
|
last_60_days
|
last_60_days | StatStruct |
Struktura do przechowywania informacji o statystykach, ta struktura jest udostępniana w statystykach dla dzisiejszych, last_7_days, last_30_days, last_60_days, last_90_days i all_time |
|
last_90_days
|
last_90_days | StatStruct |
Struktura do przechowywania informacji o statystykach, ta struktura jest udostępniana w statystykach dla dzisiejszych, last_7_days, last_30_days, last_60_days, last_90_days i all_time |
|
all_time
|
all_time | StatStruct |
Struktura do przechowywania informacji o statystykach, ta struktura jest udostępniana w statystykach dla dzisiejszych, last_7_days, last_30_days, last_60_days, last_90_days i all_time |
Stat, struktura
Struktura do przechowywania informacji o statystykach, ta struktura jest udostępniana w statystykach dla dzisiejszych, last_7_days, last_30_days, last_60_days, last_90_days i all_time
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Wysłane
|
sent | integer |
Liczba wiadomości e-mail wysłanych dla tego użytkownika |
|
Twarde odbicie
|
hard_bounces | integer |
Liczba ciężko odbitych wiadomości e-mail dla tego użytkownika |
|
Miękkie odbicia
|
soft_bounces | integer |
Liczba nietrwałych wiadomości e-mail dla tego użytkownika |
|
Odrzuca
|
rejects | integer |
Liczba wiadomości e-mail odrzuconych do wysłania tego użytkownika |
|
Skarg
|
complaints | integer |
Liczba skarg na spam dla tego użytkownika |
|
Anulowania subskrypcji
|
unsubs | integer |
Liczba subskrypcji dla tego użytkownika |
|
Unikatowe otwarcie
|
unique_opens | integer |
Liczba otwartych wiadomości e-mail dla tego użytkownika |
|
Kliknięć
|
clicks | integer |
Liczba adresów URL, które zostały kliknięte dla tego użytkownika do tej pory dzisiaj |
|
Unikatowe kliknięcia
|
unique_clicks | integer |
Liczba unikatowych kliknięć wiadomości e-mail wysłanych dla tego użytkownika |
SendMessageResponse
Informacje o wiadomości dla każdego adresata zawierającego klucz "e-mail" z adresem e-mail oraz szczegółowe informacje o stanie wiadomości dla tego adresata
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Email
|
string |
Adres e-mail odbiorcy |
|
|
Stan wysyłania
|
status | string |
Stan wysyłania adresata — "wysłane", "w kolejce", "zaplanowane", "odrzucone" lub "nieprawidłowe" |
|
Odrzuć przyczynę
|
reject_reason | string |
Przyczyna odrzucenia, jeśli stan odbiorcy jest "odrzucony" — jeden z "hard-bounce", "soft-bounce", "spam", "unsub", "custom", "invalid-sender", "invalid", "test-mode-limit", "unsigned" lub "rule" |
|
Identyfikator komunikatu
|
_id | string |
unikatowy identyfikator wiadomości |
ListScheduledInfo
Informacje o konkretnym zdarzeniu smtp
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Adres e-mail adresata
|
string |
Adres e-mail odbiorcy |
|
|
Stan adresata
|
status | string |
Stan wysyłania adresata — "wysłane", "w kolejce", "zaplanowane", "odrzucone" lub "nieprawidłowe" |
|
Przyczyna odrzucenia
|
reject_reason | string |
Przyczyna odrzucenia, jeśli stan odbiorcy jest "odrzucony" — jeden z "hard-bounce", "soft-bounce", "spam", "unsub", "custom", "invalid-sender", "invalid", "test-mode-limit", "unsigned" lub "rule" |
|
Identyfikator komunikatu
|
_id | string |
Unikatowy identyfikator wiadomości |