Inscription d’un connecteur à l’aide du tableau de bord du développeur de connecteurs

  • Article

Il est facile de créer un connecteur Office pour votre application. Il vous suffit d’inscrire votre connecteur dans notre portail des développeurs, d’ajouter une expérience de configuration intégrée à votre application et d’implémenter votre connecteur. Vous pouvez faciliter l’accès au connecteur pour les utilisateurs en le publiant dans notre catalogue.

Création de votre propre connecteur

Inscription de votre connecteur

Visitez le portail des développeurs du connecteur et connectez-vous avec vos informations d’identification Microsoft 365. Si vous n’avez pas de locataire Microsoft 365, vous pouvez être éligible pour un client via le Programme pour les développeurs Microsoft 365 ; Pour plus d’informations, consultez la FAQ. Vous pouvez également vous inscrire à un essai gratuit de 1 mois ou acheter un plan Microsoft 365.

Sélectionnez Nouveau connecteur et remplissez le formulaire. Quand vous sélectionnez Enregistrer, de nouvelles options apparaissent sur la page.

  • Le bouton Charger une version test vers Outlook vous permet d’ajouter temporairement votre connecteur à l’expérience Outlook de l’utilisateur connecté. Cet utilisateur pourra alors configurer le connecteur dans sa boîte de réception ou dans l’un des groupes dont il est membre.
  • Le bouton Publier dans le Store vous permet de démarrer le processus de publication, y compris la révision par Microsoft qui va déterminer si le connecteur peut figurer dans le Store.

Ajout d’une expérience de configuration intégrée

Une expérience de configuration intégrée permet à l’utilisateur de configurer votre connecteur sans quitter Outlook. Votre application expose la configuration comme une page web qui utilise la bibliothèque JavaScript de Microsoft Teams pour communiquer l’état de configuration à Outlook.

Pour en savoir plus, consultez la section relative à l’intégration de l’expérience de configuration.

Remarque

La section Intégration de l’expérience de configuration est spécifique à Microsoft Teams, mais les méthodes documentées fonctionnent de la même manière dans Outlook.

Configuration requise dans Outlook

Si votre expérience de configuration requiert une authentification, d’autres conditions doivent être remplies pour activer le flux d’authentification dans Outlook pour Windows.

Outlook pour Windows transmet un paramètre de requête supplémentaire à la page d’authentification des connecteurs.

callbackUrl=<connectors url>

Votre application doit conserver cette valeur et la transmettre comme un paramètre supplémentaire aux méthodes microsoftTeams.authentication.notifySuccess ou microsoftTeams.authentication.notifyFailure, une fois l’authentification terminée.

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

Publication du connecteur dans le Store

Une fois que vous avez soigneusement testé votre connecteur et qu’il est prêt à être répertorié dans le catalogue de connecteurs Office, vous pouvez utiliser le bouton Publier dans le Store pour l’envoyer pour révision. Après vérification et approbation, le connecteur est ajouté dans le catalogue de connecteurs.

Liste de vérification de l’envoi de connecteur

  • Assurez-vous que votre connecteur est entièrement fonctionnel et a été minutieusement testé avant de l’envoyer au Store.
  • Testez vos cartes de connecteur dans les différents clients dans lesquels les utilisateurs vont l’utiliser : Outlook sur le web, Outlook 2016 ou une version ultérieure et applications mobiles Outlook Groups.
  • Assurez-vous que vous utilisez uniquement Markdown pour l’ornement de texte et que vous n’envoyez pas de code HTML dans la charge utile de la carte de connecteur.
  • Maintenez l’équilibre entre l’ajout de valeur et la génération de trop de désagréments. Vérifiez que l’utilisateur n’est pas ralenti par trop de notifications.
  • Identifiez les événements adaptés pour lesquels envoyer des cartes de connecteur. Vérifiez que les informations envoyées au groupe sont intéressantes pour les membres du groupe.
  • Lorsque vous envoyez des rapports ou des résumés, utilisez un format digest et autoriser l’utilisateur à choisir l’heure et la fréquence des rapports.
  • Lors de l’envoi de cartes de connecteur, tirez profit de Markdown pour mettre en évidence les éléments importants de la carte.
  • Créez des cartes de connecteur intégrant des actions en fournissant des actions appropriées dès que possible.
  • Les actions appelées doivent avoir un taux d’échec vraiment bas et obtenir une réponse rapide de votre point de terminaison.
  • Assurez-vous que vous pouvez permettre à l’utilisateur de suspendre ou de supprimer la configuration.
  • Fournissez une documentation claire destinée aux utilisateurs concernant les fonctionnalités de votre connecteur.
  • Lorsque vous inscrivez votre connecteur procédez comme suit :
    • Vérifiez que le nom et le logo de votre connecteur ne porte pas atteinte à une marque ou à des droits d’auteur d’un autre produit ou service.
    • Fournissez un logo de qualité élevé de type jpg, jpeg, png ou gif dont la taille est inférieure à 60 Ko.
    • Fournissez une brève description de votre application (par exemple, « Le support technique Contoso réunit les sociétés et les clients. »).
    • Fournissez une description détaillée de votre lien (par exemple, « Le connecteur Support technique Contoso informe votre groupe Office 365 de l’activité sur les tickets de votre client »).
  • Lors de la publication du connecteur sur le Store :
    • Assurez-vous que vous suivez les instructions étape par étape et partagez les informations sur le compte de test pour que nous puissions tester le connecteur.

Étapes suivantes