About WhatsApp-AI-Job-Assistant-Bot

WorqNow – AI-Powered Job Search Assistant for WhatsApp A clean open-source demo of a WhatsApp job assistant that searches jobs via multiple APIs, understands natural language queries, and generates professional CVs using HTML → PDF

i

Published by

ibrahimpelumi6142

Visit View Profile

README.md

View on GitHub

📱 WorqNow – WhatsApp AI Job Assistant (Public Demo)

A clean public demo of a WhatsApp-based AI Job Assistant built using FastAPI.
This demo showcases:

WhatsApp webhook handling
Intent recognition
Job search example (mocked)
CV builder example (mocked)
Structured conversation flow
Clean single-file architecture

⚠️ NOTE:
This is a safe demo version. The real production WorqNow bot contains:

Real job APIs (Remotive / JSearch)
MongoDB user storage
PDF CV generator
WhatsApp media uploads
Daily alerts scheduler
Advanced NLU + fuzzy matching
Onboarding & subscription engine
User preference tracking
Business logic

Those features are intentionally removed from this public demo.

✨ Features (Demo Version)

🔗 WhatsApp Webhook Receiver
🧠 Simple Intent Detection
🔍 Mock Job Search Flow
📝 Mock CV Builder (Q&A Flow)
💬 Typing Indicator (simulated)
🗂 Clean Structure
⚡ FastAPI Backend
🛡 Safe and GitHub-friendly

🗂 Project Structure

worqnow-demo/
│
├── main.py               # Full demo logic (single file)
├── README.md             # Project documentation
├── .env.example          # Demo verify token
├── module/
|   └── university-advisor # Various university details for students that want to study more
|
├── sample_payloads/
│   ├── incoming_message.json
│   └── status_update.json
│
└── templates/
    └── cv_demo.html      # Minimal CV layout (demo)

🚀 Getting Started

1️⃣ Clone the Repository

git clone https://github.com/<your-username>/worqnow-demo
cd worqnow-demo

2️⃣ Install Dependencies

pip install fastapi uvicorn python-multipart

(No databases or external APIs needed for this demo.)

🔧 Environment Setup

Create your .env file:

cp .env.example .env

.env content:

VERIFY_TOKEN=DEMO_TOKEN

Used only for webhook verification.

▶️ Run the Server

uvicorn main:app --reload --port=8000

Visit:

http://localhost:8000/webhook?hub.verify_token=DEMO_TOKEN&hub.challenge=123

If everything works, you’ll see:

🧪 Testing Incoming Messages

Send this JSON using Postman/curl:

{
  "entry": [{
    "changes": [{
      "value": {
        "messages": [{
          "from": "234801000000",
          "text": { "body": "search frontend jobs" }
        }]
      }
    }]
  }]
}

Your terminal will print the simulated job results.

🎯 Supported Demo Commands

Command	What It Does
search UI/UX	Returns mock job listings
create cv	Starts CV builder demo
profile	Shows demo profile
help	Shows available demo commands
feedback	Records mock feedback

🧩 Additional Demo Files

`templates/cv_demo.html`

A minimal HTML CV layout (demo only).

`sample_payloads/`

Realistic WhatsApp payloads for learning how Webhooks work.

🏆 Purpose of This Demo

This repository is designed to:

Demonstrate WhatsApp automation with FastAPI
Serve as a safe open-source portfolio project
Show my architecture skills
Help others learn how WhatsApp Cloud API works

The real production WorqNow bot remains private.

📝 License

MIT License — free to use, modify, and learn from.

WhatsApp-AI-Job-Assistant-Bot