/Blue-Prism-Telegram-Message-Example

A Blue Prism Release Package containing an example Visual Business Object (VBO) and Process to demonstrate sending messages to a Telegram Channel using the Telegram BOT Api through Blue Prism.

MIT LicenseMIT

Blue Prism Telegram Message Example

A Blue Prism Release Package containing an example Visual Business Object (VBO) and Process to demonstrate sending messages to a Telegram Channel using the Telegram BOT Api from Blue Prism.

This repository is a companion to the LinkedIn article: https://www.linkedin.com/pulse/sending-messages-telegram-channel-using-blue-prism-christian-pacella

The Release Package was created with Blue Prism 6.4.

Getting Started

In order to send messages to Telegram from Blue Prism, the following steps must first be completed:

  1. Download and install Telegram on your preferred device
  2. Create a Telegram public channel
  3. Create a Telegram BOT via BotFather
  4. Obtain your BOT Api Key
  5. Set the bot as administrator in your channel
  6. Obtain your channel Chat Id

Obtaining your channel Chat Id can be tricky, but the following article was useful: https://tutorials.botsfloor.com/creating-a-bot-using-the-telegram-bot-api-5d3caed3266d

If you completed the steps above, you can now send a message to your channel by issuing an HTTP GET request to the Telegram BOT API at the following URL:

https://api.telegram.org/bot[BOT_API_KEY]/sendMessage?chat_id=[MY_CHANNEL_CHAT_ID]&text=[MY_MESSAGE_TEXT]

where:

  • BOT_API_KEY is the API Key generated by BotFather when you created your bot
  • MY_CHANNEL_CHAT_ID is the Chat Id of your channel
  • MY_MESSAGE_TEXT is the message you want to send (URL-encoded)

If you are able to send a test message to your Telegram channel, you are ready to continue with the Blue Prism implementation.

Installing

Download the Example Blue Prism Package

  1. Launch Blue Prism
  2. Click File -> Import
  3. Select the 'ShmoopySoftBluePrismTelegramMessageExample.bprelease' Release Package
  4. Follow the Blue Prism import wizard to install the package

Running

  1. In Process Studio, open the process named 'Telegram Process'
  2. Edit the 'vBotAPIKey' and 'vChannelChatId' data items with your BOT Api Key and Channel Chat Id
  3. Edit the 'vMessageText' data item to set the message text you want to send
  4. Click the Run button, or press F5

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments