https://github.com/douglasvolcato/whatsapp-automation-agent

The WhatsApp Automation Agent combines AI language models, web automation, and a robust dashboard to create a flexible automation platform for WhatsApp interactions.
https://github.com/douglasvolcato/whatsapp-automation-agent

bcrypt chatbot chatgpt ejs express jsonwebtoken jwt langchain langchain-js nodejs observability ollama postgresql primereact prometheus react swagger typescript whatsapp whatsapp-bot

Last synced: 3 months ago
JSON representation

The WhatsApp Automation Agent combines AI language models, web automation, and a robust dashboard to create a flexible automation platform for WhatsApp interactions.

• Host: GitHub
• URL: https://github.com/douglasvolcato/whatsapp-automation-agent
• Owner: DouglasVolcato
• Created: 2025-06-11T04:10:09.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-07-01T03:04:57.000Z (4 months ago)
• Last Synced: 2025-07-01T03:34:35.162Z (4 months ago)
• Topics: bcrypt, chatbot, chatgpt, ejs, express, jsonwebtoken, jwt, langchain, langchain-js, nodejs, observability, ollama, postgresql, primereact, prometheus, react, swagger, typescript, whatsapp, whatsapp-bot
• Language: TypeScript
• Homepage:
• Size: 2.32 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🤖 WhatsApp Automation Agent

> Automate WhatsApp workflows using an LLM-powered agent that understands your domain and business needs.

[![GitHub repo](https://img.shields.io/badge/GitHub-DouglasVolcato/whatsapp--automation--agent-blue?logo=github)](https://github.com/DouglasVolcato/whatsapp-automation-agent)

[![Node.js](https://img.shields.io/badge/Node.js-24.x-green?logo=node.js)](https://nodejs.org/)

[![Postgres](https://img.shields.io/badge/Postgres-17-blue?logo=postgresql)](https://www.postgresql.org/)

[![License](https://img.shields.io/github/license/DouglasVolcato/whatsapp-automation-agent)](LICENSE)

---

## 📦 Project Overview

The WhatsApp Automation Agent combines **AI language models**, **web automation**, and a robust **dashboard** to create a flexible automation platform for WhatsApp interactions.

Features:

- Automate conversations and workflows

- Manage users and sessions via a secure admin dashboard

- Observe system metrics and performance

- Integrate LLM agents and tools tailored to your domain

---

## 🧭 Table of Contents

- [🧭 Table of Contents](#-table-of-contents)

- [📸 App Screenshots](#-app-screenshots)

- [🧩 Architecture Diagrams](#-architecture-diagrams)

- [⚙️ Project Structure](#️-project-structure)

- [🚀 Technologies & Tools](#-technologies--tools)

- [📦 Installation](#-installation)

- [📄 License](#-license)

---

## 📸 App Screenshots

| Login                | Dashboard Session       | Manage Users                |

| -------------------- | ---------------------- | --------------------------- |

| ![](docs/prints/admin_login.png) | ![](docs/prints/dashboard_session.png) | ![](docs/prints/manage_users_session.png) |

| LLM Chat             | Metrics Collection     | API Documentation (Swagger) |

| -------------------- | ---------------------- | --------------------------- |

| ![](docs/prints/llm_chat.png) | ![](docs/prints/metrics_collection.png) | ![](docs/prints/swagger.png) |

---

## 🧩 Architecture Diagrams

| Application Architecture | Database Design |

| ----------------------- | ---------------- |

| ![](docs/diagrams/app.png) | ![](docs/diagrams/db.png) |

---

## ⚙️ Project Structure

```plaintext

docker-compose.yml

.env.example

app

├─ db                 # SQL migrations

├─ dist               # Compiled backend

├─ logs               # Logs

├─ src

│  ├─ domain

│  │  ├─ abstract

│  │  ├─ controllers

│  │  ├─ middlewares

│  │  ├─ usecases

│  │  └─ utils

│  ├─ ia

│  │  ├─ abstract

│  │  ├─ agents

│  │  └─ tools

│  ├─ infra

│  │  ├─ database

│  │  └─ repositories

│  └─ main

│     ├─ abstract

│     ├─ factories

│     ├─ routes

│     ├─ utils

│     └─ index.ts

├─ public

│  ├─ views            # EJS templates

│  ├─ files            # Static files

│  └─ client           # React frontend

│     ├─ dist

│     ├─ public

│     └─ src

│        ├─ app

│        ├─ components

│        ├─ config

│        ├─ contexts

│        ├─ decorators

│        ├─ enums

│        ├─ hooks

│        ├─ stores

│        └─ utils

│     └─ main.tsx

````

---

## 🚀 Technologies & Tools

### 🖥 Backend

* **Node.js** & **TypeScript**: main runtime and language

* **dotenv**: environment config

* **node-cron**: task scheduling

### 🔐 Cryptography & Auth

* **bcryptjs**: password hashing

* **jsonwebtoken**: token-based authentication

### 🛡️ Security

* **helmet**: security headers

* **express-rate-limit**: rate limiting

### 🧾 Documentation

* **Swagger**: API documentation

* **Draw\.io**: architecture diagrams

### 🗄 Database

* **Postgres**: relational database

* **SQL optimization**: performance tuning

### 📊 Observability

* **Prometheus**: metrics collection & monitoring

### 🤖 WhatsApp Automation

* **puppeteer**: headless browser control

* **whatsapp-web.js**: WhatsApp web automation

### 🧠 LLM Integration

* **LangChain**: tool orchestration

* **Ollama**, **ChatGPT**: language models

* **zod**: validation & tool format definition

### 🌐 Frontend

* **React**: SPA dashboard

* **PrimeReact**, **PrimeIcons**, **PrimeFlex**: UI toolkit

* **Chart.js**: data visualization

* **Zustand**: state management

* **Axios**: API communication

* **EJS**: server-rendered templates

* **Static files**: public content

---

## 📦 Installation

```bash

# Clone the repository

git clone https://github.com/DouglasVolcato/whatsapp-automation-agent.git

cd whatsapp-automation-agent

# Copy environment variables template

cp .env.example .env

# Build & run using Docker

docker compose up --build

# Access

# - Server: http://localhost:PORT

# - Client: http://localhost:PORT/client

# - Docs: http://localhost:PORT/docs

```

> 🧪 Note: Ensure Docker & Docker Compose are installed.

---

## Author

* **Douglas Volcato**: [GitHub](https://github.com/DouglasVolcato)