Giter Club home page Giter Club logo

whatsbot's Introduction

WBOT

Support me on Patreon Buy me a book PayPal

A simple Nodejs BOT for whatsapp web

PreviewFeaturesDownloadsHow to?Technologies UsedWhy?GoalsFAQ

Preview

Quick preview

Screenshot gif

Features

  • 🎨 Highly customizable json
  • 💯 Totally Free for personal use
  • 🔒 Complete Privacy. Your data stays with you always

Downloads

macOS Windows Linux
Download v0.6-beta Download v0.6-beta Download v0.6-beta

Supported Platforms

Following platforms are supported by Wbot:

macOS The minimum version supported is macOS 10.9.

Windows Windows 7 and later are supported

Linux:

  • Ubuntu 12.04 and later
  • Fedora 21
  • Debian 8

How to start the BOT?

steps

After download extract the zip and command prompt or terminal at that location there will be a file named wbot-* run it and you should be good to go.

for linux you need to provide exacutable permission before you exacute the binary do

chmod +x wbot-linux && wbot-linux

Configurations

Basic Configuration is in bot.json file like replying to Hi, hello and happy birthday. you can add/remove yours if you need. keep in mind that you need to restart the wbot to see the effect of change. make sure json is valid. use VSCode or jsonlint to validate json.

bot.json

appconfig

This is where all the application related(node application behavior and such things) config will stay. will add more in future.

  • headless Whether to start chrome as headless or not. this is regarding #4. Apparently, Whatsapp doesn't allow headless instances.
  • isGroupReply Whether to send replies in group or not. If set to false Bot will not reply if message received in group chat.

bot

An array of objects. Properties of Object are self explanatory.

  • Contains If message has one of that word anywhere in the message

  • exact If message is exactly as one of the messages form array

  • Response If any of the above conditions becomes true then corresponding response string will be sent as message to the user or group.

Blocked

Array of numbers with county code to which this bot will not reply to.

noMatch

Default reply message when no exact match found in BOT

smartreply

An object which contains suggestions and it's configs.

  • suggestions An Array of suggestions
  • clicktosend Whether to send or just write message when user clicks on suggestion

here is how that looks

smart reply gif

Technologies

Why?

The main reason I decided to build this is that I need a simple tool to reply to my "happy birthday" message. I know it is kind of blunt and rude but it would take me 2-3 days to reply to all and by that time that moment would be gone. I just need a good solution to this problem. I really don't need a full-fledged AI-BOT or BOT with NLU (or some other acronym). I believe there are many people who also have such need.

Goals

With that in mind, I know that WBOT would need to satisfy these criteria:

  • 🚀 Fast!!!
  • 👍 Friendly CLI UX
  • 🔒 Does not touch user’s data
  • 💰 Free! for personal use

If you think WBOT delivers these, let me know by putting a star 🌟 on this project 😉

FAQ

  • Is this app built with NodeJS?

Yes, it's built with NodeJS. Please see the Technologies section for more info.

  • What boilerplate did you use?

None. The idea was to get a better understanding of how things work together, But I do take a cue from other projects.

  • What npm modules did you use?

  • Apart from development, What else do you do?

I do motion design and UI/UX development.

  • Are you available for hire?

I have a full-time job as a software developer at technobrains.net and at mindtechconsultancy.com. I am available as a freelance consultant during my spare time please let me know what you have in mind.

  • How do I contact you?

If you find an issue, please report it here. For everything else, please drop me a line at [email protected]

Legal

This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by WhatsApp or any of its affiliates or subsidiaries. This is an independent and unofficial software. Use at your own risk. Commercial use of this code/repo is strictly prohibited.

Contact Me

Contact me on twitter Contact me on telegram

whatsbot's People

Watchers

James Cloos avatar

Forkers

pkhadson

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.