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

Les intégrations qui n’ont pas été mises à jour pour utiliser Microsoft Entra ID jetons ne fonctionnent plus. Les partenaires doivent utiliser l’authentification par jeton basée sur Entra ID pour toutes les intégrations de messages actionnables. Pour plus d’informations, consultez Activer Microsoft Entra ID jeton pour les messages actionnables.

Pour tester et publier des messages actionnables à partir de votre service, fournissez certaines informations à Microsoft pour activer cette fonctionnalité pour les e-mails de votre service. Le tableau de bord du développeur vous permet d’envoyer et de suivre les status de votre soumission via le portail web.

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

• Pour tester les messages actionnables de votre service vers votre propre boîte aux lettres
• Pour publier des messages actionnables à partir de votre service afin que tout utilisateur de messagerie au sein de votre organization à l’aide de Microsoft 365 puisse recevoir ces messages spécialement mis en forme. Cette option active généralement les messages actionnables à partir d’un service spécifique à votre organization, comme une application métier.
• Pour publier des messages actionnables à partir de votre service afin que tous les utilisateurs de courrier dans Microsoft 365 qui utilisent votre service puissent recevoir ces messages spécialement mis en forme

Pour tous ces cas, envoyez les détails à Microsoft. Après examen et approbation, Microsoft active les messages actionnables pour votre service.

Sections du tableau de bord

Le tableau de bord du développeur est divisé en quelques sections logiques que vous devez remplir en fonction de l’étendue que vous souhaitez demander à Microsoft d’activer les messages actionnables de votre service.

Détails de votre fournisseur

Dans cette section, fournissez les détails clés qui permettent à Microsoft 365 d’accepter les e-mails avec le balisage de votre service, ainsi que les URL que les boutons d’action de ces e-mails peuvent appeler.

Les champs essentiels sont les suivants :

• Adresse e-mail de l’expéditeur : entrez une ou plusieurs adresses e-mail statiques qui correspondent au service qui envoie des e-mails avec un balisage d’action. Par exemple : myservice@contoso.com.

• URL cibles : entrez un ou plusieurs domaines qui correspondent aux URL qui traitent 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 compatibles HTTPS. Par exemple : https://api.myservice.com.

• Clé publique : si vous envisagez d’envoyer des messages actionnables en tant que carte signée, spécifiez la clé publique qui correspond à la clé privée que vous utilisez pour signer le carte. Le format du champ est un élément RSAKeyValue.

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

Vous pouvez générer et exporter une paire de clés RSA au 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.

Adaptive card signature validation failed - Failed to validate signature

Étendue de votre envoi

Spécifiez l’étendue dans laquelle vous souhaitez activer le message actionnable pour votre service. Les étendues applicables sont les suivantes :

• Utilisateurs de test : cette étendue permet d’envoyer des e-mails actionnables de votre service à certains des utilisateurs de messagerie Microsoft 365 dans votre organization. Utilisez cette étendue pour tester l’intégration des messages actionnables avec quelques utilisateurs de test que vous spécifiez.
• Organisation : cette étendue permet d’envoyer des messages actionnables de votre service à n’importe quel utilisateur de messagerie Microsoft 365 au sein de votre organization. Utilisez cette étendue pour activer les messages actionnables à partir d’un service spécifique à votre organization, comme une application métier.
• Global : cette étendue active les messages actionnables de votre service pour tout utilisateur de messagerie dans Microsoft 365.

Chaque étendue est indépendante. Vous ne pouvez envoyer qu’une seule étendue par demande et devez obtenir l’approbation de Microsoft.

Inscription en libre-service

L’inscription en libre-service est disponible pour les étendues suivantes.

• Utilisateurs de test : la demande d’inscription approuve automatiquement les utilisateurs de test que vous spécifiez. Cette inscription active les e-mails actionnables de votre service envoyés aux utilisateurs de test.
• Organisation : cette demande d’inscription achemine vers exchange ou Administrateur général de votre organization à des fins de révision et d’approbation.

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

Après 24 heures, vérifiez que l’inscription est active 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 à tout utilisateur de votre organization (pour l’étendue Organisation). Si 24 heures se sont écoulées et que l’inscription n’est toujours pas active, 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.

Fournissez la liste des utilisateurs de messagerie Microsoft 365 dans votre organization, séparés par un point-virgule (;). Cette liste vous permet de tester l’intégration de vos messages actionnables avec quelques utilisateurs avant de créer une soumission d’organisation ou d’étendue globale .

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 dans lequel les utilisateurs utilisent des messages actionnables de votre service. Cela permet à Microsoft de déterminer la validité et l’utilité de votre solution.

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.
• Microsoft 365 supprime tout le balisage lors du transfert d’un e-mail. Ne transférez pas le message électronique, mais envoyez-le directement.

Critères d’inscription

Gardez ces critères à l’esprit lorsque vous soumettez votre solution pour approbation pour l’étendue globale , car cela peut avoir un impact important sur les utilisateurs dans Microsoft 365.

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

• Authentifiez les e-mails 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 courrier 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.
• Envoyez des e-mails à partir d’une adresse e-mail statique, telle que myservice@contoso.com.
• Suivez les instructions de l’expéditeur de l’e-mail.
  • Pour Microsoft 365, consultez Services Microsoft 365 pour les expéditeurs de courriers électroniques externes.
  • Pour Outlook.com, consultez Stratégies, pratiques et instructions.
  • Pour obtenir des instructions du secteur, consultez Meilleures pratiques de l’expéditeur M3AAWG et Meilleures pratiques d’envoi de ReturnPath.
• Conservez un historique cohérent de l’envoi d’un volume élevé de courriers à partir de votre domaine (une commande de centaines d’e-mails par jour minimum à Microsoft 365) pendant au moins quelques semaines.
• Maintenir un taux très faible de plaintes de courrier indésirable de la part des utilisateurs.
• Utilisez des actions de haute fidélité, de routine et simples pour votre service. Pour des interactions plus complexes, utilisez Action.OpenUrl des actions.
• Utilisez des actions pour le courrier transactionnel où un taux d’interaction élevé est attendu. Ne les utilisez pas sur le courrier en bloc promotionnel.

Instructions concernant les actions

• L’étiquette du bouton doit refléter clairement l’action à entreprendre.
• Action.OpenUrl l’action doit établir un lien profond vers la page spécifique associée à l’entité ou aux informations présentées dans le message actionnable.
• Maintenez un faible taux d’échec et une réponse rapide pour les services qui gèrent les demandes d’action.
• Pour obtenir des instructions supplémentaires sur la conception de messages actionnables, voir Conception de cartes de message actionnables Outlook au format de carte adaptative.

Approbation de votre envoi

Vous recevrez une notification à l’adresse e-mail que vous fournissez lors de votre soumission. Veillez donc à fournir les informations de contact appropriées.