https://github.com/engdalevedove/whatsapp-api-base

API robusta para automação WhatsApp com envio de texto, imagens, vídeos e documentos. Inclui cliente Python e PM2 para produção.
https://github.com/engdalevedove/whatsapp-api-base

api automation bot bulk-messaging express messaging nodejs python whatsapp

Last synced: 3 months ago
JSON representation

API robusta para automação WhatsApp com envio de texto, imagens, vídeos e documentos. Inclui cliente Python e PM2 para produção.

• Host: GitHub
• URL: https://github.com/engdalevedove/whatsapp-api-base
• Owner: engdalevedove
• License: mit
• Created: 2025-09-20T12:40:27.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-09-30T23:34:28.000Z (9 months ago)
• Last Synced: 2025-10-10T14:52:06.833Z (9 months ago)
• Topics: api, automation, bot, bulk-messaging, express, messaging, nodejs, python, whatsapp
• Language: JavaScript
• Homepage:
• Size: 12.7 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![GitHub release](https://img.shields.io/github/v/release/engdalevedove/whatsapp-api-base)

![License](https://img.shields.io/github/license/engdalevedove/whatsapp-api-base)

![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)

![Python](https://img.shields.io/badge/python-%3E%3D3.8-blue)

# WhatsApp API Base - Sistema de Envio Automatizado

## Sobre o Projeto

API robusta para automação de envios via WhatsApp Web, desenvolvida para ambiente corporativo. Permite envio de mensagens de texto, imagens, vídeos e documentos tanto para contatos individuais quanto grupos, incluindo funcionalidade de envio em massa.

### Principais Funcionalidades

- **Envio de Mensagens de Texto** - Para grupos e contatos individuais

- **Envio de Mídias** - Imagens, vídeos e documentos

- **Envio em Massa** - Com delay configurável entre mensagens

- **Personalização de Mensagens** - Substituição automática de nomes

- **API REST Completa** - Endpoints para todas as funcionalidades

- **Biblioteca Python** - Cliente para integração fácil

- **Serviço Permanente** - Configuração como serviço Windows com PM2

- **Logs Detalhados** - Rastreamento completo de envios

- **Interface Web** - Painel de status e monitoramento

## Tecnologias Utilizadas

- **Node.js** - Runtime JavaScript

- **Express.js** - Framework web

- **whatsapp-web.js** - Biblioteca para WhatsApp Web

- **Python** - Cliente e scripts de automação

- **PM2** - Gerenciamento de processos

- **QRCode Terminal** - Autenticação visual

## Estrutura do Projeto

WhatsApp-API-Base/

├── whatsapp-api-base.js      # API principal Node.js

├── whatsapp_base.py          # Cliente Python

├── envio_massa.py            # Script de envio em massa

├── envio_csv_direto.py       # Script para CSV

├── start-api-shared.bat      # Script de inicialização

├── package.json              # Dependências Node.js

├── DOCUMENTATION.md          # Documentação completa

└── docs/                     # Documentação adicional

## Instalação Rápida

### Pré-requisitos

- Node.js v18+ 

- Python 3.8+

- PM2 (para serviço permanente)

### 1. Clone o repositório

```bash

git clone https://github.com/engdalevedove/whatsapp-api-base.git

cd whatsapp-api-base