itapirema / isitup

Telegram bot to verify if a website is up

IsItUP? Bot

Telegram bot to verify if a website is up or track an URL to be notified when it gets down. https://t.me/Is_it_UPBot

Installation

1. Meet IsItUP? at telegram :D

or run your own bot

1. Clone the project
2. Go to directory

cd IsItUP/

3. Set an enviroment variable called IS_IT_UP_TOKEN with your telegram token. To learn how to do: read this great article. At bash:

export IS_IT_UP_TOKEN=your_telegram_token

4. (Optional) Setup Firebase. (If you want the track feature)

   • Create a Firebase project and download the credentials
   • Set environment variables called IS_IT_UP_FIREBASE_PRIVATE_KEY, IS_IT_UP_FIREBASE_CLIENT_EMAIL and IS_IT_UP_FIREBASE_DATABASE_URL with your firebase credentials (private key and client email are in the downloaded file)

   export [email protected]

5. Install node and npm

6. Download the dependencies

npm install

7. Run the script

npm start

Usage

It can be done with IsItUP? bot or your own bot.

Conversation

• Start a conversation
• Type:

/verify https://telegram.org

or just

https://telegram.org

to verify the availability of one website

Track (if enabled)

• To track an URL, you have to type:

/track https://telegram.org

• To get a list of URLs you are tracking:

/track_list

Every 5 minutes the bot you run a check all tracked URLs, if the status of an URL get changed(up->down, down->up), the user will be get notified.

Group

• Invite the bot to a group

• Call it by name and tell the domain

@Is_it_UPBot https://telegram.org

PS: telegram.org is a sample(of course :D), type whatever you need.

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

Thanks

• isitup.org - for the concept
• Node.js Telegram Bot API - for provide an easy way to create a telegram bot

License

MIT