Enregistrez votre service à l’aide du tableau de bord du développeur de courrier actionnable.Register your service with the actionable email developer dashboard

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.To test and publish actionable messages from your service, you need to provide certain information to Microsoft to enable this functionality for emails from your service. The developer dashboard helps you submit and track status of your submission via the web portal.

Notes

Vous pouvez facilement tester les messages appelant une action par courrier électronique en envoyant des courriers électroniques à vous-même avec la marque requise 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é. Consultezces exemples pour envoyer un message appelant une action à votre boîte aux lettres ou utilisez l’Aire de jeu de carte pour envoyer un message appelant une action à vous-même.You can easily try out actionable messages via email by sending email to yourself with the required markup without any intervention from Microsoft. This would typically be the first step you try out as you dip your toes into this capability. Check out these samples to send an actionable message to your mailbox, or use the Card Playground to send an actionable message to yourself.

Si vous êtes un développeur et si vous utilisez des messages actionnables par e-mail, vous utiliserez le portail pour les cas suivants :If you are a developer working with actionable messages via email, you will use the portal for the following cases:

  • Tester des messages intégrant des actions à partir de votre service dans votre propre boîte aux lettresTo test actionable messages from your service to your own mail box
  • 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)To publish actionable message from your service so any email user within your organization using Office 365 can receive these specially formatted message (this is typically used for enabling actionable messages from a service that is specific to your organization, like a line-of-business app)
  • 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 formeTo publish actionable messages from your service so any email user in Office 365 using your service can receive these specially formatted messages

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.For all the above cases, you will be submitting certain details to Microsoft, which after being reviewed and approved, will enable actionable messages for your service.

Sections du tableau de bordDashboard sections

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.The developer dashboard is divided into a few logical sections you need to fill out based on the scope you'd like to request Microsoft to enable actionable message from your service.

Détails de votre fournisseurDetails of your provider

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.In this section, you need to supply key details that will allow Office 365 to accept emails with markup from your service as well as URLs that can be invoked via the action buttons from those emails.

Les champs essentiels sont les suivants :The key fields are:

  • Adresse de messagerie de l’expéditeur : il s’agit d’une ou plusieurs adresses de messagerie statiques correspondant au service qui vous envoie des courriers électroniques contenant des marques d’action. Exemple : myservice@contoso.com.Sender email address: This is one or more static email addresses corresponding to the service that will send out emails with action markup. Example: myservice@contoso.com.

  • URL cibles : il s’agit d’un ou plusieurs domaines correspondant aux URL qui traitent les actions. L’URL cible peut correspondre au domaine de niveau supérieur ou au sous-domaine du domaine de premier niveau. Il doit s’agir d’URL activées HTTPS. Exemple. https://api.myservice.com.Target URLs: This is one or more domains corresponding to URLs that will process the actions. Your target URL can correspond to the top level domain or the sub-domain of the TLD. They need to be https enabled URLs. Example. 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.Public Key: If you plan to send actionable messages as Signed Card, then you need to specify the public key corresponding to the private key you will use for signing the card. Le format du champ est un élément RSAKeyValue.The format for this field is an RSAKeyValue element.

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

    Pour afficher un exemple sur l’obtention d’une clé publique XML à partir d’un fichier .cert, consulter PublicKey Class.For an example of how to get public key XML from a .cert file, see PublicKey Class.

Étendue de votre envoiScope of your submission

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 :In this section, you need to specify at what scope you want to enable actionable message for your service. The applicable scopes are:

  • 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.Test Users: This enables actionable emails from your service to some of the O365 email users in your organization. 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.This scope is generally used for testing actionable messages integration with few test users that you have specified.
  • Organization : cette option active le message intégrant des actions dans votre service pour tous les utilisateurs de messagerie Microsoft 365 dans votre organisation.Organization: This enables actionable message from your service to any Microsoft 365 email user within your organization. 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.This scope is typically used for enabling actionable messages from a service that is specific to your organization, like a line- of-business application internal to your organization.
  • Global : cette option active le message intégrant des actions dans votre service pour tous les utilisateurs de messagerie dans Office 365.Global: This enables actionable message from your service for any email user in 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.Each of the above are independent steps. i.e. you can pick only one scope for each submission and will be subject to the approval process by Microsoft.

Notes

N’oubliez pas, vous pouvez tester facilement les messages appelant une action en envoyant un courrier électronique à vous-même avec la marque requise sans aucune intervention de Microsoft. Vous pouvez utiliser l’Aire de jeu de carte pour envoyer un message à vous-même sans écrire de code. Il s’agit généralement de la première étape du test des messages appelant une action.Remember, you can easily try out actionable messages by sending an email to yourself with the required markup without any intervention from Microsoft. You can use the Card Playground to send to yourself without writing any code. This would typically be the first step to try out actionable messages.

Inscription en libre-serviceSelf-service registration

Les inscriptions en libre-service sont disponibles pour les inscriptions qui utilisent les étendues suivantes.Self-service of registrations is available for registrations that use the following scopes.

  • Utilisateurs de test : la demande d’inscription est approuvée automatiquement pour vos utilisateurs de test que vous spécifiez.Test Users: The registration request is auto-approved for your test users you specify. Cela active les e-mails actionnables dans votre service envoyés aux utilisateurs de test.This will enable actionable emails from your service sent to test users.
  • Mon organisation : cette demande d’inscription est envoyée aux administrateurs de votre organisation avec les autorisations Administrateur Exchange ou Administrateur général.Organization: This registration request will be sent to your organization's administrators with Exchange administrator or Global administrator permissions. Tout administrateur disposant de ces autorisations reçoit un e-mail avec les détails de l’envoi et est en mesure d’examiner et d’approuver votre demande.Any administrator with those permissions receive an email with submission details and will be able to review and approve your request.

Une fois que l’envoi est approuvé, automatiquement ou par votre administrateur, l’inscription prend effet sous une heure au maximum.Once the submission is approved, whether auto-approved or by your administrator, it will take up to an hour for the registration to take effect.

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.For My organization registrations, the administrator accounts will receive an email and the submitter will also be copied on those emails. Cela vous permet de contacter votre administrateur si vous avez besoin de clarifications ou d’informations supplémentaires.This will allow you to reach out to your administrator if you need to provide further clarifications or details. Une fois la demande approuvée, l’utilisateur procédant à l’envoi et les administrateurs seront avertis avec un autre e-mail.Once the request is approved, the submitter and the administrators will be notified with another email.

Au bout d’une heure, vous pouvez vérifier si l’inscription a pris effet en envoyant un message actionnable à partir de votre service vers votre boîte aux lettres ou des utilisateurs test précis (pour l’étendue Test utilisateurs) ou une boîte aux lettres utilisateur de votre organisation (pour l’étendue Organisation).After an hour has passed, you can verify if the registration has taken into effect by sending an actionable message from your service to your mailbox or specified test users (for Test Users scope), or any user mailbox in your organization (for Organization scope). Si une heure s’est écoulée et que l’inscription n’est toujours pas effective, contactez-nous via le lien de commentaires situé en haut du tableau de bord d’inscription intitulé L’inscription ne fonctionne pas.If an hour has passed and the registration is still not in effect, please contact us by using the feedback link at the top the registration dashboard labeled Registration not working?.

Tester les adresses de messagerie des utilisateursTest user email addresses

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Utilisateurs de test.This section is only applicable when your scope of submission to enable actionable messages is Test Users.

Dans cette section, listez les utilisateurs de la messagerie Microsoft 365 dans votre organisation, séparés par un point-virgule (;).In this section provide a list of Microsoft 365 email users in your organization, separated by a semi-colon (;). 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.This will help you to test your actionable messages integration on a few users, before creating an Organization or Global scope submission.

CoordonnéesContact info

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Global.This section is only applicable when your scope of submission to enable actionable messages is 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.In this section, you need to provide contact details, so we can reach out to you if we have further questions regarding your submission. All information provided must be valid and accurate.

Informations sur l’éditeurPublisher information

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Global.This section is only applicable when your scope of submission to enable actionable messages is 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.In this section, you need to provide details about your service that will be sending Actionable Messages and related support information, so we can reach out to you or direct customers to your support site. This information will also be used as part of the approval process by Microsoft for your provider.

Détails du scénarioScenario details

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Global.This section is only applicable when your scope of submission to enable actionable messages is 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.In this section, you need to provide details on the scenario for which users will consume actionable messages from your service and other relevant details. This is to help Microsoft determine that validity and usefulness of the solution provided by your service.

Détails de vérificationVerification details

Cette section s’applique uniquement lorsque l’étendue de votre envoi pour l’activation des messages intégrant des actions est Global.This section is only applicable when your scope of submission to enable actionable messages is 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.In this section, you need to provide details for Microsoft to verify the actionable message and the corresponding actions that are invoked from the email sent by your provider/service.

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 la marque à onboardoam@microsoft.com. Cette procédure permet à Microsoft de vérifier que la solution est conforme à toutes les instructions et exigences répertoriées dans les critères d’inscription.Additionally, send a valid email coming from your production servers (or a server with similar DKIM/SPF/From:/Return-Path: headers) including the markup to onboardoam@microsoft.com. This procedure will enable Microsoft to determine that the solution complies with all the guidelines and requirements listed in Registration Criteria.

  • Assurez-vous que la marque est correcte avant d’envoyer le message électronique.Make sure that the markup is correct prior to sending the email.
  • Office 365 supprime toutes les marques lors du transfert d’un courrier électronique. Ne transférez pas le message électronique, mais envoyez-le directement.Office 365 removes all markup when forwarding an email. Do not forward the email but send it directly.

Critères d’inscriptionRegistration criteria

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.There are some things you need to keep in mind when you submit your solution for approval for Global scope since it can have broad impact to users in Office 365.

Instructions concernant la qualité de l’expéditeur de courriers électroniquesEmail sender quality guidelines

  • Les courriers électroniques doivent être authentifiés via DKIM ou SPF.Emails must be authenticated via DKIM or 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.The top-level domain (TLD) of the SPF check or DKIM signature must match the TLD of your From: email address. For example, if you use From: myservice@contoso.com the DKIM or SPF must be for contoso.com or -.contoso.com.
  • Les courriers électroniques doivent provenir d’une adresse de messagerie statique, par exemple, myservice@contoso.com.Emails must come from a static email address, e.g. myservice@contoso.com.
  • Les courriers électroniques doivent suivre les instructions de l’expéditeur de courriers électroniques.Emails must follow the email sender guidelines.
  • 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.Consistent history of sending a high volume of mail from your domain (order of hundred emails a day minimum to Office 365) for a few weeks at least.
  • Un très faible taux de plaintes concernant les courriers indésirables de la part des utilisateurs.A very low rate of spam complaints from users.
  • 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.High-fidelity, routine and simple actions available for your service should be used. For more complex interactions, OpenURI actions can be used.
  • 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.Actions should be used for transactional mail where a high interaction rate is expected. They should not be used on promotional bulk mail.

Instructions concernant les actionsActions guidelines

  • Le nom du bouton doit indiquer une action claire à exécuter.Label of the button needs to reflect clear action to be taken.
  • 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.Action.OpenUrl action must deep link into the specific page associated with the entity/information presented in the actionable message.
  • Un taux d’échec faible et une réponse rapide pour les services qui traitent les demandes d’action.Low failure rate and fast response for services handling action requests.
  • 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.Please see Designing Outlook actionable message cards with the Adaptive Card format for additional guidelines on designing actionable messages.

Approbation de votre envoiApproval of your submission

Nous vous avertirons sur l’adresse de messagerie fournie pendant votre soumission. Vérifiez donc que les coordonnées fournies sont correctes.We will notify you on the email address you provided during your submission, so please ensure you provide the right contact information.