Envio via Telegram

[Ramalho7]

✅ Implementar Função para Envio de Mensagens via Telegram

📌 Objetivo

Desenvolver uma função responsável por enviar mensagens automáticas via Telegram para todos os usuários cadastrados que optaram por receber notificações por esse canal.

🧩 Descrição

• A função deve percorrer os usuários registrados no banco de dados.
• Enviar mensagem via Telegram apenas para os que tiverem o ID de chat armazenado e preferência ativa para esse tipo de notificação.
• A mensagem pode ser de alerta diário (ex: previsão de chuva), status do sistema ou outro conteúdo configurável.

🔒 Requisitos Técnicos

• Utilizar a API oficial do Telegram Bot (https://api.telegram.org/bot<TOKEN>/sendMessage).
• A função deve:
  • Estar desacoplada do restante da aplicação (utilizável como utilitário).
  • Ser testável (com mocking de chamadas HTTP).
• Usar token do bot armazenado em variável de ambiente (TELEGRAM_BOT_TOKEN).
• Usar chat_id salvo na tabela de usuários.

✅ Critérios de Aceite

• Função envia mensagem corretamente via Telegram para usuários com chat_id válido.
• Apenas usuários com preferência ativa para Telegram recebem a notificação.
• Tratamento de erros para falha de envio ou chat_id inválido.
• Mensagens devem ser customizáveis por parâmetro da função.
• Adicionar testes automatizados com pytest simulando a chamada à API do Telegram.

✨ Exemplo de assinatura esperada

def send_telegram_message(message: str) -> None:
    ...