Acerca de

Un cliente API de WhatsApp que se conecta a través de la aplicación del navegador web de WhatsApp

La biblioteca funciona iniciando la aplicación de navegador web de WhatsApp y administrándola mediante Puppeteer para crear una instancia de WhatsApp Web, mitigando así el riesgo de ser bloqueado. El cliente API de WhatsApp se conecta a través de la aplicación del navegador web de WhatsApp, accediendo a sus funciones internas. Esto le otorga acceso a casi todas las funciones disponibles en WhatsApp Web, lo que permite un manejo dinámico similar a cualquier otra aplicación Node.js.

Importante

No se garantiza que no será bloqueado al utilizar este método. WhatsApp no permite bots ni clientes no oficiales en su plataforma, por lo que esto no debe considerarse totalmente seguro.

Campo de golf

Sitio web
Guía (fuente) (trabajo en progreso)
Documentación (fuente)
Discordia WWebJS
GitHub
npm

Instalación

¡El módulo ya está disponible en npm! npm i whatsapp-web.js

Nota

Se requiere el nodo v18+ .

PASOS RÁPIDOS PARA ACTUALIZAR EL NODO

ventanas

Manual

Simplemente obtenga la última versión de LTS del sitio web oficial del nodo.

npm

sudo npm install - g n
sudo n stable

Chocó

choco install nodejs - lts

ala

winget install OpenJS.NodeJS.LTS

Ubuntu/Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && 
sudo apt-get install -y nodejs

Uso de ejemplo

 const { Client } = require ( 'whatsapp-web.js' ) ;

const client = new Client ( ) ;

client . on ( 'qr' , ( qr ) => {
    // Generate and scan this code with your phone
    console . log ( 'QR RECEIVED' , qr ) ;
} ) ;

client . on ( 'ready' , ( ) => {
    console . log ( 'Client is ready!' ) ;
} ) ;

client . on ( 'message' , msg => {
    if ( msg . body == '!ping' ) {
        msg . reply ( 'pong' ) ;
    }
} ) ;

client . initialize ( ) ;

Eche un vistazo a example.js para ver otros ejemplos con casos de uso adicionales.
Para obtener más detalles sobre cómo guardar y restaurar sesiones, explore las estrategias de autenticación proporcionadas.

Funciones compatibles

Característica	Estado
Dispositivo múltiple	✅
enviar mensajes	✅
Recibir mensajes	✅
Enviar medios (imágenes/audio/documentos)	✅
Enviar medios (vídeo)	✅ (requiere Google Chrome)
Enviar pegatinas	✅
Recibir medios (imágenes/audio/video/documentos)	✅
enviar tarjetas de contacto	✅
Enviar ubicación	✅
Enviar botones	❌ (OBSECUTIVO)
Enviar listas	❌ (OBSECUTIVO)
Recibir ubicación	✅
Respuestas de mensajes	✅
Unirse a grupos por invitación	✅
Obtener invitación para grupo	✅
Modificar información del grupo (asunto, descripción)	✅
Modificar la configuración del grupo (enviar mensajes, editar información)	✅
Agregar participantes al grupo	✅
Participantes del grupo de patadas	✅
Promocionar/degradar a los participantes del grupo	✅
Mencionar usuarios	✅
Mencionar grupos	✅
Silenciar/activar chats	✅
Bloquear/desbloquear contactos	✅
Obtener información de contacto	✅
Obtener fotos de perfil	✅
Establecer mensaje de estado de usuario	✅
Reaccionar a los mensajes	✅
Crear encuestas	✅
Votar en las encuestas
Comunidades
Canales

¿Falta algo? ¡Haga un problema y háganoslo saber!

Contribuyendo

No dudes en abrir solicitudes de extracción; ¡Agradecemos las contribuciones! Sin embargo, para cambios significativos, es mejor abrir una incidencia de antemano. Asegúrese de revisar nuestras pautas de contribución antes de crear una solicitud de extracción. Antes de crear su propio problema o solicitud de extracción, verifique siempre si ya existe uno.

Apoyando el proyecto

Puede apoyar al mantenedor de este proyecto a través de los enlaces a continuación

Soporte a través de patrocinadores de GitHub
Soporte a través de PayPal
Regístrese en DigitalOcean y obtenga $200 en crédito cuando se registre (Recomendación)

Descargo de responsabilidad

Este proyecto no está afiliado, asociado, autorizado, respaldado ni conectado oficialmente de ninguna manera con WhatsApp o cualquiera de sus subsidiarias o sus afiliados. El sitio web oficial de WhatsApp se puede encontrar en whatsapp.com. "WhatsApp", así como los nombres, marcas, emblemas e imágenes relacionados, son marcas comerciales registradas de sus respectivos propietarios. Además, no se garantiza que no será bloqueado al utilizar este método. WhatsApp no permite bots ni clientes no oficiales en su plataforma, por lo que esto no debe considerarse totalmente seguro.

Licencia

Licenciado bajo la Licencia Apache, Versión 2.0 (la "Licencia");
No puede utilizar este proyecto excepto de conformidad con la Licencia.
Puede obtener una copia de la Licencia en http://www.apache.org/licenses/LICENSE-2.0.

A menos que lo exija la ley aplicable o se acuerde por escrito, el software
distribuido bajo la Licencia se distribuye "TAL CUAL",
SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas.
Consulte la Licencia para conocer el idioma específico que rige los permisos y
limitaciones bajo la Licencia.

Expandir

Información adicional