Logotipo de Sila

Sila

Sulla es una biblioteca de JavaScript que proporciona un control API de alto nivel para Whatsapp, por lo que puede configurarse para automatizar las respuestas o cualquier dato que pase por Whatsapp sin esfuerzo.
Está construido usando titiritero.

Estado de Sila

A partir de la versión 2.3.5 parece que sulla ha alcanzado una funcionalidad y arquitectura muy rica y estable. Por mucho que me encantaría, no puedo dedicar mucho tiempo a este proyecto, así que considere consultar las versiones bifurcadas de sulla donde otros desarrolladores pueden dedicarle más tiempo y soporte.

Proyectos recomendados basados en sulla que cuentan con apoyo activo:

veneno

conexión wpp

open-wa/wa-automatizar

Instalación

 > npm i sulla --save

Empezando

 // Supports ES6
// import { create, Whatsapp } from 'sulla';
const sulla = require ( 'sulla' ) ;

sulla . create ( ) . then ( ( client ) => start ( client ) ) ;

function start ( client ) {
  client . onMessage ( ( message ) => {
    if ( message . body === 'Hi' ) {
      client . sendText ( message . from , ' Hello from sulla!' ) ;
    }
  } ) ;
}

Después de ejecutar la función `create()` , sulla creará una instancia de whatsapp web. Si no ha iniciado sesión, se imprimirá un código QR en el terminal. ¡Escanéalo con tu teléfono y estarás listo para comenzar!

Sila recordará la sesión, por lo que no será necesario autenticarse cada vez.

Se pueden crear varias sesiones al mismo tiempo pasando un nombre de sesión a la función `create()` :

 // Init sales whatsapp bot
sulla . create ( 'sales' ) . then ( ( salesClient ) => { ... } ) ;

// Init support whatsapp bot
sulla . create ( 'support' ) . then ( ( supportClient ) => { ... } ) ;

Parámetros de creación opcionales

El tercer parámetro del método Sulla create() puede tener los siguientes parámetros opcionales:

 create ( 'sessionName' , qrCallback , {
  headless : true , // Headless chrome
  devtools : false , // Open devtools by default
  useChrome : true , // If false will use Chromium instance
  debug : false , // Opens a debug session
  logQR : true // Logs QR automatically in terminal
  browserArgs : [ '' ] // Parameters to be added into the chrome browser instance
  refreshQR : 15000 , // Will refresh QR every 15 seconds, 0 will load QR once. Default is 30 seconds
} ) ;

La definición de tipo se puede encontrar aquí: CreateConfig.ts

Exportar código QR

Por defecto aparecerá el código QR en el terminal. Si necesitas pasar el QR en otro lugar, aquí tienes cómo:

 const fs = require ( 'fs' ) ;

// Second create() parameter is the QR callback
sulla . create ( 'session-marketing' , ( base64Qr , asciiQR ) => {
  // To log the QR in the terminal
  console . log ( asciiQR ) ;

  // To write it somewhere else in a file
  exportQR ( base64Qr , 'marketing-qr.png' ) ;
} ) ;

// Writes QR in specified path
function exportQR ( qrCode , path ) {
  qrCode = qrCode . replace ( 'data:image/png;base64,' , '' ) ;
  const imageBuffer = Buffer . from ( qrCode , 'base64' ) ;

  // Creates 'marketing-qr.png' file
  fs . writeFileSync ( path , imageBuffer ) ;
}

Descargando archivos

Puppeteer se encarga de la descarga del archivo. El descifrado se realiza lo más rápido posible (supera a los métodos nativos). ¡Admite archivos grandes!

 import fs = require ( 'fs' ) ;
import mime = require ( 'mime-types' ) ;

client . onMessage ( async ( message ) => {
  if ( message . isMedia ) {
    const buffer = await client . downloadFile ( message ) ;
    // At this point you can do whatever you want with the buffer
    // Most likely you want to write it into a file
    const fileName = `some-file-name. ${ mime . extension ( message . mimetype ) } ` ;
    fs . writeFile ( fileName , buffer , function ( err ) {
      ...
    } ) ;
  }
} ) ;

Funciones básicas (uso)

No se enumeran todas las funciones disponibles; para verlas más detalladamente, todas las funciones disponibles se pueden encontrar aquí y aquí.

Charlando

Aquí, `chatId` podría ser `@c.us` o `-@c.us`

 // Send basic text
await client . sendText ( chatId , ' Hello from sulla!' ) ;

// Send image
await client . sendImage (
  chatId ,
  'path/to/img.jpg' ,
  'image-name.jpg' ,
  'Caption text'
) ;

// Send @tagged message
await client . sendMentioned ( chatId , 'Hello @5218113130740 and @5218243160777!' , [
  '5218113130740' ,
  '5218243160777' ,
] ) ;

// Reply to a message
await client . reply ( chatId , 'This is a reply!' , message . id . toString ( ) ) ;

// Send file (sulla will take care of mime types, just need the path)
await client . sendFile ( chatId , 'path/to/file.pdf' , 'cv.pdf' , 'Curriculum' ) ;

// Send gif
await client . sendVideoAsGif (
  chatId ,
  'path/to/video.mp4' ,
  'video.gif' ,
  'Gif image file'
) ;

// Send contact
// contactId: [email protected]
await client . sendContact ( chatId , contactId ) ;

// Forwards messages
await client . forwardMessages ( chatId , [ message . id . toString ( ) ] , true ) ;

// Send sticker
await client . sendImageAsSticker ( chatId , 'path/to/image.jpg' ) ;

// Send location
await client . sendLocation (
  chatId ,
  25.6801987 ,
  - 100.4060626 ,
  'Some address, Washington DC' ,
  'Subtitle'
) ;

// Send seen ✔️✔️
await client . sendSeen ( chatId ) ;

// Start typing...
await client . startTyping ( chatId ) ;

// Stop typing
await client . stopTyping ( chatId ) ;

// Set chat state (0: Typing, 1: Recording, 2: Paused)
await client . setChatState ( chatId , 0 | 1 | 2 ) ;

Recuperando datos

 // Retrieve contacts
const contacts = await client . getAllContacts ( ) ;

// Retrieve all messages in chat
const allMessages = await client . loadAndGetAllMessagesInChat ( chatId ) ;

// Retrieve contact status
const status = await client . getStatus ( contactId ) ;

// Retrieve user profile
const user = await client . getNumberProfile ( contactId ) ;

// Retrieve all unread message
const messages = await client . getAllUnreadMessages ( ) ;

// Retrieve all chats
const chats = await client . getAllChats ( ) ;

// Retrieve all groups
const chats = await client . getAllGroups ( ) ;

// Retrieve profile fic (as url)
const url = await client . getProfilePicFromServer ( chatId ) ;

// Retrieve chat/conversation
const chat = await client . getChat ( chatId ) ;

Funciones de grupo

 // groupId or chatId: leaveGroup [email protected]

// Leave group
await client . leaveGroup ( groupId ) ;

// Get group members
await client . getGroupMembers ( groupId ) ;

// Get group members ids
await client . getGroupMembersIds ( groupId ) ;

// Generate group invite url link
await client . getGroupInviteLink ( groupId ) ;

// Create group (title, participants to add)
await client . createGroup ( 'Group name' , [ '[email protected]' , '[email protected]' ] ) ;

// Remove participant
await client . removeParticipant ( groupId , '[email protected]' ) ;

// Add participant
await client . addParticipant ( groupId , '[email protected]' ) ;

// Promote participant (Give admin privileges)
await client . promoteParticipant ( groupId , '[email protected]' ) ;

// Demote particiapnt (Revoke admin privileges)
await client . demoteParticipant ( groupId , '[email protected]' ) ;

// Get group admins
await client . getGroupAdmins ( groupId ) ;

Funciones de perfil

 // Set client status
await client . setProfileStatus ( 'On vacations! ✈️' ) ;

// Set client profile name
await client . setProfileName ( 'Sulla bot' ) ;

Funciones del dispositivo

 // Get device info
await client . getHostDevice ( ) ;

// Get connection state
await client . getConnectionState ( ) ;

// Get battery level
await client . getBatteryLevel ( ) ;

// Is connected
await client . isConnected ( ) ;

// Get whatsapp web version
await client . getWAVersion ( ) ;

Eventos

 // Listen to messages
client . onMessage ( message => {
  ...
} )

// Listen to state changes
client . onStateChange ( state => {
  ...
} ) ;

// Listen to ack's
client . onAck ( ack => {
  ...
} ) ;

// Listen to live location
// chatId: '[email protected]'
client . onLiveLocation ( chatId , ( liveLocation ) => {
  ...
} ) ;

// chatId looks like this: '[email protected]'
// Event interface is in here: https://github.com/danielcardeenas/sulla/blob/master/src/api/model/participant-event.ts
client . onParticipantsChanged ( chatId , ( event ) => {
  ...
} ) ;

// Listen when client has been added to a group
client . onAddedToGroup ( chatEvent => {
  ...
} ) ;

Otro

 // Delete chat
await client . deleteChat ( chatId ) ;

// Clear chat messages
await client . clearChat ( chatId ) ;

// Delete message (last parameter: delete only locally)
await client . deleteMessage ( chatId , message . id . toString ( ) , false ) ;

// Retrieve a number profile / check if contact is a valid whatsapp number
const profile = await client . getNumberProfile ( '[email protected]' ) ;

Varios

Existen algunos trucos para un mejor uso de sulla.

Mantener viva la sesión:

 // In case of being logged out of whatsapp web
// Force it to keep the current session
// State change
client . onStateChange ( ( state ) => {
  console . log ( state ) ;
  const conflits = [
    sulla . SocketState . CONFLICT ,
    sulla . SocketState . UNPAIRED ,
    sulla . SocketState . UNLAUNCHED ,
  ] ;
  if ( conflits . includes ( state ) ) {
    client . useHere ( ) ;
  }
} ) ;

Enviar mensaje a nuevos contactos (no agregados)

Consulte también los enlaces de Whatsapp. Tenga cuidado, ya que esto puede provocar una prohibición de Whatsapp, ¡mantenga siempre sus contactos actualizados!

 await client . sendMessageToId ( '[email protected]' , 'Hello from sulla! ' ) ;

Múltiples sesiones

Si necesita ejecutar varias sesiones a la vez, simplemente pase un nombre de sesión al método create() .

 async ( ) => {
  const marketingClient = await sulla . create ( 'marketing' ) ;
  const salesClient = await sulla . create ( 'sales' ) ;
  const supportClient = await sulla . create ( 'support' ) ;
} ;

Cerrar (guardar) sesiones

Cierre la sesión correctamente para asegurarse de que se guarde para la próxima vez que inicie sesión (para que no vuelva a solicitar el escaneo QR). Entonces, en lugar de CTRL+C,

 // Catch ctrl+C
process . on ( 'SIGINT' , function ( ) {
  client . close ( ) ;
} ) ;

// Try-catch close
try {
   ...
} catch ( error ) {
   client . close ( ) ;
}

Depuración

Desarrollo

Construir sulla es realmente simple aunque contiene 3 proyectos principales en su interior.

proyecto wapi

 > npm run build:wapi

Middleware

 > npm run build:build:middleware
> npm run build:jsQR

Sila

 > npm run build:sulla

Para construir todo el proyecto simplemente ejecute

 > npm run build

mantenedores

Se necesitan mantenedores, no puedo mantener todas las actualizaciones yo solo. Si está interesado, abra una solicitud de extracción.

Contribuyendo

Las solicitudes de extracción son bienvenidas. Para cambios importantes, primero abra un problema para discutir lo que le gustaría cambiar.

Expandir

sulla

Sila

Estado de Sila

Instalación

Empezando

Después de ejecutar la función `create()` , sulla creará una instancia de whatsapp web. Si no ha iniciado sesión, se imprimirá un código QR en el terminal. ¡Escanéalo con tu teléfono y estarás listo para comenzar!

Sila recordará la sesión, por lo que no será necesario autenticarse cada vez.

Se pueden crear varias sesiones al mismo tiempo pasando un nombre de sesión a la función `create()` :

Parámetros de creación opcionales

La definición de tipo se puede encontrar aquí: CreateConfig.ts

Exportar código QR

Descargando archivos

Funciones básicas (uso)

Charlando

Aquí, `chatId` podría ser `@c.us` o `-@c.us`

Recuperando datos

Funciones de grupo

Funciones de perfil

Funciones del dispositivo

Eventos

Otro

Varios

Mantener viva la sesión:

Enviar mensaje a nuevos contactos (no agregados)

Múltiples sesiones

Cerrar (guardar) sesiones

Depuración

Desarrollo

mantenedores

Contribuyendo

noti

Kapowarr

syft

gopro 2014 dash cam

Wireless USB Adapter

eve ng labs

VALSING

Remove MS Edge

or tools

sulla

Sila

Estado de Sila

Instalación

Empezando

Después de ejecutar la función create() , sulla creará una instancia de whatsapp web. Si no ha iniciado sesión, se imprimirá un código QR en el terminal. ¡Escanéalo con tu teléfono y estarás listo para comenzar!

Sila recordará la sesión, por lo que no será necesario autenticarse cada vez.

Se pueden crear varias sesiones al mismo tiempo pasando un nombre de sesión a la función create() :

Parámetros de creación opcionales

La definición de tipo se puede encontrar aquí: CreateConfig.ts

Exportar código QR

Descargando archivos

Funciones básicas (uso)

Charlando

Aquí, chatId podría ser @c.us o -@c.us

Recuperando datos

Funciones de grupo

Funciones de perfil

Funciones del dispositivo

Eventos

Otro

Varios

Mantener viva la sesión:

Enviar mensaje a nuevos contactos (no agregados)

Múltiples sesiones

Cerrar (guardar) sesiones

Depuración

Desarrollo

mantenedores

Contribuyendo

Después de ejecutar la función `create()` , sulla creará una instancia de whatsapp web. Si no ha iniciado sesión, se imprimirá un código QR en el terminal. ¡Escanéalo con tu teléfono y estarás listo para comenzar!

Se pueden crear varias sesiones al mismo tiempo pasando un nombre de sesión a la función `create()` :

Aquí, `chatId` podría ser `@c.us` o `-@c.us`