Skip to content
 
 

Repository files navigation

WhatsApp Status Checker

WhatsApp Status Checker

The WhatsApp Status Viewer view a specific WhatsApp contact status as soon as it is uploaded, send a WhatsApp message about the status type(Image, Video, Text, or Audio) and the time at which it was viewed OR alternatively always check and notify you if a status is uploaded. You get notified every 30minutes, 1hour, 3hours or 6 hours depending on your choice.

NOTE: WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.

Requirements

See requirements.txt

Installation

  • Download or clone this project.
  • Open CMD from the project directory.
  • Create a Virtual Environment using the following command py -m venv your_env_name.
  • Activate your virtual environment and run the below command to install dependencies.
pip install -r requirements.txt

WhatsApp Messenger

Python-WhatsApp-Bot was used for WhatsApp message, PLEASE READ!

WhatsApp Business Cloud API Dashboard

You should see a screen like this

WhatsApp Business Cloud API Dashboard Image

How to use

Make sure your installed Google Chrome Browser is the latest.

  • Open .env file. See WhatsApp Business Cloud API Dashboard for your infomations.

    • Set NUMBER to your phone number. # Your WhatsApp Number e.g: 234xxxxxxxxxx
    • Set NUM_ID to your phone number id. # Your Number ID provided by WhatsApp Business Cloud API
    • Set TOKEN to your token. # Token provided by WhatsApp Business Cloud API

    REMEMBER GENERATED TOKEN EXPIRES EVERY 24HOURS. IF YOU NEED A PERMENENT TOKEN, LET ME KNOW

  • Then navigate to src/whatsapp-status-checker directory, open config.py.

    • Set status_uploader_name to your desired contact name (make sure it is exactly how it is saved on your phone(Case Sensitive)).
    • Set timezone to your location time zone. # See TODO for more information.
  • Run py main.py.

Screenshots

Terminal | First Time Logging In

WhatsApp first time log in

Terminal | Viewed Contact Status

WhatsApp subsequent log in view status 2

WhatsApp Message | Status Notification

WhatsApp first time log in

See other Screenshots, Click here

Errors and Fixes

  • Timeout When Logging in: Increase the timeout value 60 at wait = WebDriverWait(bot, 60).

    Preferrably, use a more stable internet.

  • Not Receiving WhatsApp Message: Send a message to your Test Number.

    If a message isn't sent to your test number within 24hours, you would not recieve message.

Support and Contribute

  • Please star 🌟 to encourage developer(s).
  • Fork, do your thing and create a PR.

TODO

  • PyPi Package.
    • Convert to a package.
    • publish to PyPi.
  • Automatically
    • Use specified timezone othwerwise automatically get it.
    • Check first time activity.
      • Make sure it is completely synced with phone (Loading messages).
    • Handle Chromedriver
      • Check if Chrome browser version is same as chromedriver else download lastest
      • Download latest chromedriver.
      • Extract and move to driver directory.
    • Handle dedicated Chrome profile
      • Create a new chrome profile(if not previously done).
      • Use the newly chrome profile(if just created for the first time).
      • Use existing chrome profile(if already created).

About

The WhatsApp Status Viewer views a specific WhatsApp contact status as soon as it is uploaded OR get notified every 30mins, 1hour, 3hours or 6hours.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages