Skip to content

Latest commit

 

History

History
236 lines (159 loc) · 4.58 KB

slide.md

File metadata and controls

236 lines (159 loc) · 4.58 KB

name: How to create a Telegram Bot class: center, middle, inverse

TelegramLogo

How to create a Telegram Bot

Isfahan LUG, Aug. 2015

Alireza Omidi

Mahdi Fooladgar

github

Agenda

  1. What is a bot?
  2. The Botfather
  3. API
  4. Python Telegram Bot Project
  5. Write your own bot

What is a bot?

Bots are simply Telegram accounts operated by software – not people – and they'll often have AI features.

They can do anything – teach, play, search, broadcast, remind, connect, integrate with other services, or even pass commands to the Internet of Things.

-- Telegram blog

Differences with humans:

  1. No online status and no last seen timestamps. --

  2. Limited cloud storage. --

  3. Can't initiate conversations with users. Users must start conversation or add to groups. The link is telegram.me/<bot_username>. --

  4. Usernames always end in 'bot'. --

  5. When added to a group, bots do not receive all messages by default. --

  6. Bots never eat, sleep or complain (unless expressly programmed otherwise).

class: center

The Botfather

One Bot to rule them all, One Bot to find them

One Bot to bring them all and in the darkness bind them

-- The Lord of the Bots, J.R.R.Tolkien

Botfather

The Botfather

Create a new bot

  1. /newbot --

  2. Enter name of the Bot; e.g. Isfahan LUG --

  3. Enter the username of the bot; e.g. ilugbot. (It should end in 'bot') --

  4. Write down the token.

The Botfather

Set commands

  1. /setcommands --

  2. send All of the commands in the following format:

command1 - Description
command2 - Another description

The Botfather

Set Description

The description is a text, up to 512 characters long, which describes your bot.
It will be shown at first of every conversation with the bot.

  1. /setdescription
  2. Send the description of the bot to botfather --

Set About Text

The about text is a up to 120 characters long text which will be shown at your bot's profile.

  1. /setabouttext
  2. Send the about text of the bot to botfather --

.right[.bottom[check out other commands with /help]]

API

  • The Bot API is an HTTP-based api. It supports GET and POST requests. --

Making Requests:

  • All queries must be served over HTTPS and in this form: https://api.telegram.org/bot<token>/METHOD_NAME --

  • All queries must be made using UTF-8. --

  • All methods are case-insensitive. --

  • The response is a JSON object which:

    • always has an 'ok' boolean field. --
    • has a 'result' field if the response is ok. --
    • may have an optional 'description' field which contains some info about the occurred error. --
    • also has a 'error_code' in the case of errors.

Some Examples

  • Use Postman in order to test the API.

.center[getMe]

Some Examples

  • Use Postman in order to test the API.

.center[getUpdates]

Python Telegram Bot

Sweet Python!

In order to write out bot, we need an interface. Here we use python-telegram-bot which is written in Python.

It is under development and is well written. Good documentation and has wiki.
check out the project site.

  • Installing
pip install --upgrade python-telegram-bot
* Install [python pip](https://pip.pypa.io/en/latest/installing.html) first.

--

  • Using
>>> import telegram
>>> bot = telegram.Bot(token='your_bot_token')

Some Examples

  • To get Bot's info:
>>> print bot.getMe()
  • To get updates:
>>> updates = bot.getUpdates()
>>> print [u.message.text for u in updates]
  • To send a text message:
>>> chat_id = bot.getUpdates()[-1].message.chat_id
>>> bot.sendMessage(chat_id=chat_id, text="Can I help you?")
  • To send an Emoji:
>>> bot.sendMessage(chat_id=chat_id, text=telegram.Emoji.SEE_NO_EVIL_MONKEY)

class: center, middle

Time to write your own bot!

class: center, middle

Thank you

Alireza Omidi

alireza530@gmail.com
Github
@alirezageek

Mahdi Fooladgar

mahdifooladgar@compland.ir
Github
@professormahi