REST API Completa para WhatsApp

Baileys PRO es una API REST construida sobre la librería baileys-pro, una versión extendida e independiente de Baileys con funcionalidades exclusivas no disponibles en la versión oficial. Multi-dispositivo, multi-sesión y con dashboard integrado.

138
Endpoints
10
Módulos
Multi
Sesiones
QR
+ Pairing Code
WH
Webhooks

Funcionalidades Principales

Toda la potencia de WhatsApp Web expuesta como API REST, con funcionalidades exclusivas de baileys-pro.

Alta Performance

Comunicación directa por WebSocket con los servidores de WhatsApp usando el motor baileys-pro, optimizado para velocidad y estabilidad.

Multi-Sesión

Gestiona múltiples cuentas de WhatsApp de forma simultánea. Cada instancia tiene su token, webhook y sesión independiente.

Mensajes Ricos

Envía texto, imágenes, audio, documentos, videos, stickers, ubicación, contactos, encuestas, álbumes, botones, listas, mensajes interactivos y más.

Webhooks en Tiempo Real

Recibe eventos de mensajes, presencia, llamadas, actualizaciones de grupos y más mediante tu URL de webhook configurable por instancia.

Privacidad Completa

Controla configuración de privacidad: última vez, estado online, foto de perfil, confirmaciones de lectura, quién puede agregarte a grupos y llamadas.

Gestión de Grupos

Crea grupos, administra participantes, configura permisos, links de invitación (V4), aprobación de solicitudes, modo de adición y mensajes efímeros.

Newsletters / Canales

Crea y gestiona canales de WhatsApp. Seguir, mutear, reaccionar, administrar admins, obtener mensajes y actualizaciones del canal.

WhatsApp Business

Accede a pedidos, catálogos, colecciones y productos. Envía mensajes de producto, catálogo completo y storefront directamente.

Dashboard Admin

Panel de control web completo: crea instancias, escanea QR, configura webhooks, envía mensajes de prueba y monitorea el estado.

Características Exclusivas PRO

Funcionalidades disponibles únicamente en baileys-pro — no presentes en la versión oficial de Baileys.

Álbum de Medios

Envía múltiples imágenes o videos en un solo álbum nativo de WhatsApp con sendAlbumMessage. Mezcla imágenes y videos en el mismo álbum.

Status Mentions

Menciona contactos en estados de WhatsApp con sendStatusMentions. Soporta mención a grupos y chats privados en el mismo mensaje.

Gestión de Llamadas

Inicia (offerCall) y rechaza (rejectCall) llamadas de voz y video. Controla llamadas desde la API.

Mensajes de Evento

Crea y envía mensajes tipo evento con nombre, descripción, ubicación, fecha/hora y link de invitación.

Solicitud de Pago

Envía solicitudes de pago con soporte de sticker como medio adjunto, ya sea buffer, URL o vacío.

Resultado de Encuesta

Envía resultados de encuestas con opciones de respuesta procedentes de un Newsletter, usando sendPollResult.

LID de Contacto

Obtén el LID (identificador alternativo de WhatsApp) de cualquier número usando USync — tecnología del sistema multi-dispositivo.

Custom Pairing Code

Conecta sin QR usando un código de emparejamiento personalizado de 8 caracteres alfanuméricos definido por el usuario.

Endpoints de la API

138 endpoints organizados en 10 módulos. Todos con autenticación por token. Ver documentación completa en /docs.

Session

Gestión de sesión WhatsApp.

  • Conectar, desconectar, logout
  • Estado de sesión y QR en tiempo real
  • Par por teléfono (Pairing Code)
  • Rechazar llamada entrante

Chat – Mensajes

Envío de todo tipo de mensajes.

  • Texto, imagen, video, audio, documento
  • Sticker, ubicación, contacto, encuesta
  • Álbum, Forward, Botones, Lista, Carrusel
  • Interactivo, Respuesta interactiva

Chat – Acciones

Gestión de chats y mensajes.

  • Archivar, silenciar, fijar chat
  • Marcar leído / no leído
  • Reaccionar, editar, eliminar
  • Fijar mensaje, destacar (star)
  • Mensajes efímeros, presencia

Chat – Descargas

Descarga de medios recibidos.

  • Descargar imagen recibida
  • Descargar video recibido
  • Descargar audio recibido
  • Descargar documento recibido

Chat – Baileys PRO

Exclusivo de baileys-pro.

  • Broadcast / Difusión
  • Status Mentions
  • Álbum automático de medios
  • Evento, Solicitud de pago
  • Resultado de encuesta

User

Información y gestión de usuarios.

  • Verificar si existe en WhatsApp
  • Info, avatar, estado (status)
  • Presencia y suscripción a presencia
  • Bloquear / desbloquear / lista
  • LID, historial, re-upload media
  • Guardar / eliminar contacto
  • Labels en chats y mensajes
  • Llamadas: ofrecer y rechazar
  • Historial remoto de mensajes

Groups

Administración completa de grupos.

  • Crear, listar, info, invitación
  • Agregar / quitar / promover / degradar
  • Revocar y obtener links (V4)
  • Solicitudes de unión, aprobación
  • Nombre, tema, foto, ephemeral
  • Anuncio, bloqueado, modo adición
  • Unirse por link, acceptInviteV4

Newsletter

Canales de WhatsApp.

  • Crear, eliminar, seguir, mutear
  • Suscribir, reaccionar, modo reacción
  • Obtener mensajes y actualizaciones
  • Editar nombre, descripción, foto
  • Administrar admins, promover/degradar
  • Conteo de admins, cambiar owner

Privacy & Profile

Privacidad y perfil del usuario.

  • Última vez, online, foto, estado
  • Confirmaciones de lectura
  • Quién puede agregar a grupos
  • Privacidad de llamadas y mensajes
  • Modo efímero predeterminado
  • Actualizar nombre, estado, foto

Business

WhatsApp Business API.

  • Consultar pedidos (orders)
  • Catálogo completo y colecciones
  • Crear / actualizar / eliminar productos
  • Enviar producto, catálogo, storefront

Webhook

Configuración por instancia.

  • Obtener, crear, actualizar, eliminar webhook
  • Filtro de eventos por tipo
  • Recibe: mensajes, presencia, grupos, llamadas y más

Admin

Gestión de instancias (solo admin).

  • Listar, crear, editar, eliminar usuarios
  • Eliminar usuario + sesión completa
  • Autenticación por token de administrador

Inicio Rápido

Comienza a usar Baileys PRO en minutos.

Instalación

cd baileys-api
npm install
cp .env.sample .env
# Edita .env con tu token admin y puerto

Iniciar

npm start
# o con PM2:
pm2 start src/server.js --name baileys-pro

Crear Instancia

curl -X POST http://localhost:8080/admin/users \
  -H "Authorization: tu_admin_token" \
  -H "Content-Type: application/json" \
  -d '{"name":"MiInstancia","token":"mitoken123"}'

Conectar WhatsApp

# QR Code
curl -X POST http://localhost:8080/session/connect \
  -H "Token: mitoken123"

# o con Pairing Code
curl -X POST http://localhost:8080/session/pairphone \
  -H "Token: mitoken123" \
  -d '{"Phone":"15551234567"}'

Enviar Mensaje

curl -X POST http://localhost:8080/chat/send/text \
  -H "Token: mitoken123" \
  -H "Content-Type: application/json" \
  -d '{"Phone":"15551234567","Body":"Hola desde Baileys PRO!"}'

Dashboard Web

Abre /dashboard en tu navegador para gestionar instancias, escanear QR, configurar webhooks y probar todos los endpoints de forma visual.