Product support

Get help in the plugin support forum.

  • Added on Mar 6, 2019
  • Current version: 1.0.9
  • Compatibility
    October CMS v3.x not tested
    October CMS v2.x not tested
    October CMS v1.x use latest
  • Created by
  • Public repository


Fork of the deprecated Telegram plugin. Refreshed and compatible with the latest build.

This plugin allows you to integrate functions of Telegram bots to your website and send data to users, groups or channels.

Big thanks to


  • Make important notifications about site events to your Telegram application (desktop and mobile devices)
  • Receive messages and command from users and answer them
  • Send messages to groups, chat rooms, channels (like news or some kind of information or statistic)
  • Show keyboard, built-in keyboard
  • All list in the official doc

Create bot

Follow this steps to create bot and receive token.

Configure plugin

  • (required) Set Telegram token
  • (required) Set bot name
  • (required) Set webhook checkbox, it enables receive message from Telegram.
  • (optional) Db encoding. Select your db encoding.
  • (optional) Set certificate path if you use self-signed ssl certificate.
  • (optional) Select admin users. (example)
  • (optional) Botan.io analitycs

Simple notifications

Use plugin to send notification over telegram. To do that:

  • Configure telegram bot account in the backend panel, go to Settings -> Telegram -> Bot settings
  • Add at the top of your controller or page code use \Vdomah\Telegram\Classes\TelegramApi;
  • Get your chat_id from Telegram -> Chats
  • Send message with
    TelegramApi::instance()->sendMessage(['chat_id'=>chat_id, 'text'=>'new order was submitted']);

Create bot behaviour

To be coninued

  • Found the plugin useful on 14 Apr, 2020

    Thank you for this plugin and your help with my issue

  • Found the plugin useful on 23 Apr, 2019

    i still have issues configuring my bot to work for my project because of errors. Would like to know if the plugin will help me achieve sending custom messages to my group chat .

  • author

    Replied on 24 Apr, 2019

    Yes, this plugin allows that. Please use product support page to create a topic and we'll find out how to achieve your goal https://octobercms.com/plugin/support/vdomah-telegram

  • Found the plugin useful on 22 Mar, 2019

    Thank you for the plugin, I would like to see the ability to connect a proxy to bypass telegram locks

  • Found the plugin useful on 20 Mar, 2019

    You must correct the installation of the longman library/telegrambot, now the plugin is not fully operational

  • author

    Replied on 21 Mar, 2019

    Refreshed longman package connection. Now it's fully present in the plugin after installation. I need a bit more time to fully test the plugin functionality now, but feel free to message me if you got any trouble using this plugin.


Replace unsetWebhook usage (deprecated and removed in longman/telegrambot) by deleteWebhook (fix for error on save Bot Settings) (thanks to Xitara)

Oct 24, 2019


Fix using setWebhook method according to it's signature (error on save Bot Settings) (thanks to Xitara)

Oct 24, 2019


Migrations remove default values for nullable fields

Mar 21, 2019


Last longman/telegram-bot version

Mar 21, 2019


Add foreign keys

Mar 06, 2019


Add some columns

Mar 06, 2019


Check webhook button

Mar 06, 2019


Fix error message in settings

Mar 06, 2019


Initialize plugin.

Mar 06, 2019