telegramtk 0.1.0

Telegram toolkit

telegramtk

Telegram toolkit

This package provides easy (and sync) access for the Telegram Bot API.

Installation

pip install telegramtk

Setup

First of all you must create a Telegram bot and grab the bot token.

import telegramtk

telegramtk.init('<your-telegram-bot-token-here>')

Send message

import telegramtk

telegramtk.send_message(to, msg)

Notes:

• to is the recipient and must be a chat id (integer value) or a known name (string value).
• msg is the message (string value) and can be "Markdown" formatted.

Error handling

If an error ocurred during the request to the Telegram API, an exception is raised. You can find this exception at:

import telegramtk
from telegramtk.exceptions import TelegramError

try:
    telegramtk.send_message(to, msg)
except TelegramError as err:
    handle_error(err)

Escape markdown

It's common to send Markdown content through Telegram, but sometimes we want to escape Markdown symbols in order to avoid syntax errors when parsing.

For that end, you might use the following function:

from telegramtk.utils import escape_markdown

>>> escape_markdown('Just some *Markdown* _stuff_ [here](https://example.com/)')
'Just some \\*Markdown\\* \\_stuff\\_ \\[here\\]\\(https://example\\.com/\\)'

💡 Source: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/helpers.py#L45