michaelzs85 / CTBot

A simple (and easy to use) Arduino Telegram BOT Library for ESP8266

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CTBot

Build Status


Introduction

CTBot is a simple Arduino class to manage Telegram Bot on ESP8266 platform. It relies on ArduinoJson library so, in order to use a CTBot object, you need to install the ArduinoJson library first (you can use library manager). You also need to install the ESP8266 Arduino Core and Library. Don't you know Telegram bots and how to setup one? Check this.

  • Please pay attention to the installed version of ArduinoJson library: it MUST be 5.13.5 or lesser.

News

  • Added reply keyboards support
  • Added contact messages support

Feature

  • Manage WiFi connection (methods for connecting to an access point, set a static IP)
  • Send and receive messages
  • Inline keyboards
  • Receive localization messages
  • Reply keyboards (NEW)
  • Receive contacts messages (NEW)

Supported boards

The library works with the ESP8266 chipset: all the ESP8266 boards are supported.

Simple usage

See the EchoBot example provided in the examples folder.

Reference

Here how to use the library.

Special thanks

A special thanks go to these people who helped me making this library

  • Gianmaria Mancosu
  • Marco Madlena

Future work

  • Add Telegram inline keyboards
  • Add ESP32 support & testing

Changelog

  • 1.4.1 New Telegram Server IP and fingerprint update.
  • 1.4.0 Reply keyboard added. Contact messages functionality added.
  • 1.3.2 Bug fixing and new functionalities:
    • URL encoding: now it is possible to send all kind of characters
    • Added group infos (ID and Group title) in the TBMessage structure
  • 1.3.1 Fixed an issue that doesn't support negative and 64 bit values for chatID/groupID: now it use int64 numbers. This issue involved the CTBot::sendMessage() method.
  • 1.3.0 added new functionalities:
    • 2.5.0 ESP8266 toolchain support
    • Telegram server fingerprint authentication added
    • bugfixing:
      • 'TBUser' data now are populated correctly
      • Fixed a bug that doesn't send correctly some kind of messages
  • 1.2.0 Added localization messages, bug fixing
  • 1.1.1 Minor bug fixing
  • 1.1.0 Added inline keyboards, bug fixing
  • 1.0.1 Better performance, new algorithm for Telegram server queries: now sending and receiving messages requires almost no time.
  • 1.0.0 Initial version

About

A simple (and easy to use) Arduino Telegram BOT Library for ESP8266

License:MIT License


Languages

Language:C++ 95.1%Language:C 4.9%