Are you on the lookout for a seamless strategy to create a NodeJS Telegram bot? If that’s the case, you’re exactly the place that you must be! This NodeJS Telegram bot tutorial will present you find out how to create one for relaying real-time blockchain switch occasions! Due to Moralis, it is possible for you to to construct this NodeJS Telegram bot in solely three steps:
- Making a Backend Server
- Setting Up a Moralis Stream
- Constructing the NodeJS Telegram Bot
If you need to leap straight into the code, try the NodeJS Telegram bot GitHub repository beneath:
Full NodeJS Telegram Bot GitHub Repo – https://github.com/MoralisWeb3/youtube-tutorials/tree/predominant/automated-telegram-nft-transfer-bot
Overview
We’ll begin off this text by diving into the intricacies of Telegram bots. From there, we’ll briefly look at the instruments and sources required for constructing a NodeJS Telegram bot. As such, we’ll concentrate on Moralis and the Web3 Streams API. Subsequent, we bounce straight into the NodeJS Telegram bot tutorial, masking the method of constructing one from begin to end. So, if you wish to create your very personal NodeJS Telegram bot, observe alongside all through this text!
If in case you have additional curiosity within the Web3 growth area, we advocate exploring Moralis additional. The Streams API is just one software that may help your growth endeavors. One other instance is the NodeJS EVM API, which may turn out to be useful at any time when creating EVM-compatible tasks. Together with its Web3 APIs, Moralis presents extra Web3 sources, similar to glorious blockchain growth content material. If this pursuits you, try our guides on the Verse programming language or learn the way Web3 get occasion logs to work!
Earlier than persevering with, join with Moralis, as you want an account to observe alongside on this NodeJS Telegram bot tutorial. Creating an account is free, and you may instantly leverage the ability of blockchain know-how!
What’s a Telegram Bot?
Earlier than exhibiting you find out how to create a NodeJS Telegram bot, the article will initially discover the ins and outs of those bots. So, what precisely is a Telegram bot?
Briefly, a Telegram bot is a program that acts like a traditional chat companion however comes outfitted with extra features. Bots can carry out predefined duties with none person involvement. Moreover, a Telegram bot can do all the pieces a human chat companion does both robotically or on specific requests. This contains fundamental performance similar to relaying info like textual content messages, movies, photographs, or some other information.
Consequently, with a Telegram bot, it’s potential to automate real-time alerts to inform customers when one thing of curiosity occurs, which is strictly what we’ll present you find out how to do on this article!
How Can You Construct a Telegram Bot?
With a short introduction to Telegram bots, you may ask your self, ”can I construct a Telegram bot with JavaScript?”. Effectively, the reply to this query is sure! To indicate you ways that is carried out, we’ll exhibit find out how to create an easy NodeJS Telegram bot that listens to and relays real-time information concerning blockchain occasions utilizing Moralis!
With the intention to get the knowledge referring to the on-chain occasions, we’ll use the Web3 Streams API. With this growth software, you possibly can stream blockchain information immediately into your backend server through Web3 webhooks. From there, we’ll educate you find out how to ship notifications about these occasions by means of a Telegram bot!
So, if you wish to discover ways to create a Telegram bot, be part of us within the following NodeJS Web3 tutorial as we break down the method from begin to end!
Tutorial: Construct a NodeJS Telegram Bot
With a extra complete understanding of Moralis’ Streams API, this part will dive into the central a part of this text. The NodeJS Telegram bot we’re about to construct makes use of a Web3 stream to watch EVM occasions and autonomously ship messages to your Telegram channel. Furthermore, on this tutorial, we’ll present you find out how to take heed to all transfers of the “Doodles NFT” sensible contract.
Due to the accessibility of Moralis, the Streams API, and the NodeJS SDK for Web3, you may be to construct this Telegram bot in three simple steps:
- Making a Backend Server
- Setting Up a Moralis Stream
- Constructing the NodeJS Telegram Bot
By following alongside on this NodeJS Telegram bot tutorial and finishing the aforementioned steps, you’ll discover ways to monitor blockchain occasions and obtain messages associated to on-chain occurrences. From there, you possibly can observe the identical workflow to watch any sensible contract occasions on all blockchain networks!
Nonetheless, should you choose watching movies to coach your self, you may also try the clip beneath from Moralis’ YouTube channel. On this video, considered one of Moralis’ proficient software program engineers takes you thru the whole course of from begin to end:
Now, earlier than leaping into step one of this NodeJS Telegram bot tutorial, the subsequent part briefly covers the tip outcomes. Doing so offers you a extra profound understanding of what you’re working in the direction of, making it simpler to visualise what the code does!
Construct a NodeJS Telegram Bot – What Are You Working Towards?
Earlier than exhibiting you find out how to arrange the backend for the NodeJS Telegram bot, we’ll initially present you the way it works. As such, allow us to instantly take a more in-depth have a look at the tip end result:
Because the picture above illustrates, you’ll arrange a brand new Doodle NFT bot channel, to which the bot returns the response from the Web3 stream. You can too see a few transactions despatched to the channel. These responses comprise from/to addresses, a token merchandise, and a transaction hash. Nonetheless, that is solely a number of information returned from the Web3 stream. As such, you possibly can select from the response to customise the messages as you see match.
Nonetheless, that covers the tip outcomes, and also you now know what you’re working towards. In the event you discovered this attention-grabbing and wish to create your personal NodeJS Telegram bot, be part of us as we bounce straight into step one of the tutorial!
Step 1: Making a Backend Server
To kickstart this NodeJS Telegram bot tutorial, begin by launching your most well-liked built-in growth atmosphere (IDE), arrange a brand new NodeJS challenge, and create a folder referred to as ”backend”. You possibly can then add a brand new file referred to as ”index.js” to the aforementioned folder and enter the next contents:
require("dotenv").config(); const categorical = require("categorical"); const app = categorical(); const port = 5001; app.use(categorical.json()); app.publish("/webhook", async (req, res) => { const webhook = req.physique; console.log(webhook); return res.standing(200).json(); }); app.hear(port, () => { console.log(`Listening for NFT Transfers`); });
With this code, we initially require the mandatory dependencies and specify that your Categorical server will run on “localhost 5001“. What’s extra, the code on the far finish additionally ensures that we take heed to this server by calling the ”app.hear()” perform whereas passing the ”port” variable as an argument. The code additionally introduces the ”/webhook” endpoint, which that you must begin in your system. Nonetheless, earlier than doing so, we should guarantee we will publish to this webhook. You possibly can accomplish this by utilizing “ngrok” to create a tunnel to your native machine, which means anybody can entry the endpoint over the web.
To take action, you initially want to put in ngrok, which you are able to do by opening a brand new terminal and working the next command:
brew set up ngrok/ngrok/ngrok
From there, you need to additionally set up the ngrok dependencies in your ”backend” folder. As such, ”cd” into ”backend”, enter this command, and hit enter:
npm i ngrok
With the dependencies put in, the subsequent factor that you must do is run the next command utilizing port 5001:
ngrok http 5001
This may return a URL, which that you must copy and save for the subsequent step:
Nonetheless, earlier than concluding this preliminary step of the NodeJS Telegram bot tutorial, you need to run the Categorical server. As such, open a brand new terminal, ”cd” into the backend folder, and begin by putting in the required dependencies utilizing this command:
npm i dotenv categorical node-telegram-bot-api nodemon
Subsequent, all that is still is so that you can launch the server by inputting the next and hitting enter:
npm run begin
Step 2: Setting Up a Moralis Stream
With the server up and working, the subsequent step is to create a brand new Moralis stream. As such, you probably have not already, join with Moralis instantly and log in to the admin panel. You possibly can then click on on the ”Streams” tab and choose ”Create a brand new stream”:
Subsequent, decide the ”Create it from Admin” possibility and enter the handle of the sensible contract you want to monitor (in our case, we fetch the Doodles contract handle from Etherscan):
From there, progress to the ”Stream Configurations” half and fill within the enter fields. To start with, add the ngrok URL from the earlier step to the ”Webhook URL” area and embrace the ”/webhook” endpoint. Subsequent, add an outline and tag of your selection:
When you end the stream configurations, select the community you want to monitor. On this case, we’ll go for the Ethereum mainnet:
After getting chosen the community you have an interest in, transfer on to the fourth step, and examine the ”Contract interactions (logs)” field for the handle exercise:
Lastly, for the final step, you need to add the ABI of your contract. In the event you need assistance fetching this info, you possibly can go to Etherscan, navigate to the contract you have an interest in, click on on the ”Contract” tab, and scroll all the way down to the ”Contract ABI” half:
When you paste the ABI, Moralis will autonomously present you the subjects you possibly can stream. On this case, because you wish to monitor the transfers of the Doodles contract, examine the ”Transfers(handle,handle,uint256)” field:
That’s it for the stream! As quickly as you launch it, you possibly can transfer again your IDE, open a brand new terminal, and it is best to shortly be receiving responses consisting of assorted switch occasions:
Step 3: Constructing the NodeJS Telegram Bot
With the responses trickling into the backend server through the Moralis stream, it’s time to arrange the NodeJS Telegram bot. This third step of this tutorial is split into two sections:
- Creating the Bot
- Connecting it with the Code
As such, with out additional ado, allow us to bounce straight into the method of establishing the bot!
Creating the Bot
The very first thing you need to do is open Telegram, seek for ”Bot Father”, and begin a dialog. As quickly as you begin the dialog, it is best to discover a begin button on the backside of the interface. When you hit this button, it ought to end in an interface much like the one proven beneath:
From there, you possibly can create a brand new bot by hitting ”/newbot” and selecting an applicable identify:
Subsequent, ”Bot Father” will question you for a username, and it wants to finish with ”_bot”:
You’ll instantly discover a token API whenever you hit enter and create the bot. Copy this worth and reserve it for later:
Lastly, create a brand new Telegram channel and add the bot as an administrator. You are able to do so by clicking on the three dots on the prime, hitting ”Data”, deciding on ”Administrator”, and lastly, hitting ”Add Admin”:
That’s it for the bot itself! All that is still from right here is connecting it with the code and the Web3 stream!
Connecting it with the Code
Now that you’ve the bot at your disposal, you need to additionally add it to the code. To take action, begin by creating a brand new ”.env” file and including the entry token as an atmosphere variable. It ought to look one thing like this:
TELEGRAM_BOT_TOKEN = “589017050…”
From there, change the contents of ”index.js” with the next code snippet:
require("dotenv").config(); const categorical = require("categorical"); const TelegramBot = require("node-telegram-bot-api"); const app = categorical(); const port = 5001; const TELEGRAM_BOT_TOKEN = course of.env.TELEGRAM_BOT_TOKEN; const bot = new TelegramBot(TELEGRAM_BOT_TOKEN, { polling: true }); app.use(categorical.json()); app.publish("/webhook", async (req, res) => { const webhook = req.physique; for (const nftTransfer of webhook.nftTransfers) { const fromAddress = `From handle: ${nftTransfer.from.slice( 0, 4 )}...${nftTransfer.from.slice(38)}`; const toAddress = `To deal with: ${nftTransfer.to.slice( 0, 4 )}...${nftTransfer.to.slice(38)}`; const tokenItem = `Token Merchandise: ${nftTransfer.tokenName} #${nftTransfer.tokenId}`; const transactionHash = `Transaction Hash: ${nftTransfer.transactionHash}`; const chatId = “REPLACE_ME”; const textual content = `${fromAddress}, ${toAddress}, ${tokenItem}, ${transactionHash}`; bot.sendMessage(chatId, textual content); } return res.standing(200).json(); }); app.hear(port, () => { console.log(`Listening for NFT Transfers`); });
Lastly, the ultimate step is changing ”REPLACE_ME” on line 29 together with your chat ID. To get this ID, go to the endpoint down beneath:
https://api.telegram.org/botTOKEN_API/getUpdates
Nonetheless, be certain to switch ”TOKEN_API” together with your precise token API. Doing so ought to take you to a web page trying one thing like this:
As such, all that you must do from there’s copy the chat ID, enter it into the code, and begin the server as soon as once more with the next terminal enter:
npm run begin
Congratulations! You now know find out how to arrange a NodeJS Telegram bot from scratch! If all the pieces works as supposed, all switch occasions must be relayed and despatched to the Telegram channel.
In the event you had hassle at any level throughout this information, please try the video from the ”Tutorial: Construct a NodeJS Telegram Bot” part. This video breaks down the code in additional element, hopefully answering any of your queries. You can too discover the entire NodeJS Telegram bot GitHub code down beneath:
Full NodeJS Telegram Bot GitHub Repository – https://github.com/MoralisWeb3/youtube-tutorials/tree/predominant/automated-telegram-nft-transfer-bot
Abstract – Methods to Construct a Telegram Bot Utilizing NodeJS
On this article, we started by masking the ins and outs of Telegram bots. From there, we explored Moralis and the Streams API, as this is likely one of the instruments used all through this tutorial. From there, we dove straight into the NodeJS Telegram bot tutorial, the place we demonstrated find out how to create one in solely three steps:
- Making a Backend Server
- Setting Up a Moralis Stream
- Constructing the NodeJS Telegram Bot
As such, you probably have adopted alongside this far, you now know find out how to create a NodeJS Telegram bot relaying info concerning blockchain occasions! What’s extra, if you wish to try the complete code, go to the NodeJS Telegram bot GitHub repository!
In the event you discovered this tutorial instructive, be happy to study Web3 programming additional right here at Moralis’ Web3 weblog. As an example, try our articles on find out how to create a blockchain Discord bot or learn in regards to the intricacies of danksharding.
Nonetheless, it doesn’t matter in case you are trying to construct a NodeJS Telegram bot or some other Web3 tasks; join with Moralis now! You possibly can create your account free of charge, and it solely takes a few seconds!