Building a Telegram Bot for Cowin Shot Slots Rajesh Rajamani · Follow Published in
CloudForDummies · 5 min read · ⚽️ May 13, 2024 -- 1 Listen Share
Cowin Shot Slot
availability chase has become an extremely competitive space with the gap ⚽️ in supply and
demand in India . Several techies are doing their best to educate and empower people
with one ⚽️ of the largest vaccination drive in the world’s 2nd most populous
country.
Here is my recipe to provide timely alerts to ⚽️ those in search for a CoWin slot
.
Assumptions: I assume you have some idea about oth AWS Lambda , Python ⚽️ programming
and Telegram to proceed further.
Remember to read the last section of this
article
Architecture
Architecture
I was motivated to use AWS Lambda ⚽️ given the
simplicity of deploying the code and being able to scale up and scale down .
Telegram
was my choice ⚽️ to broadcast the messages given the flexibility it has in creating a bot
, channel and the “200,000” subscribers limit ⚽️ to any broadcast channel you create.
That’s convenient.
Step 1: Bot Creation with Telegram
If you have not already signed up
for ⚽️ Telegram , I think its time you do one . Proceed after you have created your
Telegram ID and signed ⚽️ up.
Telegram provided the ultra-simple way to create your own
bot . You can chat with “@botfather“ a specialized Telegram Bot ⚽️ that can assist you
.
First , open up your Telegram app on phone and search for “ @botfather
”
botfather
Click “Start” ⚽️ to communicate
communicated started with botfather
Now we
want to create a newbot . Use the command “/newbot” and proceed with the
⚽️ process.
Ensure the following.
a. Select a unique name for your bot
b. Get the
Authorization token ( save it some where we ⚽️ need it shortly )
c. Set up a Description
for your bot
Step 2: Channel Creation with Telegram
A Bot account can be ⚽️ used to
respond to messages ( essentially reply ) . However that’s not convenient if we have to
transmit messages ⚽️ to large audience . In such situations it’s useful to use “Channels”
. So let’s create one.
New Channel
Name your Channel
Once ⚽️ the channel is created , you
need to add the Bot created in step 1 as an administrator to enable ⚽️ sending broadcast
messages .
It’s such a good idea to limit the rights the bot will have for this
channel.
Step 3: ⚽️ Create Lambda Function
I’m not going to deep dive about how to create
the Lambda Function .
Note : The script I ⚽️ have provided may not be the most optimized
one . I have purposefully left it generic for customization . Please ⚽️ feel free to use
it as you please.
Things to note while creating the Lambda Function
Ensure to create
your Lambda Function ⚽️ in ap-south-1 “Mumbai Region” Ensure to keep your execution
trigger to not exceed 100 API calls within a 5 minute ⚽️ interval .
The lambda function
has 2 critical steps
a. Fetching data from the Cowin API for the district / districts
defined ⚽️ in the districts variable ( lines 15–48 )
b. Broadcasting the message to
Telegram . ( lines 57–74 )
Observe that in ⚽️ line 67 I’m invoking the Telegram API with
the botapikey (parameter botapikey ) from step 1 and the channel ID ⚽️ ( parameter chatid
) from step 2 and the message to be transmitted ( which is essentially the records that
⚽️ i fetched from the Cowin API )
url =
f”//api.telegram/{botapikey}/sendMessage?chat_id={chatid}&text={finalmessage}"
St
ep 4: Schedule the Lambda Function
For this I’m using AWS CloudWatch .
Click ⚽️ on
Rules
Create a New Rule
Use a Cron Expression here to specify how frequently you want
to run the function. Other ⚽️ considerations such as concurrency , scaling can be done at
the Lambda function window.
Use Crontab.guru if in doubt .
My Bot ⚽️ is
broadcasting
Strategy Points to keep in mind :
The same approach is being used by
several tech enthusiasts to provide customized ⚽️ updates . And this means the Cowin API
Server is taking a lot of hits. Avoid throttling your requests to ⚽️ the API . You may end
up getting blocked interim. Set your schedule for fetching the API sensibly. Sometimes
the ⚽️ data can be in cache and upto 30 minutes old ( refer to the API Documentation ) If
possible group ⚽️ with other like minded enthusiasts to narrow down your scope of search
like a particular district , city , pincode ⚽️ whatever it is . Respect fair use policies
of all the involved technologies such as AWS , Telegram , API ⚽️ Setu . It’s a beautiful
thing that almost all of these services are free of cost . Let’s respect that ⚽️ and dont
get greedy with it. Secure your bot API Keys with environment variables to avoid bot ID
getting misused.
If ⚽️ you come across a suggestion , alternative approach , help please
shout out. Glad to help .
Inspiration :
Berty Thomas on ⚽️ Twitter : @BertyThomas
Thanks.
