{"id":15093513,"url":"https://github.com/cttricks/whatsappapi","last_synced_at":"2026-02-17T11:03:27.381Z","repository":{"id":246666517,"uuid":"821780568","full_name":"cttricks/WhatsappAPI","owner":"cttricks","description":"Extend Whatsapp-Web.js Capabilities with Express API","archived":false,"fork":false,"pushed_at":"2024-07-02T10:03:26.000Z","size":22,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-18T15:54:28.922Z","etag":null,"topics":["api","bot","bot-api","expressjs","whatsapp","whatsapp-api","whatsapp-bot","whatsapp-web-js"],"latest_commit_sha":null,"homepage":"https://cttricks.com","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/cttricks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-06-29T12:14:47.000Z","updated_at":"2024-09-20T04:01:22.000Z","dependencies_parsed_at":"2024-06-29T14:37:43.131Z","dependency_job_id":"fe5810da-4e62-40cd-8464-10eee509b897","html_url":"https://github.com/cttricks/WhatsappAPI","commit_stats":{"total_commits":3,"total_committers":2,"mean_commits":1.5,"dds":"0.33333333333333337","last_synced_commit":"93fbace236919afb2eaf02c8acb2419714c01a2b"},"previous_names":["cttricks/whatsappapi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cttricks/WhatsappAPI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cttricks%2FWhatsappAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cttricks%2FWhatsappAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cttricks%2FWhatsappAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cttricks%2FWhatsappAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cttricks","download_url":"https://codeload.github.com/cttricks/WhatsappAPI/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cttricks%2FWhatsappAPI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278956328,"owners_count":26075221,"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-08T02:00:06.501Z","response_time":56,"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":["api","bot","bot-api","expressjs","whatsapp","whatsapp-api","whatsapp-bot","whatsapp-web-js"],"created_at":"2024-09-25T11:23:45.623Z","updated_at":"2025-10-08T13:56:52.292Z","avatar_url":"https://github.com/cttricks.png","language":"JavaScript","readme":"# WhatsappAPI\n\u003cdiv align=\"left\"\u003e\n    \u003cp\u003e\n\t\t\u003cimg src=\"https://img.shields.io/npm/v/whatsapp-web.js.svg\" alt=\"npm\" /\u003e\n        \u003cimg src=\"https://badges.depfu.com/badges/4a65a0de96ece65fdf39e294e0c8dcba/overview.svg\" alt=\"Depfu\" /\u003e\n        \u003cimg src=\"https://img.shields.io/badge/WhatsApp_Web-2.2346.52-brightgreen.svg\" alt=\"WhatsApp_Web 2.2346.52\" /\u003e\n\t\u003c/p\u003e\n\u003c/div\u003e\n\nExtend [Whatsapp-Web.js](https://wwebjs.dev/) Capabilities with [Express JS](https://expressjs.com/)\n\nWhatsappAPI is a Node.js application that extends the capabilities of WhatsApp by providing a RESTful API using [whatsapp-web.js](https://github.com/pedroslopez/whatsapp-web.js) and [Express.js](https://expressjs.com/). This allows developers to automate interactions with WhatsApp, handle incoming messages via callback APIs, and programmatically send messages.\n\n\u003e It is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.\n\n### Features\n- Callback/Postback API: Receive incoming messages and notifications via a predefined callback endpoint.\n- Send Messages API: Programatically send messages to WhatsApp contacts or groups.\n- Integration Ready: Easily integrate with existing systems or applications using the RESTful API.\n\n### Usage Scenario\n- Use this repository to extend your WhatsApp automation capabilities by setting up a local server or deploying it to a VPS.\n- Customize the API endpoints and handling logic to suit your specific automation needs.\n- Ideal for developers looking to automate responses, notifications, or data processing via WhatsApp.\n\n## Installation\n\u003e Node v18+ is required. \n\n### Windows\nTo get started just follow these simple steps\n\n- Clone this repository\n\n    ```cmd\n    git clone https://github.com/your-username/WhatsappAPI.git\n    ```\n- Navigate into the project directory\n\n    ```cmd\n    cd WhatsappAPI\n    ```\n- Install dependencies\n\n    ```cmd\n    npm install\n    ```\n\n- Configure your WhatsApp session credentials and callback endpoints in the `.env` file.\n- Start the server\n\n    ```cmd\n    npm run start\n    ```\n\nWhen you run the service for the first time, it will generate a QR code image that you can find at `/images/whatsapp-qrcode.png` or you can also visit `http://localhost:3000/view-session-qrcode`. Simply open WhatsApp on your phone, navigate to the WhatsApp Web section, and scan this QR code to start a session. Once the session is successfully created, you will see a `CONNECTED \u0026 READY TO USE` message in the console.\n\n🥳 Wohoo... Your WhatsappAPI is Ready to Use!\n\n## Send Message\nTo send your first message, you need to use an API calling tool such as Postman, which you can install on your laptop or PC.\n\n#### Request URL/Endpoint\n\n```curl\nhttp://localhost:3000/send/message\n```\n#### Example payload for sending message on `private-chat`\n\n```json\n{\n    \"message\": \"Hello Tanish\",\n    \"client_id\": \"917XXXXXXX87\",\n    \"token\": \"TOKEN-DEFINED-IN-ENV-FILE\",\n    \"number\": \"916XXXXXXX90\"\n}\n```\n#### Example payload for sending message on a `group`\n\n```json\n{\n    \"message\": \"Hello Tanish\",\n    \"client_id\": \"917XXXXXXX87\",\n    \"token\": \"TOKEN-DEFINED-IN-ENV-FILE\",\n    \"groupName\": \"GROUP-TITLE\"\n}\n```\n\nUse these payloads to send messages to either a private chat or a group. Make sure to replace the placeholder values with actual data and ensure your token matches the one defined in your environment file.\n\n## Acknowledgments \u0026 Support\nBuilt with [whatsapp-web.js](https://github.com/pedroslopez/whatsapp-web.js)\nInspired by the need for customizable WhatsApp automation solutions. For questions, bug reports, or feature requests related to the original repository setup, [please open an issue](https://github.com/pedroslopez/whatsapp-web.js/issues).\n\n## Disclaimer\nThis project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at [whatsapp.com](https://whatsapp.com/). \"WhatsApp\" as well as related names, marks, emblems and images are registered trademarks of their respective owners. Also it is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.\n\n## License\nThis project is licensed under the MIT License. See the LICENSE file for details.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcttricks%2Fwhatsappapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcttricks%2Fwhatsappapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcttricks%2Fwhatsappapi/lists"}