شعار سولا

سولا

Sulla هي مكتبة جافا سكريبت توفر تحكمًا عالي المستوى في واجهة برمجة التطبيقات لتطبيق Whatsapp بحيث يمكن تهيئتها لأتمتة الاستجابات أو أي بيانات تمر عبر Whatsapp دون عناء.
تم بناؤه باستخدام محرك الدمى

ولاية سولا

اعتبارًا من الإصدار 2.3.5 يبدو أن sulla قد وصلت إلى وظائف وبنية غنية ومستقرة جدًا. بقدر ما أرغب في ذلك، لا يمكنني تخصيص الكثير من الوقت لهذا المشروع، لذا يرجى التفكير في التحقق من الإصدارات المتشعبة من sulla حيث يمكن للمطورين الآخرين تخصيص المزيد من الوقت والدعم له.

المشاريع المعتمدة على أساس سولا الموصى بها:

السم

com.wppconnect

مفتوح وا/وا تلقائي

تثبيت

 > npm i sulla --save

ابدء

 // 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!' ) ;
    }
  } ) ;
}

بعد تنفيذ وظيفة `create()` ، سيقوم sulla بإنشاء مثيل لـ whatsapp web. إذا لم تقم بتسجيل الدخول، فسيتم طباعة رمز الاستجابة السريعة في المحطة. قم بمسحها ضوئيًا بهاتفك وستكون جاهزًا للانطلاق!

سوف يتذكر سولا الجلسة لذا ليست هناك حاجة للمصادقة في كل مرة.

يمكن إنشاء جلسات متعددة في نفس الوقت عن طريق تمرير اسم الجلسة `create()` :

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

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

اختياري إنشاء المعلمات

يمكن أن تحتوي المعلمة الثالثة لطريقة Sulla create() على المعلمات الاختيارية التالية:

 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
} ) ;

يمكن العثور على تعريف النوع هنا: CreateConfig.ts

تصدير رمز الاستجابة السريعة

افتراضيًا، سيظهر رمز الاستجابة السريعة على الجهاز. إذا كنت بحاجة إلى تمرير QR في مكان آخر، فإليك الطريقة:

 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 ) ;
}

تنزيل الملفات

يتولى محرك الدمى مهمة تنزيل الملف. يتم فك التشفير بأسرع ما يمكن (يتجاوز الطرق الأصلية). يدعم الملفات الكبيرة!

 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 ) {
      ...
    } ) ;
  }
} ) ;

الوظائف الأساسية (الاستخدام)

لم يتم إدراج كل وظيفة متاحة، لمزيد من البحث، يمكن العثور على كل وظيفة متاحة هنا وهنا

الدردشة

هنا، يمكن أن يكون `chatId` `@c.us` أو `-@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 ) ;

استرجاع البيانات

 // 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 ) ;

وظائف المجموعة

 // 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 ) ;

وظائف الملف الشخصي

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

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

وظائف الجهاز

 // 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 ( ) ;

الأحداث

 // 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 => {
  ...
} ) ;

آخر

 // 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]' ) ;

متنوعات

هناك بعض الحيل لاستخدام سولا بشكل أفضل.

إبقاء الجلسة حية:

 // 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 ( ) ;
  }
} ) ;

إرسال رسالة إلى جهات الاتصال الجديدة (غير مضافة)

راجع أيضًا روابط Whatsapp. كن حذرًا نظرًا لأن هذا قد يؤدي إلى حظر Whatsapp، فاحرص دائمًا على تحديث جهات الاتصال الخاصة بك!

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

جلسات متعددة

إذا كنت بحاجة إلى تشغيل جلسات متعددة في وقت واحد، فما عليك سوى تمرير اسم الجلسة create() .

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

إغلاق (حفظ) الجلسات

أغلق الجلسة بشكل صحيح لضمان حفظ الجلسة في المرة التالية التي تقوم فيها بتسجيل الدخول (لذلك لن يطلب منك مسح QR مرة أخرى). لذا بدلاً من CTRL+C،

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

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

تصحيح الأخطاء

تطوير

يعد بناء سولا أمرًا بسيطًا حقًا على الرغم من أنه يحتوي على 3 مشاريع رئيسية بالداخل

مشروع وابي

 > npm run build:wapi

الوسيطة

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

سولا

 > npm run build:sulla

لبناء المشروع بأكمله تشغيل فقط

 > npm run build

المشرفون

هناك حاجة إلى مشرفين، ولا أستطيع متابعة جميع التحديثات بنفسي. إذا كنت مهتما يرجى فتح طلب السحب.

المساهمة

طلبات السحب هي موضع ترحيب. لإجراء تغييرات كبيرة، يرجى فتح مشكلة أولاً لمناقشة ما تريد تغييره.

يوسع

sulla

سولا

ولاية سولا

تثبيت

ابدء

سوف يتذكر سولا الجلسة لذا ليست هناك حاجة للمصادقة في كل مرة.

يمكن إنشاء جلسات متعددة في نفس الوقت عن طريق تمرير اسم الجلسة `create()` :

اختياري إنشاء المعلمات

يمكن العثور على تعريف النوع هنا: CreateConfig.ts

تصدير رمز الاستجابة السريعة

تنزيل الملفات

الوظائف الأساسية (الاستخدام)

الدردشة

هنا، يمكن أن يكون `chatId` `@c.us` أو `-@c.us`

استرجاع البيانات

وظائف المجموعة

وظائف الملف الشخصي

وظائف الجهاز

الأحداث

آخر

متنوعات

إبقاء الجلسة حية:

إرسال رسالة إلى جهات الاتصال الجديدة (غير مضافة)

جلسات متعددة

إغلاق (حفظ) الجلسات

تصحيح الأخطاء

تطوير

المشرفون

المساهمة

noti

Kapowarr

syft

gopro 2014 dash cam

Wireless USB Adapter

eve ng labs

VALSING

Remove MS Edge

or tools

sulla

سولا

ولاية سولا

تثبيت

ابدء

سوف يتذكر سولا الجلسة لذا ليست هناك حاجة للمصادقة في كل مرة.

يمكن إنشاء جلسات متعددة في نفس الوقت عن طريق تمرير اسم الجلسة create() :

اختياري إنشاء المعلمات

يمكن العثور على تعريف النوع هنا: CreateConfig.ts

تصدير رمز الاستجابة السريعة

تنزيل الملفات

الوظائف الأساسية (الاستخدام)

الدردشة

هنا، يمكن أن يكون chatId @c.us أو -@c.us

استرجاع البيانات

وظائف المجموعة

وظائف الملف الشخصي

وظائف الجهاز

الأحداث

آخر

متنوعات

إبقاء الجلسة حية:

إرسال رسالة إلى جهات الاتصال الجديدة (غير مضافة)

جلسات متعددة

إغلاق (حفظ) الجلسات

تصحيح الأخطاء

تطوير

المشرفون

المساهمة

يمكن إنشاء جلسات متعددة في نفس الوقت عن طريق تمرير اسم الجلسة `create()` :

هنا، يمكن أن يكون `chatId` `@c.us` أو `-@c.us`