Comment envoyer des messages sur Microsoft Teams avec Python

Dans les deux cas, vous devriez aboutir à un workbook DataLab avec votre logique métier entièrement codée :

3. Envoyer un message à Teams

Donc, webhook Teams : vérifié. Logique métier : vérifiée. Pour intégrer le bloc-notes Python avec Microsoft Teams, nous devons faire deux choses : stocker l’URL du webhook dans le workbook DataLab et écrire du code Python pour envoyer un message au canal Teams.

Stocker l’URL du webhook

Notre bloc-notes Python a besoin de l’URL du webhook pour envoyer le message au bon canal Teams. Vous pourriez simplement copier et coller cette URL dans une cellule de code de votre bloc-notes. Cependant, cela n’est pas une approche sécurisée et n’est pas recommandée. L’URL du webhook est plutôt confidentielle. Si vous partagez votre bloc-notes avec quelqu’un d’autre, ils peuvent voir l’URL du webhook, et ils peuvent spammer votre canal Teams !

Cette approche vous obligerait également à répéter cette copie-collage dans chaque workbook avec lequel vous souhaitez envoyer des messages à Teams. Si vous souhaitez mettre à jour l’URL du webhook pour une raison quelconque, vous devrez passer en revue et modifier chaque workbook.

Une approche plus sécurisée et scalable consiste à stocker le jeton d’URL du webhook dans ce qu’on appelle une variable d’environnement. Lorsque vous connectez cette variable d’environnement, elle deviendra disponible dans votre session Python. Dans votre workbook :

• Cliquez sur l’onglet « Environnement » sur le côté gauche
• Cliquez sur l’icône plus à côté de « Variables d’environnement »
• Dans la boîte de dialogue « Ajouter des variables d’environnement » :
• Définir « Nom » à MS_TEAMS_WEBHOOK_URL
• Dans le champ « Valeur », coller l’URL de webhook que vous avez sauvegardée plus tôt.
• Définir le « Nom de la variable d’environnement » à « Microsoft Teams » (ce qui peut être presque n’importe quoi, vraiment)

Après avoir rempli tous les champs, cliquer sur « Créer », « Suivant » et enfin « Connecter ». Votre session de tableur sera redémarrée, et MS_TEAMS_WEBHOOK_URL sera désormais disponible en tant que variable d’environnement dans votre tableur. Vous pouvez vérifier cela en créant une cellule Python avec le code suivant et en l’exécutant :

import os
webhook_url = os.environ["MS_TEAMS_WEBHOOK_URL"]
print(webhook_url)

Si vous souhaitez réutiliser les mêmes identifiants de compte de service dans un autre tableur, vous n’avez pas besoin de configurer à nouveau la variable d’environnement : vous pouvez réutiliser la variable d’environnement dans d’autres tableurs.

Code Python pour envoyer le message Microsoft Teams

Avec MS_TEAMS_WEBHOOK_URL en place, nous pouvons maintenant écrire un code Python pour envoyer un message aux Teams ! Pour cela, nous utilisons le paquet open-source pymsteams, qui offre un wrapage pratique pour l’intricate API de messages aux Teams. Installez-le et importez-le, ainsi que le package os pour lire les variables d’environnement :

!pip install pymsteams
import pymsteams
import os

Ensuite, nous pouvons créer ce que l’on appelle une \ »carte de connecteur\ » – un terme prisé pour un message de texte riche dans Teams \-, y ajouter du texte et l’envoyer :

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.text("Hello Teams!")
assert card.send()

Exécutez ce code ! Vous devrait voir ce message apparaître dans le canal :

Incroyable ! Voici un message样本 sans objet, mais vous pouvez également créer un message basé sur le résultat de votre logique métier, comme nous l’avons fait dans le livre de travail样本:

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.title("Weather Forecast")
card.text("\n".join([
    f"Weather for {CITY} in the next three days:",
    f"- Min temperature: {weather_df['temperature_2m'].min()} {unit_temperature}",
    f"- Max temperature: {weather_df['temperature_2m'].max()} {unit_temperature}", 
    f"- Total precipitation: {weather_df['precipitation'].sum():.2f} {unit_prec}"
]))
assert card.send()

Avec le résultat suivant :

Finalement, vous pouvez également utiliser la variable d’environnement DL_WORKBOOK_ID pour inclure un bouton qui relie votre livre de travail au cas où vous voudriez inclure une manière simple de passer de Teams au workbook DataLab qui anime ce message :

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.title("Weather Forecast")
card.text("\n".join([
    f"Weather for {CITY} in the next three days:",
    f"- Min temperature: {weather_df['temperature_2m'].min()} {unit_temperature}",
    f"- Max temperature: {weather_df['temperature_2m'].max()} {unit_temperature}", 
    f"- Total precipitation: {weather_df['precipitation'].sum():.2f} {unit_prec}"
]))
card.addLinkButton("View detailed forecast", f"https://www.datacamp.com/datalab/w/{os.environ.get('DL_WORKBOOK_ID', 'invalid')}/edit")
assert card.send()

Avec le résultat suivant :

Très bien, n’est-ce pas?!

4. Automatiser !

Vous avez écrit un script Python qui effectue une analyse utile et envoie un résumé de cette analyse sur Teams, incluant un lien vers le carnet complet pour ceux qui sont intéressés par plus de détails. Incroyable ! Maintenant, imaginez si vous pouviez configurer ce carnet pour s’exécuter automatiquement, quotidien ou hebdomadaire, vous maintenant constamment informé de nouveaux résultats. Heureusement, la bonne nouvelle est que vous pouvez ! DataLab offre la fonctionnalité de lancements planifiés pour rendre cela possible.

• Dans la barre de menu en haut, cliquez sur Exécuter > Planifier un lancement
• Configurez le planning comme vous le souhaitez :
• Configurez le carnet pour s’exécuter automatiquement quotidiennement ou hebdomadairement. Pour les horaires hebdomadaires, choisissez le jour et l’heure exacts.
• Ajoutez des utilisateurs DataCamp que vous voulez informer chaque fois que le notebook se termine (avec succès ou en échec). Cela est utile pour les échecs, afin que vous puissiez plonger et résoudre les problèmes lors de l’occurrence d’une issue.

Si configuré comme dans la capture d’écran ci-dessus, le notebook s’exécutera désormais à 9h30 heure locale tous les jours, ce qui signifie qu’un message sera publié dans le canal Teams spécifié tous les matins.

Automatiser ou ne pas automatiser

Toute tâche n’est pas une bonne candidate à l’automatisation. Cela dépend de la fréquence à laquelle vous l’effectuez, du temps que cela prend de le faire manuellement, et du temps qu’il faudrait pour créer un script Python pour l’automatiser. Par exemple, prenez un rapport annuel qui prend 20 minutes à compiler à la main. Si vous devez passer une demi-journée à écrire un script pour cela, il faudra plusieurs années avant que vous ne récupériez le temps investi dans l’automatisation !

Voici un résumé sous forme de tableau :

Donc, si une tâche que vous deviez faire quotidiennement prenait 5 minutes avant, vous pouvez consacrer jusqu’à 6 jours pour essayer d’automatiser cette tâche. Si vous dépensez moins de temps que cela pour l’automatiser, vous gagnerez du temps (compté sur cinq ans).

Conclusion

Le paramétrage de DataLab pour envoyer des messages à Microsoft Teams implique de naviguer à travers plusieurs écrans au départ. Mais une fois que vous avez tout configuré avec l’URL du webhook dans DataLab, envoyer un message est simplement une question d’ajouter quelques lignes de code Python – c’est vraiment simple ! La meilleure partie ? Vous pouvez automatiser presque n’importe quel script Python et notifier directement vos parties prenantes exactement où elles se trouvent : sur Teams.

Gone sont les jours de définir des rappels pour des tâches répétitives et triviales. Bienvenue dans une ère de flux de travail efficaces et automatisés où vous n’avez pas besoin de basculer entre outils. Il suffit de s’ouvrir à DataLab.

Souvenez-vous, si vous avez besoin de vous remettre en question sur l’écriture de code Python, notre cours Introduction à Python est l’endroit idéal pour commencer.