Skip to content

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.

License

Notifications You must be signed in to change notification settings

KrAsH-CoD3/WhatsApp-Status-Checker

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
      • 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.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published