WhatsApp Bot — Panel

Estado WhatsApp

—

Puerto API

—

Usuarios Admin

—

Inicio rápido

1

Conectar WA

2

Escanear QR

3

Usar API

Tu bot envía mensajes de WhatsApp vía REST API con autenticación Bearer Token. Visita Dispositivo para conectar y API Docs para ver ejemplos.

Endpoints disponibles

Método	Ruta	Descripción
POST	`/api/send-text`	Enviar texto
POST	`/api/send-image`	Enviar imagen (URL o base64)
POST	`/api/send-video`	Enviar video (URL o base64)
POST	`/api/send-document`	Enviar documento (URL o base64)

Control de sesión

Gestiona la sesión de WhatsApp Web. Al desconectar se elimina la sesión y deberás escanear el QR de nuevo.

Código QR

📲 El QR aparece aquí
al conectar

Abre WhatsApp en tu teléfono → Dispositivos vinculados → Vincular un dispositivo

Configuración del servidor

Puerto API

Bearer Token (API)

⚠️ Cambiar el puerto requiere reiniciar el servidor.

Usuarios administradores

ID	Usuario	Rol	Creado	Acciones

Texto

Imagen

Video

Documento

Autenticación

POST /api/send-text

Envía un mensaje de texto plano a un número de WhatsApp.

Body (JSON)

              
// Body
{
  "numero": "521234567890",   // sin + ni espacios
  "mensaje": "Hola desde la API 👋"
}

cURL

              
curl -X POST http://localhost:3000/api/send-text \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"numero":"521234567890","mensaje":"Hola 👋"}'

Node.js (axios)

              
const axios = require('axios');
await axios.post('http://localhost:3000/api/send-text', {
  numero: '521234567890',
  mensaje: 'Hola desde Node 👋'
}, {
  headers: { Authorization: 'Bearer TU_TOKEN' }
});

Python (requests)

              
import requests
requests.post('http://localhost:3000/api/send-text',
  json={'numero': '521234567890', 'mensaje': 'Hola 👋'},
  headers={'Authorization': 'Bearer TU_TOKEN'})

Respuesta exitosa

{ "ok": true, "message": "mensaje enviado" }

POST /api/send-image

Envía una imagen por URL o base64 con caption opcional.

Por URL

              
{
  "numero": "521234567890",
  "imagen": "https://ejemplo.com/foto.jpg",
  "mensaje": "Mira esta imagen 📸"
}

Por Base64

              
{
  "numero": "521234567890",
  "base64": "data:image/jpeg;base64,/9j/4AAQ...",
  "mensaje": "Imagen en base64 📸"
}

cURL

              
curl -X POST http://localhost:3000/api/send-image \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"numero":"521234567890","imagen":"https://picsum.photos/400","mensaje":"Foto!"}'

POST /api/send-video

Envía un video por URL o base64.

Por URL

              
{
  "numero": "521234567890",
  "video": "https://ejemplo.com/video.mp4",
  "mensaje": "Mira este video 🎬"
}

Por Base64

              
{
  "numero": "521234567890",
  "base64": "AAAAIG...",
  "mensaje": "Video en base64 🎬"
}

POST /api/send-document

Envía cualquier tipo de archivo (PDF, Excel, Word, etc.).

Por URL (PDF)

              
{
  "numero": "521234567890",
  "documento": "https://ejemplo.com/reporte.pdf",
  "nombre": "reporte-enero.pdf",
  "mimetype": "application/pdf",
  "mensaje": "Tu reporte mensual 📄"
}

Por Base64

              
{
  "numero": "521234567890",
  "base64": "JVBERi0...",
  "nombre": "factura.pdf",
  "mimetype": "application/pdf",
  "mensaje": "Tu factura 🧾"
}

MIME types comunes

PDF     → application/pdf
Excel   → application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Word    → application/vnd.openxmlformats-officedocument.wordprocessingml.document
ZIP     → application/zip
Genérico→ application/octet-stream

Autenticación

Todos los endpoints de la API requieren un Bearer Token en el header Authorization. Configura tu token en la sección Configuración.

Header requerido

Authorization: Bearer TU_TOKEN_AQUI

Respuesta si el token es inválido

HTTP 403 Forbidden
{ "ok": false, "error": "Token inválido" }

Respuesta si falta el token

HTTP 401 Unauthorized
{ "ok": false, "error": "Token requerido" }