Notify

Notification can be leveraged to communicate certain events to user groups or a single person. This can be done either via Email or social Applications like WhatsApp, Telegram, or Slack.

Telegram

Creating a Telegram Bot

To send messages, you first need a Telegram Bot:

1. Open Telegram and search for @BotFather.

2. Start a chat and send /newbot.

3. Follow the instructions to give your bot a name and username.

4. BotFather will provide a Bot Token — keep this secret. You will use it to authenticate API requests.

For more detailed information, see the official Telegram Bot API documentation.

Obtain Chat ID

You have to start a chat with your newly created bot. Once done, there will be a new chat ID associated with your bot. You can extract this code by calling the following endpoint:

https://api.telegram.org/bot{TELEGRAM_TOKEN}/getUpdates

Notification Implementation

Once the bot token and the chat ID are obtained, the api can be pinged to send a message inside that chat.

import polars as pl
import requests
import os

TELEGRAM_TOKEN = os.environ["TELEGRAM_BOT_TOKEN"]
TELEGRAM_CHAT_ID = "191699299"

def send_telegram_message(message, chat_id):
    url = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}/sendMessage?parse_mode=HTML&chat_id={chat_id}&text={message}"
    response = requests.get(url).json()
    print(response)
    return response


def transform():
    text = """
    ⚠️ <b>New Alert!</b>
    """
    response = send_telegram_message(text, TELEGRAM_CHAT_ID)    
    return pl.LazyFrame(response)