Enregistrez votre service à l’aide du tableau de bord du développeur de courrier actionnable.

  • Article

Importante

L’intégration de nouveaux fournisseurs de messages actionnables avec une étendue globale est temporairement suspendue jusqu’au 30 juin 2024 en raison de mises à niveau du service. Les fournisseurs globaux existants et l’intégration des fournisseurs d’étendue d’organisation et de test ne sont pas affectés. Pour plus d’informations, consultez Forum aux questions sur les messages actionnables.

Pour tester et publier des messages intégrant des actions dans votre service, vous devez fournir certaines informations à Microsoft afin d’activer cette fonctionnalité pour les courriers électroniques à partir de votre service. Le tableau de bord du développeur vous permet d’envoyer votre soumission et de suivre son état via le portail web.

Remarque

Vous pouvez facilement essayer des messages actionnables par e-mail en vous envoyant un e-mail avec le balisage requis sans aucune intervention de Microsoft. Il s’agit généralement de la première étape que vous testez lorsque vous découvrez cette fonctionnalité. Consultez ces exemples pour envoyer un message actionnable à votre boîte aux lettres, ou utilisez le Designer Message actionnable pour vous envoyer un message actionnable.

Si vous êtes un développeur et si vous utilisez des messages actionnables par e-mail, vous utiliserez le portail pour les cas suivants :

  • Tester des messages intégrant des actions à partir de votre service dans votre propre boîte aux lettres
  • Publier un message intégrant des actions à partir de votre service afin que tous les utilisateurs de messagerie au sein de votre organisation utilisant Office 365 puissent recevoir ces messages spécialement mis en forme (fonctionnalité généralement utilisée pour l’activation de messages intégrant des actions à partir d’un service propre à votre organisation, comme une application de cœur de métier)
  • Publier des messages intégrant des actions à partir de votre service afin que tous les utilisateurs de messagerie dans Office 365 utilisant votre service puissent recevoir ces messages spécialement mis en forme

Pour tous les cas précédents, vous allez envoyer des détails à Microsoft qui seront révisés et approuvés, puis vous activeront les messages intégrant des actions pour votre service.

Sections du tableau de bord

Le tableau de bord du développeur se compose de quelques sections logiques, que vous devez remplir selon l’étendue que vous souhaitez demander à Microsoft, afin d’activer des messages actionnables à partir de votre service.

Détails de votre fournisseur

Dans cette section, vous devez fournir des informations essentielles qui permettront à Office 365 d’accepter les courriers électroniques ayant une marque dans votre service, ainsi que les URL pouvant être appelées via les boutons d’action dans les courriers électroniques.

Les champs essentiels sont les suivants :

  • Adresse e-mail de l’expéditeur : il s’agit d’une ou de plusieurs adresses e-mail statiques correspondant au service qui enverra des e-mails avec un balisage d’action. Exemple : myservice@contoso.com.

  • URL cibles : il s’agit d’un ou plusieurs domaines correspondant aux URL qui traiteront les actions. Votre URL cible peut correspondre au domaine de niveau supérieur ou au sous-domaine du TLD. Il doit s’agir d’URL activées https. Exemple. https://api.myservice.com.

  • Clé publique : si vous envisagez d’envoyer des messages actionnables sous forme de Carte signée, vous devez indiquer la clé publique correspondant à la clé privée que vous utiliserez pour signer cette carte. Le format du champ est un élément RSAKeyValue.

    <RSAKeyValue>
  <Modulus>xA7SEU+e0yQ...</Modulus>
  <Exponent>AQAB</Exponent>
</RSAKeyValue>

Une paire de clés RSA peut être générée et exportée dans le format approprié à l’aide de PowerShell (7.3 ou version ultérieure) :

# Generate a key pair:
$rsa = [System.Security.Cryptography.RSA]::Create();

# Private Key, ensure this is saved securely and kept secret:
$rsa.ToXmlString($true)

## Public Key, copy output to dashboard:
$rsa.ToXmlString($false)

Pour obtenir un exemple d’obtention de code XML de clé publique à partir d’un fichier .cert, consultez La classe PublicKey.

Remarque

Une fois votre soumission approuvée, l’application peut prendre un certain temps. Si vous rencontrez l’erreur ci-dessous lors de l’envoi de cartes signées et que vous êtes sûr que votre charge utile est correcte, réessayez après quelques heures.

Adaptive card signature validation failed - Failed to validate signature

Étendue de votre envoi

Dans cette section, vous devez spécifier l’étendue pour laquelle activer le message intégrant des actions pour votre service. Les étendues applicables sont les suivantes :

  • Tester les utilisateurs : cette option active les e-mails actionnables de votre service envoyés à certains utilisateurs de la messagerie électronique O365 dans votre organisation. Cette étendue est généralement utilisée pour tester l’intégration des messages actionnables avec quelques utilisateurs test que vous avez spécifiés.
  • Organization : cette option active le message intégrant des actions dans votre service pour tous les utilisateurs de messagerie Microsoft 365 dans votre organisation. Cette étendue est généralement utilisée pour l’activation des messages intégrant des actions dans un service propre à votre organisation, comme une application de cœur de métier interne à votre organisation.
  • Global : cette option active le message intégrant des actions dans votre service pour tous les utilisateurs de messagerie dans Office 365.

Tous les éléments ci-dessus sont des étapes indépendantes. Par exemple, vous pouvez sélectionner une seule étendue pour chaque envoi et elle sera soumise au processus d’approbation par Microsoft.

Remarque

N’oubliez pas que vous pouvez facilement essayer des messages actionnables en vous envoyant un e-mail avec le balisage requis sans aucune intervention de Microsoft. Vous pouvez utiliser le message actionnable Designer pour vous envoyer sans écrire de code. Il s’agit généralement de la première étape du test des messages intégrant des actions.

Inscription en libre-service

Les inscriptions en libre-service sont disponibles pour les inscriptions qui utilisent les étendues suivantes.

  • Utilisateurs de test : la demande d’inscription est approuvée automatiquement pour vos utilisateurs de test que vous spécifiez. Cela active les e-mails actionnables dans votre service envoyés aux utilisateurs de test.
  • Mon organisation : cette demande d’inscription est envoyée aux administrateurs de votre organisation avec les autorisations Administrateur Exchange. Tout administrateur disposant de ces autorisations reçoit un e-mail avec les détails de l’envoi et est en mesure d’examiner, puis d’approuver votre demande. Si aucun utilisateur n’a le rôle Administrateur Exchange attribué, les utilisateurs ayant le rôle Administrateur général recevront cet e-mail à leur place.

Une fois la soumission approuvée, qu’elle soit approuvée automatiquement ou par votre administrateur, l’inscription prend jusqu’à 24 heures.

Pour les inscriptions Mon organisation, les comptes administrateur reçoivent un e-mail et l’utilisateur procédant à l’envoi est également en copie de ces messages. Cela vous permet de contacter votre administrateur si vous avez besoin de clarifications ou d’informations supplémentaires. Une fois la demande approuvée, l’utilisateur procédant à l’envoi et les administrateurs seront avertis avec un autre e-mail.

Après 24 heures, vous pouvez vérifier si l’inscription a pris effet en envoyant un message actionnable à partir de votre service à votre boîte aux lettres ou aux utilisateurs de test spécifiés (pour l’étendue Utilisateurs de test), ou toute boîte aux lettres utilisateur dans votre organization (pour l’étendue Organisation). Si 24 heures se sont écoulées et que l’inscription n’est toujours pas en vigueur, contactez-nous en utilisant le lien de commentaires en haut du tableau de bord d’inscription intitulé Inscription ne fonctionne pas ?.

Tester les adresses de messagerie des utilisateurs

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Utilisateurs de test.

Dans cette section, listez les utilisateurs de la messagerie Microsoft 365 dans votre organisation, séparés par un point-virgule (;). Cela vous aide à tester l’intégration de vos messages actionnables sur quelques utilisateurs, avant de créer un envoi avec une étendue de type Organisation ou Global.

Coordonnées

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Global.

Dans cette section, vous devez fournir des coordonnées afin que nous puissions vous contacter si nous avons d’autres questions concernant votre envoi. Toutes les informations fournies doivent être valides et précises.

Informations sur l’éditeur

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Global.

Dans cette section, vous devez fournir des détails sur le service qui enverra les messages intégrant des actions et des informations d’assistance connexes, afin que nous puissions vous contacter ou orienter les clients vers votre site d’assistance. Ces informations seront également utilisées dans le cadre du processus d’approbation par Microsoft pour votre fournisseur.

Détails du scénario

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Global.

Dans cette section, vous devez fournir des détails sur le scénario pour lequel les utilisateurs auront recours à des messages intégrant des actions à partir de votre service et d’autres détails appropriés. L’objectif est d’aider Microsoft à déterminer la validité et l’utilité de la solution fournie par votre service.

Détails de vérification

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Global.

Dans cette section, vous devez fournir des détails permettant à Microsoft de vérifier le message intégrant des actions et les actions correspondantes appelées à partir du courrier électronique envoyé par votre service/fournisseur.

En outre, envoyez un e-mail valide provenant de vos serveurs de production (ou d’un serveur avec des en-têtes DKIM/SPF/From :/Return-Path : similaires), y compris le balisage à onboardoam@microsoft.com. Cette procédure permet à Microsoft de déterminer que la solution est conforme à toutes les instructions et exigences répertoriées dans critères d’inscription.

  • Assurez-vous que la marque est correcte avant d’envoyer le message électronique.
  • Office 365 supprime toutes les marques lors du transfert d’un courrier électronique. Ne transférez pas le message électronique, mais envoyez-le directement.

Critères d’inscription

Il existe certaines informations que vous devez garder à l’esprit lorsque vous soumettez votre solution pour approbation avec l’étendue Global, car cela peut avoir impact important sur les utilisateurs dans Office 365.

Instructions concernant la qualité de l’expéditeur de courriers électroniques

  • Les courriers électroniques doivent être authentifiés via DKIM ou SPF.
  • Le domaine de premier niveau du contrôle SPF ou de signature DKIM doit correspondre au domaine de premier niveau de votre adresse de messagerie From:. Par exemple, si vous utilisez From: myservice@contoso.com la signature DKIM ou le contrôle SPF doit être pour contoso.com ou -.contoso.com.
  • Les courriers électroniques doivent provenir d’une adresse de messagerie statique, par exemple, myservice@contoso.com.
  • Les courriers électroniques doivent suivre les instructions de l’expéditeur de courriers électroniques.
  • Historique cohérent d’envoi de volume important de courriers électroniques à partir de votre domaine (une centaine de courriers électroniques par jour au moins pour Office 365) pendant quelques semaines au minimum.
  • Un très faible taux de plaintes concernant les courriers indésirables de la part des utilisateurs.
  • Les actions simples, de haute fidélité et de routine disponibles pour votre service doivent être utilisées. Pour des interactions plus complexes, les actions OpenURI peuvent être utilisées.
  • Les actions doivent être utilisées pour les courriers électroniques transactionnels où un taux d’interaction élevé est attendu. Elles ne doivent pas être utilisées pour des courriers en nombre promotionnels.

Instructions concernant les actions

  • Le nom du bouton doit indiquer une action claire à exécuter.
  • L’action Action.OpenUrl doit fournir un lien ciblé dans la page spécifique associée à l’entité/aux informations présentées dans le message intégrant des actions.
  • Un taux d’échec faible et une réponse rapide pour les services qui traitent les demandes d’action.
  • Reportez-vous à Conception de cartes de message actionnables d’Outlook au format de carte adaptative pour obtenir des instructions supplémentaires sur la conception de messages actionnables.

Approbation de votre envoi

Nous vous avertirons sur l’adresse de messagerie fournie pendant votre soumission. Vérifiez donc que les coordonnées fournies sont correctes.