Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

Plugin Information

View Telegram Bot on the plugin site for more information.

This plugin allows you to send messages from Jenkins jobs to Telegram chat.


Create a Telegram bot

  1. Find BotFather in Telegram (@BotFather)
  2. Send /newbot command
  3. Enter bot name and bot username

Jenkins Global configuration

  1. Open the Jenkins global config
  2. Paste your bot name and username to according textfields
  3. In filed Usernames fill names of users who can get Jenkins messages (separated by spaces)
  4. Save

Subscribe for Jenkins messages

  1. In telegram find your bot and send /start command
  2. Send /sub command


Manage your job

  1. Add build-step (or post build-step)
  2. Fill the message (you can use environment variables and simple Markdown)
  3. Save your job


  1. Unknown User (z1kk0)


    Can I use it in pipeline?

  2. Unknown User (aldochristiaan)

    I can't add multiple telegram bot in post build action .. that would be great if i can send different message depends on build status ..

  3. Unknown User (luzi82)

    CPU go 100% when plugin enabled, 0% when disabled.

  4. Unknown User (luzi82)

    For the CPU 100% issue, no strange text found in log.

  5. Unknown User (lapt)

    Hi! How can I use telegram bot plugin behind a proxy?

    Where proxy-server was specified for using telegram?

    Now I have the following errors at jenkins log:


    Jul 27, 2018 10:07:07 AM org.apache.http.impl.execchain.RetryExec execute
    INFO: I/O exception (org.apache.http.NoHttpResponseException) caught when processing request to {tls}->http://proxy.mydomain.com:3128->https://api.telegram.org:443: The target server failed to respond
    Jul 27, 2018 10:07:07 AM org.apache.http.impl.execchain.RetryExec execute
    INFO: Retrying request to {tls}->http://proxy.mydomain.com:3128->https://api.telegram.org:443
    Jul 27, 2018 10:07:57 AM org.telegram.telegrambots.logging.BotLogger severe
    org.apache.http.NoHttpResponseException: api.telegram.org:443 failed to respond
            at org.apache.http.impl.conn.DefaultHttpResponseParser.parseHead(DefaultHttpResponseParser.java:141)
            at org.apache.http.impl.conn.DefaultHttpResponseParser.parseHead(DefaultHttpResponseParser.java:56)
            at org.apache.http.impl.io.AbstractMessageParser.parse(AbstractMessageParser.java:259)
            at org.apache.http.impl.DefaultBHttpClientConnection.receiveResponseHeader(DefaultBHttpClientConnection.java:163)
            at org.apache.http.impl.conn.CPoolProxy.receiveResponseHeader(CPoolProxy.java:165)
            at org.apache.http.protocol.HttpRequestExecutor.doReceiveResponse(HttpRequestExecutor.java:273)
            at org.apache.http.protocol.HttpRequestExecutor.execute(HttpRequestExecutor.java:125)
            at org.apache.http.impl.execchain.MainClientExec.execute(MainClientExec.java:272)
            at org.apache.http.impl.execchain.ProtocolExec.execute(ProtocolExec.java:185)
            at org.apache.http.impl.execchain.RetryExec.execute(RetryExec.java:89)
            at org.apache.http.impl.execchain.RedirectExec.execute(RedirectExec.java:111)
            at org.apache.http.impl.client.InternalHttpClient.doExecute(InternalHttpClient.java:185)
            at org.apache.http.impl.client.CloseableHttpClient.execute(CloseableHttpClient.java:83)
            at org.apache.http.impl.client.CloseableHttpClient.execute(CloseableHttpClient.java:108)
            at org.telegram.telegrambots.updatesreceivers.DefaultBotSession$ReaderThread.getUpdatesFromServer(DefaultBotSession.java:250)
            at org.telegram.telegrambots.updatesreceivers.DefaultBotSession$ReaderThread.run(DefaultBotSession.java:191)