Freigeben über

Azure Communication Email

Connector zum Senden von E-Mails mithilfe der Domänen, die mit den Azure Communication Services in Ihrem Abonnement verknüpft sind.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Microsoft
URL https://azure.microsoft.com/services/communication-services
Email acssolutions@microsoft.com
Connectormetadaten
Herausgeber Microsoft
Webseite https://azure.microsoft.com/services/communication-services
Datenschutzrichtlinie https://privacy.microsoft.com
Kategorien Communication

Azure Communication Services Email ist ein neuer Grundtyp, der Transaktions-, Massen- und Marketing-E-Mails auf der Azure Communication Services-Plattform erleichtert und Anwendungs-zu-Person(A2P)-Anwendungsfälle ermöglicht. Die E-Mail-Angebote von Azure Communication Services verbessern Ihren Zeit-zu-Markt mit skalierbaren, zuverlässigen E-Mail-Funktionen mit Ihren eigenen SMTP-Domänen. Wie andere Kommunikationsmodalitäten hat das E-Mail-Angebot nur den Vorteil, dass Sie nur für ihre Nutzung bezahlen.

Voraussetzungen

Sie benötigen Folgendes, um fortzufahren:

  • Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature
  • Ein Azure-Abonnement
  • Eine E-Mail-Ressource für Azure Communication Services mit einer konfigurierten Domäne
  • Eine Azure Communication Services-Ressource, die mit einer Azure-E-Mail-Domäne verbunden ist

So erhalten Sie Anmeldeinformationen

  1. Einrichten einer Azure Communication Services-Ressource

  2. Einrichten einer E-Mail-Ressource für Azure Commuincation Services

    1. Erstellen einer E-Mail-Ressource
    2. Konfigurieren einer Domäne

  3. Verbinden der E-Mail-Domäne mit der Kommunikationsdienste-Ressource

  4. Authentifizierung mit Verbindungszeichenfolge

Erste Schritte mit Ihrem Connector

Nachdem Sie eine E-Mail-Ressource für Azure Communication Services eingerichtet und eine Domäne konfiguriert haben, navigieren Sie zur bereitgestellten Domäne, und kopieren Sie die MailFrom E-Mail. Dies wird als From E-Mail in der Send email Aktion verwendet.

Bekannte Probleme und Einschränkungen

  1. Azure Communication Services-E-Mail befindet sich derzeit in der öffentlichen Vorschau. Vorschau-APIs und SDKs werden ohne Vereinbarung auf Serviceebene bereitgestellt und werden für Produktionsworkloads nicht empfohlen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar.

  2. Unterstützt zurzeit die Dienstprinzipalauthentifizierung (Microsoft Entra ID-Anwendung) nicht.

  3. Nur diese E-Mail-Anlagentypen werden unterstützt.

Häufige Fehler und Abhilfemaßnahmen

Beim Anfügen nicht unterstützter Anlagen schlägt die Send email Aktion als BadRequest fehl. Weitere Informationen finden Sie unter diesen E-Mail-Anlagentypen.

Häufig gestellte Fragen

  1. Wo befindet sich meine E-Mail?

    • Die E-Mail-Zustellung kann bis zu ein paar Minuten dauern und endet bei Verwendung von azure Managed Domains im Junk-E-Mail-Feld. Vergewissern Sie sich, dass Sie ihr Junk-E-Mail-Kontrollkästchen aktivieren.

  2. Wie senden Sie eine E-Mail mit Anlagen?

    • E-Mail-Anlagen erfordern sowohl einen Anlagennamen als auch einen Anlageninhalt. Einige Dateihostingdienste, z. B. OneDrive und SharePoint, verfügen über systemeigene Unterstützung in Power Automate, und sie verfügen über Aktionen, z Get file metadata . B. zum Abrufen des Dateinamens und Get file content zum Abrufen des Dateiinhalts.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:
Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
Verbindungszeichenfolge securestring Verbindungszeichenfolge für Azure Communication Services. Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

E-Mail-Nachrichtenstatus abrufen

Ruft den Status einer zuvor gesendeten E-Mail-Nachricht ab.
E-Mail-Nachrichtenstatus abrufen (Vorschau) – VERALTET [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen den Status "E-Mail-Nachricht abrufen ".

Ruft den Status einer zuvor gesendeten E-Mail-Nachricht ab – VERALTET
E-Mail senden

Sendet eine E-Mail-Nachricht an einen oder mehrere Empfänger.
E-Mail senden (Vorschau) – VERALTET [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "E-Mail senden" .

Sendet eine E-Mail-Nachricht an einen oder mehrere Empfänger – VERALTET

E-Mail-Nachrichtenstatus abrufen

Vorgangs-ID:
GetMessageStatusGAVersion

Ruft den Status einer zuvor gesendeten E-Mail-Nachricht ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorgangs-ID
 operationId True string

Vorgangs-ID eines vorherigen Anrufs zum Senden von E-Mails.

Gibt zurück

Status des Vorgangs mit langer Ausführungszeit

Body
EmailSendResult

E-Mail-Nachrichtenstatus abrufen (Vorschau) – VERALTET [VERALTET]

Vorgangs-ID:
GetMessageStatus

Diese Aktion ist veraltet. Verwenden Sie stattdessen den Status "E-Mail-Nachricht abrufen ".

Ruft den Status einer zuvor gesendeten E-Mail-Nachricht ab – VERALTET

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Nachrichten-ID
 messageId True string

Nachrichten-ID eines vorherigen Anrufs zum Senden von E-Mails.

Gibt zurück

Name Pfad Typ Beschreibung
Nachrichten-ID
 messageId string
Nachrichtenstatus
 status string

E-Mail senden

Vorgangs-ID:
SendEmailGAVersion

Sendet eine E-Mail-Nachricht an einen oder mehrere Empfänger.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Von
 senderAddress True string

Die E-Mail-Adresse des Absenders aus einer überprüften Domäne.11
Wichtigkeit
 importance string
E-Mail (An)
 address True string

Die E-Mail-Adresse des Hauptempfängers.
E-Mail (CC)
 address True string

Die E-Mail-Adresse des zusätzlichen Empfängers.
E-Mail (BCC)
 address True string

Die E-Mail-Adresse des zusätzlichen Empfängers, der in der E-Mail-Kette unsichtbar ist.
Betreff
 subject True string

Geben Sie den Betreff der E-Mail an.
Body
 html html

Geben Sie den Textkörper der E-Mail an.
E-Mail (Antworten auf)
 address True string

Die E-Mail-Adresse, an die die Antworten der Empfänger gesendet werden.
Name
 name True string

Anlagenname mit Erweiterung.
Typ
 contentType True string

Der Typ der Anlagendatei.
Content
 contentInBase64 True byte

Anlageninhalt.
name
 name True string

Eingabetaste.
value
 value True string

Geben Sie den Wert ein.
Deaktivieren der Benutzerbindungsnachverfolgung
 userEngagementTrackingDisabled boolean

Gibt an, ob die Benutzerbindungsnachverfolgung für diese Anforderung deaktiviert werden soll, wenn die Einstellung für die Benutzerbindungsnachverfolgung auf Ressourcenebene bereits in der Steuerungsebene aktiviert wurde.

Gibt zurück

Status des Vorgangs mit langer Ausführungszeit

Body
EmailSendResult

E-Mail senden (Vorschau) – VERALTET [VERALTET]

Vorgangs-ID:
SendEmail

Diese Aktion ist veraltet. Verwenden Sie stattdessen "E-Mail senden" .

Sendet eine E-Mail-Nachricht an einen oder mehrere Empfänger – VERALTET

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Von
 sender True string

Die E-Mail-Adresse des Absenders aus einer überprüften Domäne.
E-Mail (An)
 email True string

Die E-Mail-Adresse des Hauptempfängers.
E-Mail (CC)
 email True string

Die E-Mail-Adresse des zusätzlichen Empfängers.
E-Mail (BCC)
 email True string

Die E-Mail-Adresse des zusätzlichen Empfängers, der in der E-Mail-Kette unsichtbar ist.
Betreff
 subject True string

Geben Sie den Betreff der E-Mail an.
Body
 html html

Geben Sie den Textkörper der E-Mail an.
E-Mail (Antworten auf)
 email True string

Die E-Mail-Adresse, an die die Antworten der Empfänger gesendet werden.
Name
 name True string

Anlagenname mit Erweiterung.
Content
 contentBytesBase64 True byte

Anlageninhalt.
Wichtigkeit
 importance string

Der Wichtigkeitstyp für die E-Mail.
Deaktivieren der Benutzerbindungsnachverfolgung
 disableUserEngagementTracking boolean

Gibt an, ob die Benutzerbindungsnachverfolgung für diese Anforderung deaktiviert werden soll, wenn die Einstellung für die Benutzerbindungsnachverfolgung auf Ressourcenebene bereits in der Steuerungsebene aktiviert wurde.

Definitionen

FehlerDetail

Das Fehlerdetails.

Name Pfad Typ Beschreibung
Code
 code string

Der Fehlercode.
message
 message string

Die Fehlermeldung.
target
 target string

Das Fehlerziel.
details
 details array of ErrorDetail

Die Fehlerdetails.
zusätzlicheInformationen
 additionalInfo array of ErrorAdditionalInfo

Die zusätzlichen Informationen des Fehlers.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Pfad Typ Beschreibung
type
 type string

Der zusätzliche Informationstyp.
info
 info object

Die zusätzlichen Informationen.

ErgebnisDesE-MailVersands

Status des Vorgangs mit langer Ausführungszeit

Name Pfad Typ Beschreibung
id
 id string

Die eindeutige ID des Vorgangs. Verwenden Sie eine UUID.
status
 status string

Status des Vorgangs.
Fehler
 error ErrorDetail

Das Fehlerdetails.