whatsapp-ai-agent

# 🤖 WhatsApp AI Chatbot

<div align="center">
  <img src="https://img.shields.io/badge/Node.js-18+-green?style=for-the-badge&logo=node.js" alt="Node.js 18+">
  <img src="https://img.shields.io/badge/TypeScript-5.2-blue?style=for-the-badge&logo=typescript" alt="TypeScript">
  <img src="https://img.shields.io/badge/WhatsApp-Baileys-green?style=for-the-badge&logo=whatsapp" alt="WhatsApp Baileys">
  <img src="https://img.shields.io/badge/AI-Gemini%20%7C%20OpenAI-orange?style=for-the-badge&logo=google" alt="AI Gemini/OpenAI">
  <img src="https://img.shields.io/badge/WebSocket-Real-time-blue?style=for-the-badge&logo=websocket" alt="WebSocket Real-time">
</div>

<div align="center">
  <img src="presentation-image-small.png" alt="WhatsApp AI Chatbot Preview" width="800">
  
  ### 🚀 **Intelligent WhatsApp AI Assistant**
  
  *Powered by Gemini & OpenAI • Real-time Messaging • Context-Aware Responses*
</div>

---

A sophisticated WhatsApp AI chatbot built with Node.js, TypeScript, and OpenAI or Gemini (Google AI). This chatbot automatically responds to WhatsApp messages using AI-powered conversations with context awareness and real-time WebSocket communication.

## ✨ Features

- **🤖 AI-Powered Responses**: Uses OpenAI GPT or Gemini Pro for intelligent conversations
- **📱 WhatsApp Integration**: Connects via Baileys library for WhatsApp Web
- **💬 Chat History Management**: Maintains conversation context for better responses
- **🌐 Real-time WebSocket**: Live status updates and message monitoring
- **⚡ Auto-Reply**: Instant responses to incoming messages
- **🔧 Configurable**: Easy environment-based configuration
- **📊 Logging**: Comprehensive logging with Winston
- **🧪 Testing**: Jest testing framework included
- **🎯 TypeScript**: Full type safety and modern development experience
- **🔄 Provider Switch**: Easily switch between OpenAI and Gemini as your AI backend

## 🚀 Quick Start

### Prerequisites

- Node.js 18+ 
- npm or yarn
- OpenAI or Claude API key
- WhatsApp