Partager via


E-mail de communication Azure

Connecteur pour envoyer un e-mail à l’aide des domaines liés à Azure Communication Services dans votre abonnement.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Microsoft
URL https://azure.microsoft.com/services/communication-services
Messagerie électronique acssolutions@microsoft.com
Métadonnées du connecteur
Éditeur Microsoft
Site internet https://azure.microsoft.com/services/communication-services
Politique de confidentialité https://privacy.microsoft.com
Catégories Communication

Azure Communication Services Email est une nouvelle primitive qui facilite les e-mails transactionnels en volume, en bloc et marketing sur la plateforme Azure Communication Services et permet aux cas d’utilisation d’application à personne (A2P). Les offres de messagerie Azure Communication Services améliorent votre délai de commercialisation avec des fonctionnalités de messagerie évolutives et fiables avec vos propres domaines SMTP. Comme d’autres modalités de communication, l’offre e-mail offre a l’avantage de payer uniquement pour ce que vous utilisez.

Prerequisites

Vous devez procéder comme suit :

  • Un plan Microsoft Power Apps ou Power Automate avec une fonctionnalité de connecteur personnalisée
  • Un abonnement Azure
  • Ressource de messagerie Azure Communication Services avec un domaine configuré
  • Ressource Azure Communication Services connectée à un domaine Azure Email

Comment obtenir des informations d’identification

  1. Configurer une ressource Azure Communication Services

  2. Configurer une ressource de messagerie Azure Commuincation Services

    1. Créer une ressource e-mail
    2. Configurer un domaine
  3. Connecter un domaine de messagerie avec la ressource Communication Services

  4. Authentification par chaîne de connexion

Bien démarrer avec votre connecteur

Après avoir configuré une ressource de messagerie Azure Communication Services et configuré un domaine, accédez au domaine approvisionné et copiez l’e-mail MailFrom . Cela sera utilisé comme From e-mail dans l’action Send email .

Problèmes connus et limitations

  1. La version préliminaire publique d’Azure Communication Services Email est actuellement disponible en préversion publique. Les API et kits SDK en préversion sont fournis sans contrat de niveau de service et ne sont pas recommandés pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge.

  2. Ne prend pas en charge l’authentification du principal de service (application Microsoft Entra ID) pour l’instant.

  3. Seuls ces types de pièces jointes de courrier sont pris en charge.

Erreurs courantes et solutions

Lors de l’attachement de pièces jointes non prises en charge, l’action Send email échoue en tant que BadRequest. Reportez-vous à ces types de pièces jointes par e-mail.

Questions fréquentes (FAQ)

  1. Où est mon e-mail ?

    • La remise de courrier électronique peut prendre jusqu’à quelques minutes et se retrouver dans la boîte de courrier indésirable lors de l’utilisation de domaines managés Azure. Veillez à cocher votre boîte de courrier indésirable.
  2. Comment envoyer un e-mail avec des pièces jointes ?

    • Les pièces jointes par e-mail nécessitent à la fois un nom de pièce jointe et un contenu de pièce jointe. Certains services d’hébergement de fichiers, tels que OneDrive et SharePoint, ont une prise en charge native dans Power Automate, et ils ont des actions telles que Get file metadata l’obtention du nom de fichier et Get file content l’obtention du contenu du fichier.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Chaîne de connexion securestring Chaîne de connexion Azure Communication Services. Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Envoyer un e-mail

Envoie un e-mail à un ou plusieurs destinataires.

Envoyer un e-mail (préversion) - DÉCONSEILLÉ [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Envoyer un e-mail .

Envoie un e-mail à un ou plusieurs destinataires - DÉCONSEILLÉ

Obtenir l’état du message électronique

Obtient l’état d’un message électronique envoyé précédemment.

Obtenir l’état du message électronique (préversion) - DÉCONSEILLÉ [DÉCONSEILLÉ]

Cette action a été déconseillée. Utilisez plutôt l’état Obtenir l’état du message électronique .

Obtient l’état d’un message électronique envoyé précédemment - DÉCONSEILLÉ

Envoyer un e-mail

Envoie un e-mail à un ou plusieurs destinataires.

Paramètres

Nom Clé Obligatoire Type Description
De
senderAddress True string

Adresse e-mail de l’expéditeur à partir d’un domaine vérifié.11

Importance
importance string
E-mail (À)
address True string

Adresse e-mail du destinataire principal.

E-mail (CC)
address True string

Adresse e-mail d’un destinataire supplémentaire.

E-mail (CCI)
address True string

Adresse e-mail d’un destinataire supplémentaire invisible dans la chaîne de messagerie.

Sujet
subject True string

Spécifiez l’objet de l’e-mail.

Corps
html html

Spécifiez le corps de l’e-mail.

E-mail (répondre à)
address True string

Adresse e-mail à laquelle les réponses des destinataires seront envoyées.

Nom
name True string

Nom de pièce jointe avec extension.

Type
contentType True string

Type de fichier de pièce jointe.

Content
contentInBase64 True byte

Contenu de pièce jointe.

nom
name True string

Entrez la clé.

value
value True string

Entrez la valeur.

Désactiver le suivi de l’engagement utilisateur
userEngagementTrackingDisabled boolean

Indique si le suivi de l’engagement utilisateur doit être désactivé pour cette demande si le paramètre de suivi de l’engagement utilisateur au niveau de la ressource a déjà été activé dans le plan de contrôle.

Retours

État de l’opération de longue durée

Envoyer un e-mail (préversion) - DÉCONSEILLÉ [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Envoyer un e-mail .

Envoie un e-mail à un ou plusieurs destinataires - DÉCONSEILLÉ

Paramètres

Nom Clé Obligatoire Type Description
De
sender True string

Adresse e-mail de l’expéditeur à partir d’un domaine vérifié.

E-mail (À)
email True string

Adresse e-mail du destinataire principal.

E-mail (CC)
email True string

Adresse e-mail d’un destinataire supplémentaire.

E-mail (CCI)
email True string

Adresse e-mail d’un destinataire supplémentaire invisible dans la chaîne de messagerie.

Sujet
subject True string

Spécifiez l’objet de l’e-mail.

Corps
html html

Spécifiez le corps de l’e-mail.

E-mail (répondre à)
email True string

Adresse e-mail à laquelle les réponses des destinataires seront envoyées.

Nom
name True string

Nom de pièce jointe avec extension.

Content
contentBytesBase64 True byte

Contenu de pièce jointe.

Importance
importance string

Type d’importance pour l’e-mail.

Désactiver le suivi de l’engagement utilisateur
disableUserEngagementTracking boolean

Indique si le suivi de l’engagement utilisateur doit être désactivé pour cette demande si le paramètre de suivi de l’engagement utilisateur au niveau de la ressource a déjà été activé dans le plan de contrôle.

Obtenir l’état du message électronique

Obtient l’état d’un message électronique envoyé précédemment.

Paramètres

Nom Clé Obligatoire Type Description
ID d’opération
operationId True string

ID d’opération d’un appel précédent pour envoyer un e-mail.

Retours

État de l’opération de longue durée

Obtenir l’état du message électronique (préversion) - DÉCONSEILLÉ [DÉCONSEILLÉ]

Cette action a été déconseillée. Utilisez plutôt l’état Obtenir l’état du message électronique .

Obtient l’état d’un message électronique envoyé précédemment - DÉCONSEILLÉ

Paramètres

Nom Clé Obligatoire Type Description
Message ID
messageId True string

ID de message d’un appel précédent pour envoyer un e-mail.

Retours

Nom Chemin d’accès Type Description
Message ID
messageId string
État du message
status string

Définitions

Détail de l'erreur

Détail de l’erreur.

Nom Chemin d’accès Type Description
code
code string

Code d’erreur.

Message
message string

Message d’erreur.

target
target string

Cible d’erreur.

details
details array of ErrorDetail

Détails de l’erreur.

informations supplémentaires
additionalInfo array of ErrorAdditionalInfo

Informations supplémentaires sur l’erreur.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Chemin d’accès Type Description
type
type string

Type d’informations supplémentaire.

info
info object

Informations supplémentaires.

EmailSendResult

État de l’opération de longue durée

Nom Chemin d’accès Type Description
pièce d'identité
id string

L’identifiant unique de l’opération. Utilisez un UUID.

status
status string

État de l’opération.

erreur
error ErrorDetail

Détail de l’erreur.