IsItUP
IsItUP copied to clipboard
Telegram bot to verify if a website is up or track an URL to be notified when it gets down.
IsItUP? Bot
A Telegram bot that verifies whether or not a website is up, tracks URLs and notifies when hosts have unreachable connections. https://t.me/Is_it_UPBot
Installation
- Meet IsItUP? at telegram :D
or run your own bot
- Clone the project
- Go to your IsItUp directory
cd /path/to/IsItUP/
- Set an enviroment variable named
IS_IT_UP_TOKENwith your telegram token. Read this great article and learn how to do it properly. On bash:
export IS_IT_UP_TOKEN=your_telegram_token
-
(Optional) Setup Firebase if you want to enable the track feature)
- Create a Firebase project and download its credentials
- Set environment variables named
IS_IT_UP_FIREBASE_PRIVATE_KEY,IS_IT_UP_FIREBASE_CLIENT_EMAILandIS_IT_UP_FIREBASE_DATABASE_URLwith your firebase credentials (private key and client email are in the downloaded file)
export [email protected] -
Install node and npm
-
Download the dependencies
npm install
- Run the script
npm start
Usage
It can be done with IsItUP? bot or your own bot:
Conversation
- Start a conversation with the bot
- Type:
/verify https://telegram.org
or just
https://telegram.org
to verify whether a website is available or not
Track (if enabled)
- You may track an URL by typing: // check step #4 for enabling tracking
/track https://telegram.org
- You may delete an URL from the track list by typing:
/track_delete
and then click at the URL you want to delete
- To list the URLs you are tracking:
/track_list
Every 5 minutes the bot will check the track list. The user will be notified when the status of an URL get changed(up->down, down->up).
Group
-
You may as well invite the bot to a group
-
Call it by name and tell the domain you want to watch
@Is_it_UPBot https://telegram.org
PS: telegram.org is a sample (of course :D), type whatever you need.
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request :D
Thanks
- isitup.org - for the concepts and ideas
- Node.js Telegram Bot API - for providing an easy way to create a telegram bot
License
MIT