Skip to content

Satya-Shield/Whatsapp-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

22 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SatyaShield WhatsApp Bot

Status Platform Security


Combat Misinformation Instantly on WhatsApp

WhatsApp Meta API Express.js Google Cloud

Turn your WhatsApp into a misinformation detection powerhouse


πŸš€ Try It Now!

πŸ“± WhatsApp Number: +1 (555) 148-2620

Simply send any suspicious text, forward a message, or share an image to get instant fact-checking results!


πŸ“± How It Works

graph TD
    A[πŸ“± User sends message] --> B[πŸ€– WhatsApp Bot receives]
    B --> C[🧠 AI extracts claims]
    C --> D[πŸ” Evidence gathering]
    D --> E[βš–οΈ Verdict & confidence score]
    E --> F[πŸ“Š Manipulative techniques identified]
    F --> G[πŸ“± Results sent back to user]
Loading

Step-by-Step Process:

  1. πŸ“¨ Send Your Query - Forward suspicious messages, send text, or share images
  2. πŸ€– Instant Processing - Our AI agent extracts verifiable claims
  3. πŸ” Evidence Collection - Parallel gathering of credible sources
  4. βš–οΈ Smart Analysis - AI evaluates credibility with confidence scores
  5. πŸ“Š Educational Response - Detailed breakdown of manipulative techniques
  6. πŸ“± Get Results - Comprehensive fact-check delivered instantly

✨ Key Features

🎯 Instant Verification

  • Real-time fact-checking on WhatsApp
  • Support for text and image analysis
  • No app installation required

🧠 AI-Powered Intelligence

  • Advanced claim extraction
  • Parallel evidence gathering
  • Manipulative technique detection

πŸ“Š Educational Insights

  • Confidence scoring system
  • Detailed reasoning explanations
  • Misinformation pattern recognition

🌐 Seamless Integration

  • Direct WhatsApp interaction
  • Cross-platform compatibility
  • 24/7 availability

πŸ“Έ Screenshots & Demo

πŸ’¬ Chat Interface πŸ“Š Analysis Results 🚨 Misinformation Detection
Clean, intuitive WhatsApp interaction Comprehensive fact-checking with confidence scores Detailed breakdown and explanation
Chat Interface Analysis Results Misinformation Detection

πŸ› οΈ Tech Stack

Technology Purpose Version
Node.js Runtime Environment 18+
Express.js Web Framework 4.x
WhatsApp API Messaging Platform Cloud API
Google Cloud AI Services Latest

Core Dependencies

{
  "express": "^5.1.0",
  "axios": "^1.11.0",
  "dotenv": "^17.2.1",
  "mime-types": "^3.0.1"

}

⚑ Quick Start

Prerequisites

  • Node.js 18+ installed
  • WhatsApp Business API access
  • Google Cloud credentials
  • Environment variables configured

Installation

# Clone the repository
git clone https://github.com/Satya-Shield/Whatsapp-Bot.git
cd Whatsapp-Bot

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your configuration

# Build the API
npm run build

# Start the server
npm start

Environment Variables

PORT=3000
WHATSAPP_VERIFY_TOKEN=your-verify-token
WHATSAPP_API_VERSION=v22.0
WHATSAPP_PHONE_NUMBER_ID=your-business-whatsapp-phone-number-id
WHATSAPP_ACCESS_TOKEN=your-whatsapp-token

🌟 Why SatyaShield WhatsApp Bot?

πŸš€ Advantage πŸ“Š Impact
Instant Access No app downloads needed - works directly in WhatsApp
Mass Reach 400M+ WhatsApp users in India can access instantly
Educational Not just verification - explains why content is misleading
Multilingual Supports regional languages for broader accessibility
Always Available 24/7 fact-checking service

πŸ”— SatyaShield Ecosystem

Explore our complete misinformation-fighting toolkit:

Website Browser Extension API Backend


πŸ“ž Get Started

πŸ“± Send a message to get started:

Try sending: "Is this news true?" along with any suspicious content


🀝 Contributing

We welcome contributions! Please check our Contributing Guidelines and feel free to submit issues or pull requests.

Development Setup

# Fork the repository
# Clone your fork
git clone https://github.com/YOUR_USERNAME/Whatsapp-Bot.git

# Create a feature branch
git checkout -b feature/your-feature-name

# Make your changes and commit
git commit -m "Add your amazing feature"

# Push and create a pull request
git push origin feature/your-feature-name

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ™ Acknowledgments

  • Meta for WhatsApp Cloud API
  • Google Cloud for AI services
  • Open-source community for incredible tools
  • Contributors who make this project possible

πŸ’‘ Built with ❀️ for a misinformation-free digital India

⭐ Star this repo | πŸ› Report Bug | ✨ Request Feature


Part of the SatyaShield ecosystem - Empowering digital literacy through AI

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published