{"id":15093474,"url":"https://github.com/ib0b/whatsapee","last_synced_at":"2025-10-10T19:41:53.595Z","repository":{"id":37200300,"uuid":"176166870","full_name":"ib0b/WhatsApee","owner":"ib0b","description":"Whatsapp Web Bot","archived":false,"fork":false,"pushed_at":"2023-04-30T16:39:37.000Z","size":121,"stargazers_count":36,"open_issues_count":2,"forks_count":10,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-10-10T19:41:52.629Z","etag":null,"topics":["ai","chatbot","whats","whatsapp","whatsapp-api","whatsapp-bot","whatsapp-chat","whatsapp-web","yowsup"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ib0b.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-17T22:10:03.000Z","updated_at":"2025-08-26T01:29:27.000Z","dependencies_parsed_at":"2024-10-14T05:41:19.793Z","dependency_job_id":"38436733-9042-4964-a29a-0adc5f04eb92","html_url":"https://github.com/ib0b/WhatsApee","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":0.3157894736842105,"last_synced_commit":"434d7960dccc66b4530f447ad38e8d4729442e54"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ib0b/WhatsApee","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib0b%2FWhatsApee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib0b%2FWhatsApee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib0b%2FWhatsApee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib0b%2FWhatsApee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ib0b","download_url":"https://codeload.github.com/ib0b/WhatsApee/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib0b%2FWhatsApee/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005027,"owners_count":26083827,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chatbot","whats","whatsapp","whatsapp-api","whatsapp-bot","whatsapp-chat","whatsapp-web","yowsup"],"created_at":"2024-09-25T11:23:30.569Z","updated_at":"2025-10-10T19:41:53.577Z","avatar_url":"https://github.com/ib0b.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com) [![forthebadge](https://forthebadge.com/images/badges/uses-js.svg)](https://forthebadge.com) [![forthebadge](https://forthebadge.com/images/badges/you-didnt-ask-for-this.svg)](https://forthebadge.com) \n# WhatsApee [![Node version](https://img.shields.io/node/v/electron.svg?style=for-the-badge)](http://nodejs.org/) ![GitHub](https://img.shields.io/github/license/updatesvc/WhatsApee.svg?style=for-the-badge)\nWhatsapee is a web based bot for Whatsapp.\nThis project is heavily inspired by [bruno222/whatsapp-web-bot](https://github.com/bruno222/whatsapp-web-bot)\n\nA good substitute till WhatsApp releases their API  to the public.\nHowever this code is not perfect for production it has a few bugs.\n\n\n# Table of Contents\n1. [How to use it](#toc1)\n2. [Bot Logic](#toc2)\n3. [FAQ](#toc3)\n4. [Examples](#toc4)\n5. [Todo](#toc5)\n6. [Known Issues](#known-issues)\n\n\n\u003ca name=\"toc1\"\u003e\u003c/a\u003e\n# How to use it?\n\n - Clone the repo. \n -  Install the latest npm and nodeJS for your platform. \n - Then in repo folder run the following commands \n \n     ```npm install```   \n   then run   \n   ```npm start```\n      \n - Signin using QR code and see the bot run your logic, stored in\n   **logic.js**\n\n## Default logic\nHave a friend text you this commands:\n**@help** or **hi bot**\n\n\u003ca name=\"toc2\"\u003e\u003c/a\u003e\n# Bot Logic\n All code goes into the logic.js file\n WhatsApee has two function that you can use\n \n ```Javascript \n WhatsApee.start( receiver callback); \n ```   \n sets the callback for the message handler.\n It should take three arguments :\n - message : body of message\n - chatElem : chat div element which is used as an identifier\n - title : chat title \n \n  ```Javascript \n WhatsApee.send(chat Elem is like chat id , message to send goes here);\n  ```  \n  sends message to the chosen element .It takes two arguments :\n - chatElem : chat div element which is used as an identifier\n - message : body of message\n ## Example implementation\n ``` Javascript\nconst path = require('path')\nconst WhatsApee = require(path.join(__dirname, 'WhatsApee.js'))\n//WhatsAppe.start( receiver callback)\nWhatsApee.start(receiver);\n\nfunction receiver (message,chatElem,title) {\n\t  //message to lower case\n\tvar lcMessage = message.toLowerCase();\n      if (lcMessage.includes(\"hi bot\")) {                  \n                  var welcomeMessage = `Hi , hooman`;   \n                  //WhatsApee.send(chat Elem is like chat id , message to send goes here)               \n                  WhatsApee.send(chatElem,welcomeMessage);                  \n      }  \n      \n}\n```\n\u003ca name=\"toc3\"\u003e\u003c/a\u003e\n# FAQ\n\n#### So it's possible to create a Bot in Whatsapp Web?\n\nYes, it is.\n\n#### Am I going to be banned?\n\nHum, so you already know that Whatsapp does not allow Bots, right?\n\nWell, you're right: Whatsapp will ban you forever if they discovery you are running a Bot on long-term. For a small test: Don't worry, go forward.\n\n\n\n**I can't guarantee that you are not getting banned in a long term using this Bot. I really don't think so, but I can't guarantee.**\n\n#### BS! I got banned using yowsup!\n\nHold on mate, there are kids here.\n\nFirst, [yowsup](https://github.com/tgalal/yowsup) is a great python library! Simply awesome.\n\nBut their problem is: They connect to Whatsapp servers directly, without any middlware. So it is not so hard for whatsapp team to create ban-rules you if you are using yowsup.\n\nI got banned many times in past, so I know, soon or later, you will get banned as well. Is just a matter of time.  You can see that I am probably right just looking [here](https://github.com/tgalal/yowsup/issues/1558), \n[here](https://github.com/tgalal/yowsup/issues/1979), \n[here](https://github.com/tgalal/yowsup/issues/1806) and\n[here](https://github.com/tgalal/yowsup/issues/1686).\n\nThat's why I did this code. Using whatsapp web, it is almost impossible for whatsapp team to know that you are running a Bot.\n\n#### But... What are the limitations?\n\nA lot of limitations!\n\n1. As you are handling DOM direcly, you can't process hundred of messages at once. Yowsup is much better at this subject.\n\n2. You can't start a message with a unknown person. You can only answer them, mainly because you can't add a new fellow on the Contacts list on Whatsapp Web.\n\n2. You have to install Whatsapp on your phone, connect it on Wifi and keep it charging all the time. So you have to have a cellphone exclusively for this Bot. You will need a computer with software running as well. But that's the main objective: In order to avoid being detect as a Bot, so you have to play this boring cat-and-rat game.\n\n#### I think there're some bugs on your code.\n\nYes, there are.\n\n1. Your friend can't send `@HELP` followed of any other message really fast. This Bot only reads the last message. It's a buggy (that can be fixed)\n\nFeel free to fix and PR it.\n\u003ca name=\"toc3\"\u003e\u003c/a\u003e\n# Examples\n- [WhatsApeeBot](https://github.com/updatesvc/WhatsApeeBot)\n\u003ca name=\"toc4\"\u003e\u003c/a\u003e\n# TODO\n- better message detection\n- diagflow AI bot\n- image upload capabilities\n- add support for business accounts\n\n# Known Issues\n- Does not work with business accounts\n\n#### if you like it, starr it ⭐ \n\n\"This project is licensed under the terms of the MIT license.\" [![GitHub](https://img.shields.io/github/license/updatesvc/WhatsApee.svg?style=for-the-badge)](https://github.com/updatesvc/WhatsApee/blob/master/license.md)\n\nMade by [@updatesvc](https://github.com/updatesvc/WhatsApee)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fib0b%2Fwhatsapee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fib0b%2Fwhatsapee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fib0b%2Fwhatsapee/lists"}