Udostępnij przez

Wiadomość e-mail dotycząca komunikacji platformy Azure

Łącznik do wysyłania wiadomości e-mail przy użyciu domen połączonych z usługami Azure Communication Services w ramach subskrypcji.

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 https://azure.microsoft.com/services/communication-services
Email acssolutions@microsoft.com
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://azure.microsoft.com/services/communication-services
Zasady ochrony prywatności https://privacy.microsoft.com
Kategorie Communication

Poczta e-mail usług Azure Communication Services to nowy element pierwotny, który ułatwia obsługę dużych ilości transakcyjnych, zbiorczych i marketingowych wiadomości e-mail na platformie usług Azure Communication Services i umożliwi przypadki użycia aplikacji do osoby (A2P). Oferty poczty e-mail usług Azure Communication Services poprawią czas na rynek dzięki skalowalnym, niezawodnym funkcjom poczty e-mail z własnymi domenami SMTP. Podobnie jak w przypadku innych modalności komunikacyjnych Oferta poczty e-mail ma korzyść tylko z płacenia za to, czego używasz.

Wymagania wstępne

Aby kontynuować, musisz wykonać następujące czynności:

  • Plan usługi Microsoft Power Apps lub Power Automate z funkcją łącznika niestandardowego
  • Subskrypcja platformy Azure
  • Zasób poczty e-mail usług Azure Communication Services ze skonfigurowaną domeną
  • Zasób usług Azure Communication Services połączony z domeną usługi Azure Email

Jak uzyskać poświadczenia

  1. Konfigurowanie zasobu usług Azure Communication Services

  2. Konfigurowanie zasobu poczty e-mail usług Azure Commuincation Services

    1. Tworzenie zasobu poczty e-mail
    2. Konfigurowanie domeny

  3. Łączenie domeny poczty e-mail z zasobem usług komunikacyjnych

  4. Uwierzytelnianie ciągu połączenia

Wprowadzenie do łącznika

Po skonfigurowaniu zasobu poczty e-mail usług Azure Communication Services i skonfigurowaniu domeny przejdź do aprowizowanej domeny i skopiuj MailFrom wiadomość e-mail. Będzie to używane jako From wiadomość e-mail w Send email akcji.

Znane problemy i ograniczenia

  1. Poczta e-mail usług Azure Communication Services jest obecnie dostępna w publicznej wersji zapoznawczej. Interfejsy API w wersji zapoznawczej i zestawy SDK są udostępniane bez umowy dotyczącej poziomu usług i nie są zalecane w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości.

  2. Obecnie nie obsługuje uwierzytelniania jednostki usługi (aplikacji Microsoft Entra ID).

  3. Obsługiwane są tylko te typy załączników wiadomości e-mail .

Typowe błędy i środki zaradcze

Podczas dołączania nieobsługiwanych załączników Send email akcja zakończy się niepowodzeniem jako BadRequest. Zapoznaj się z tymi typami załączników wiadomości e-mail.

Często zadawane pytania

  1. Gdzie znajduje się mój adres e-mail?

    • Dostarczanie wiadomości e-mail może potrwać do kilku minut i kończy się w polu wiadomości-śmieci podczas korzystania z domen zarządzanych platformy Azure. Pamiętaj, aby zaznaczyć pole wiadomości-śmieci.

  2. Jak wysłać wiadomość e-mail z załącznikami?

    • Załączniki wiadomości e-mail wymagają zarówno nazwy załącznika, jak i zawartości załącznika. Niektóre usługi hostingu plików, takie jak OneDrive i SharePoint, mają natywną obsługę w usłudze Power Automate i mają akcje, takie jak Get file metadata uzyskanie nazwy pliku i Get file content uzyskanie zawartości pliku.

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.

Name Typ Description Wymagane
Ciąg połączenia securestring Parametry połączenia usług Azure Communication Services. Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Pobieranie stanu wiadomości e-mail (wersja zapoznawcza) — PRZESTARZAŁE [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj pozycji Pobierz stan wiadomości e-mail .

Pobiera stan wysłanej wcześniej wiadomości e-mail — PRZESTARZAŁE
Uzyskiwanie stanu wiadomości e-mail

Pobiera stan wysłanej wcześniej wiadomości e-mail.
Wyślij e-mail

Wysyła wiadomość e-mail do co najmniej jednego adresata.
Wyślij wiadomość e-mail (wersja zapoznawcza) — PRZESTARZAŁE [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Wyślij wiadomość e-mail .

Wysyła wiadomość e-mail do co najmniej jednego adresata — PRZESTARZAŁE

Pobieranie stanu wiadomości e-mail (wersja zapoznawcza) — PRZESTARZAŁE [PRZESTARZAŁE]

Identyfikator operacji:
GetMessageStatus

Ta akcja została przestarzała. Zamiast tego użyj pozycji Pobierz stan wiadomości e-mail .

Pobiera stan wysłanej wcześniej wiadomości e-mail — PRZESTARZAŁE

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator komunikatu
 messageId True string

Identyfikator wiadomości z poprzedniego połączenia w celu wysłania wiadomości e-mail.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator komunikatu
 messageId string
Stan komunikatu
 status string

Uzyskiwanie stanu wiadomości e-mail

Identyfikator operacji:
GetMessageStatusGAVersion

Pobiera stan wysłanej wcześniej wiadomości e-mail.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator operacji
 operationId True string

Identyfikator operacji z poprzedniego wywołania w celu wysłania wiadomości e-mail.

Zwraca

Status długotrwałej operacji

Body
EmailSendResult

Wyślij e-mail

Identyfikator operacji:
SendEmailGAVersion

Wysyła wiadomość e-mail do co najmniej jednego adresata.

Parametry

Nazwa Klucz Wymagane Typ Opis
Źródło
 senderAddress True string

Adres e-mail nadawcy z zweryfikowanej domeny.11
Ważność
 importance string
Adres e-mail (do)
 address True string

Adres e-mail głównego adresata.
Wiadomość e-mail (CC)
 address True string

Adres e-mail dodatkowego adresata.
Poczta e-mail (BCC)
 address True string

Adres e-mail dodatkowego adresata, który jest niewidoczny w łańcuchu poczty e-mail.
Temat
 subject True string

Określ temat wiadomości e-mail.
Body
 html html

Określ treść wiadomości e-mail.
Wiadomość e-mail (odpowiedz na)
 address True string

Adres e-mail, na który będą wysyłane odpowiedzi adresatów.
Name
 name True string

Nazwa załącznika z rozszerzeniem.
Typ
 contentType True string

Typ pliku załącznika.
Content
 contentInBase64 True byte

Zawartość załącznika.
nazwa
 name True string

Wprowadź klucz.
value
 value True string

Wprowadź wartość.
Wyłączanie śledzenia zaangażowania użytkowników
 userEngagementTrackingDisabled boolean

Wskazuje, czy śledzenie aktywności użytkowników powinno być wyłączone dla tego żądania, jeśli ustawienie śledzenia zaangażowania użytkownika na poziomie zasobu zostało już włączone na płaszczyźnie sterowania.

Zwraca

Status długotrwałej operacji

Body
EmailSendResult

Wyślij wiadomość e-mail (wersja zapoznawcza) — PRZESTARZAŁE [PRZESTARZAŁE]

Identyfikator operacji:
SendEmail

Ta akcja została przestarzała. Zamiast tego użyj polecenia Wyślij wiadomość e-mail .

Wysyła wiadomość e-mail do co najmniej jednego adresata — PRZESTARZAŁE

Parametry

Nazwa Klucz Wymagane Typ Opis
Źródło
 sender True string

Adres e-mail nadawcy z zweryfikowanej domeny.
Adres e-mail (do)
 email True string

Adres e-mail głównego adresata.
Wiadomość e-mail (CC)
 email True string

Adres e-mail dodatkowego adresata.
Poczta e-mail (BCC)
 email True string

Adres e-mail dodatkowego adresata, który jest niewidoczny w łańcuchu poczty e-mail.
Temat
 subject True string

Określ temat wiadomości e-mail.
Body
 html html

Określ treść wiadomości e-mail.
Wiadomość e-mail (odpowiedz na)
 email True string

Adres e-mail, na który będą wysyłane odpowiedzi adresatów.
Name
 name True string

Nazwa załącznika z rozszerzeniem.
Content
 contentBytesBase64 True byte

Zawartość załącznika.
Ważność
 importance string

Typ ważności wiadomości e-mail.
Wyłączanie śledzenia zaangażowania użytkowników
 disableUserEngagementTracking boolean

Wskazuje, czy śledzenie aktywności użytkowników powinno być wyłączone dla tego żądania, jeśli ustawienie śledzenia zaangażowania użytkownika na poziomie zasobu zostało już włączone na płaszczyźnie sterowania.

Definicje

ErrorDetail (Szczegół błędu)

Szczegóły błędu.

Nazwa Ścieżka Typ Opis
kod
 code string

Kod błędu.
komunikat
 message string

Komunikat o błędzie.
miejsce docelowe
 target string

Element docelowy błędu.
details
 details array of ErrorDetail

Szczegóły błędu.
dodatkoweInformacje
 additionalInfo array of ErrorAdditionalInfo

Dodatkowe informacje o błędzie.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Ścieżka Typ Opis
typ
 type string

Dodatkowy typ informacji.
info
 info object

Dodatkowe informacje.

WynikWysyłaniaEmaila

Status długotrwałej operacji

Nazwa Ścieżka Typ Opis
id
 id string

Unikatowy identyfikator operacji. Użyj identyfikatora UUID.
stan
 status string

Stan operacji.
błąd
 error ErrorDetail

Szczegóły błędu.