Come inviare messaggi Microsoft Teams con Python

In entrambi i casi, dovresti ritrovarti con un workbook DataLab con tutta la tua business logic già codificata:

3. Invio di un messaggio a Teams

Quindi, webhook di Teams: fatto. Business logic: fatta. Per integrare il notebook Python con Microsoft Teams, dobbiamo fare due cose: archiviare l’URL del webhook nel workbook DataLab e scrivere un po’ di codice Python per inviare un messaggio al canale di Teams.

Archivia l’URL del webhook

Il nostro notebook Python ha bisogno dell’URL del webhook per inviare il messaggio al canale Teams corretto. Potresti semplicemente copiare e incollare questo URL in una cella di codice del notebook. Tuttavia, questo approccio non è sicuro e non è consigliato. L’URL del webhook è una sorta di segreto. Se condividi il tuo notebook con qualcun altro, quella persona può vedere l’URL del webhook e potrebbe fare spam nel tuo canale Teams!

Questo approccio ti costringerebbe anche a ripetere il copia-incolla in ogni workbook con cui vuoi inviare messaggi a Teams. E se per qualche motivo vuoi aggiornare l’URL del webhook, dovrai modificare ogni singolo workbook.

Un approccio più sicuro e scalabile è archiviare il token dell’URL del webhook in una cosiddetta variabile d’ambiente. Quando colleghi questa variabile d’ambiente, sarà disponibile nella tua sessione Python. Nel tuo workbook:

• Clicca sulla scheda “Environment” sul lato sinistro
• Clicca sull’icona più accanto a “Environment Variables”
• Nella finestra modale “Add Environment Variables”:
• Imposta “Name” su MS_TEAMS_WEBHOOK_URL
• Nel campo “Value”, incolla l’URL del webhook che hai salvato in precedenza.
• Imposta “Environment Variables Set Name” su “Microsoft Teams” (può essere qualsiasi cosa)

Dopo aver compilato tutti i campi, clicca su “Create”, “Next” e infine “Connect”. La sessione del tuo workbook verrà riavviata e MS_TEAMS_WEBHOOK_URL sarà ora disponibile come variabile d’ambiente nel tuo workbook. Puoi verificarlo creando una cella Python con il seguente codice ed eseguendola:

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

Se vuoi riutilizzare le stesse credenziali dell’account di servizio in un altro workbook, non devi riconfigurare la variabile d’ambiente: puoi riutilizzarla anche negli altri workbook.

Codice Python per inviare il messaggio su Microsoft Teams

Con MS_TEAMS_WEBHOOK_URL pronta all’uso, possiamo ora scrivere del codice Python per inviare un messaggio a Teams! Per farlo useremo il pacchetto open-source pymsteams, che offre un comodo wrapper per la piuttosto intricata API di invio messaggi a Teams. Installiamolo e importiamolo, insieme al pacchetto os per leggere le variabili d’ambiente:

!pip install pymsteams
import pymsteams
import os

Poi possiamo creare una cosiddetta ‘connector card’ – un modo elegante per dire un messaggio di testo arricchito in Teams –, aggiungere del testo e inviarla:

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

Esegui questo codice! Dovresti vedere apparire questo messaggio nel canale:

Fantastico! Questo era un messaggio di esempio senza significato, ma puoi anche creare un messaggio basato sul risultato della tua business logic, come abbiamo fatto nel workbook di esempio:

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()

Con il seguente risultato:

Infine, puoi anche sfruttare la variabile d’ambiente DL_WORKBOOK_ID per includere un pulsante che rimandi al tuo workbook, nel caso tu voglia offrire un modo semplice per passare da Teams al workbook di DataLab che genera questo messaggio:

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()

Con il seguente risultato:

Niente male, vero?!

4. Automatizza!

Hai creato uno script Python che esegue un’analisi utile e invia a Teams un riepilogo di questa analisi, includendo un link al notebook completo per chi vuole maggiori dettagli. Fantastico! Ora immagina di poter programmare l’esecuzione automatica di questo notebook, ogni giorno o ogni settimana, mantenendoti costantemente aggiornato con risultati freschi. La buona notizia è che puoi farlo! DataLab offre la funzionalità di esecuzioni pianificate per renderlo possibile.

• Nella barra del menu in alto, clicca Run > Schedule Run
• Configura la pianificazione come preferisci:
• Imposta il notebook perché venga eseguito automaticamente su base giornaliera o settimanale. Per le pianificazioni settimanali, scegli giorno e ora esatti.
• Aggiungi gli utenti DataCamp che vuoi informare ogni volta che il notebook termina (con successo o con errore). È utile farlo per i fallimenti, così puoi intervenire e correggere quando si verifica un problema.

Se configurato come nello screenshot qui sopra, il notebook verrà eseguito ogni giorno alle 9:30 ora locale, il che significa che ogni mattina verrà pubblicato un messaggio nel canale Teams specificato.

Automatizzare o non automatizzare

Non ogni attività è una buona candidata per l’automazione. Dipende da quanto spesso la svolgi, da quanto tempo richiede farla manualmente e dal tempo che servirebbe per scrivere uno script Python per automatizzarla. Per esempio, pensa a un report annuale che richiede 20 minuti per essere compilato a mano. Se ti serve mezza giornata per scrivere uno script per farlo, passeranno molti anni prima di recuperare il tempo speso per l’automazione!

Ecco un riepilogo in forma di tabella:

Fonte: XKCD

Quindi se un’attività che dovevi fare ogni giorno richiedeva 5 minuti, puoi permetterti di spendere fino a 6 giorni per provare ad automatizzarla. Se impieghi meno di così per automatizzarla, avrai guadagnato tempo (conteggiato su cinque anni).

Conclusione

Configurare DataLab per inviare messaggi a Microsoft Teams richiede inizialmente di passare attraverso più schermate. Ma una volta impostato tutto con l’URL del webhook in DataLab, inviare un messaggio significa solo aggiungere poche righe di codice Python – è davvero semplice! La parte migliore? Puoi automatizzare quasi qualsiasi script Python e notificare direttamente i tuoi stakeholder esattamente dove si trovano: su Teams.

Sono finiti i tempi dei promemoria per attività ripetitive e noiose. Benvenuta un’era di flussi di lavoro efficienti e automatizzati in cui non devi passare da uno strumento all’altro. Ti basta abbracciare DataLab.

Ricorda: se ti serve un ripasso sulla scrittura di codice Python, il nostro corso Introduzione a Python è il punto di partenza ideale.