Como enviar mensagens do Microsoft Teams com Python

Nos dois casos, você deve terminar com um workbook no DataLab com sua lógica de negócio toda implementada:

3. Enviando uma mensagem para o Teams

Então, webhook do Teams: ok. Lógica de negócio: ok. Para integrar o notebook Python ao Microsoft Teams, precisamos fazer duas coisas: armazenar a URL do webhook no workbook do DataLab e escrever um código Python para enviar uma mensagem ao canal do Teams.

Armazene a URL do webhook

Nosso notebook Python precisa da URL do webhook para enviar a mensagem ao canal correto no Teams. Você poderia simplesmente copiar e colar essa URL em uma célula de código do notebook. Porém, isso não é seguro e não é recomendado. A URL do webhook é um tipo de segredo. Se você compartilhar seu notebook com outra pessoa, ela poderá ver a URL do webhook e spammer seu canal do Teams!

Além disso, esse método exigiria repetir o copia e cola em todo workbook no qual você quiser enviar mensagens ao Teams. Se você precisar atualizar a URL do webhook por algum motivo, terá que editar cada workbook.

Uma abordagem mais segura e escalável é armazenar o token da URL do webhook em uma variável de ambiente. Ao conectar essa variável, ela ficará disponível na sua sessão Python. No seu workbook:

• Clique na guia "Environment" no menu à esquerda
• Clique no ícone de mais ao lado de "Environment Variables"
• No modal "Add Environment Variables":
• Defina "Name" como MS_TEAMS_WEBHOOK_URL
• No campo "Value", cole a URL do Webhook que você salvou anteriormente.
• Defina "Environment Variables Set Name" como "Microsoft Teams" (pode ser qualquer nome)

Depois de preencher tudo, clique em "Create", "Next" e, por fim, "Connect". Sua sessão do workbook será reiniciada e MS_TEAMS_WEBHOOK_URL ficará disponível como variável de ambiente no seu notebook. Você pode verificar criando uma célula Python com o código abaixo e executando:

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

Se quiser reutilizar as mesmas credenciais de conta de serviço em outro workbook, não precisa configurar a variável de ambiente novamente: você pode reutilizá-la em outros workbooks.

Código Python para enviar a mensagem no Microsoft Teams

Com a MS_TEAMS_WEBHOOK_URL a postos, podemos escrever o código Python para enviar uma mensagem ao Teams! Para isso, usaremos o pacote open source pymsteams, que oferece um wrapper prático para a API — relativamente complexa — de envio de mensagens ao Teams. Vamos instalá-lo e importá-lo, junto com o pacote os para ler variáveis de ambiente:

!pip install pymsteams
import pymsteams
import os

Em seguida, podemos criar um "connector card" — basicamente, uma mensagem rica no Teams —, adicionar um texto e enviar:

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

Execute esse código! Você deve ver a mensagem aparecer no canal:

Demais! Essa foi uma mensagem de exemplo sem significado, mas você também pode criar uma mensagem baseada no resultado da sua lógica de negócio, como fizemos no workbook de exemplo:

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

Com o seguinte resultado:

Por fim, você também pode usar a variável de ambiente DL_WORKBOOK_ID para incluir um botão que leva ao seu workbook, caso queira facilitar o caminho do Teams para o DataLab que gerou a mensagem:

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

Com o seguinte resultado:

Bem legal, né?

4. Automatize!

Você criou um script em Python que faz uma análise útil e envia um resumo dessa análise para o Teams, incluindo um link para o notebook completo para quem quiser mais detalhes. Sensacional! Agora, imagine agendar esse notebook para rodar automaticamente, todo dia ou toda semana, mantendo você sempre atualizado com resultados fresquinhos. A boa notícia é que dá para fazer isso! O DataLab oferece o recurso de execuções agendadas para viabilizar essa rotina.

• No menu superior, clique em Run > Schedule Run
• Configure o agendamento como preferir:
• Programe o notebook para rodar automaticamente diariamente ou semanalmente. Para agendas semanais, escolha o dia e horário exatos.
• Adicione usuários do DataCamp que você quer notificar sempre que o notebook terminar (com sucesso ou com falha). É útil notificar em caso de falhas para você entrar e corrigir quando algo acontecer.

Se configurado como na captura acima, o notebook vai rodar todos os dias às 9h30 no horário local, o que significa que uma mensagem será postada no canal do Teams especificado todas as manhãs.

Automatizar ou não automatizar

Nem toda tarefa é um bom candidato à automação. Depende da frequência com que você a executa, de quanto tempo leva manualmente e de quanto tempo seria necessário para criar um script em Python que a automatize. Por exemplo, considere um relatório anual que leva 20 minutos para compilar à mão. Se você gastar meio dia escrevendo um script para isso, vão levar muitos anos para compensar o tempo investido na automação!

Aqui vai um resumo em formato de tabela:

Fonte: XKCD

Então, se uma tarefa diária levava 5 minutos antes, você pode gastar até 6 dias tentando automatizá-la. Se gastar menos do que isso, você ganhou tempo (contabilizado ao longo de cinco anos).

Conclusão

Configurar o DataLab para enviar mensagens ao Microsoft Teams envolve navegar por algumas telas no início. Mas, depois de tudo ajustado com a URL do webhook no DataLab, enviar uma mensagem se resume a adicionar algumas linhas de código Python — é bem simples! O melhor? Você pode automatizar praticamente qualquer script em Python e notificar seus stakeholders diretamente onde eles estão: no Teams.

Chega de criar lembretes para tarefas repetitivas e tediosas. Bem-vindo a uma era de fluxos de trabalho eficientes e automatizados, sem precisar trocar de ferramenta o tempo todo. Tudo o que você precisa é adotar o DataLab.

Lembre-se: se você precisa relembrar como escrever código em Python, nosso curso de Introdução ao Python é o ponto de partida ideal.