@deathnaitsa/wa-api v1.0.37

wa-api

Leichte Bibliothek zur Verwaltung mehrerer WhatsApp-Sessions – mit einer universellen sendMessage-Funktion und direkter relayMessage-Unterstützung für alle fortgeschrittenen Szenarien.

📑 Inhaltsverzeichnis

1. Installation
2. Import & Setup
3. Session Management
4. Nachrichten senden via sendMessage

5. Low-level relayMessage Beispiele

   • ProtocolMessage: Nachricht löschen (Revoke)
   • Ephemeral-Modus (Gruppen)
   • Status-Update (Story)
   • Weiterleiten (Forward)
   • Profilbild aktualisieren
   • Chat als gelesen markieren
   • Nachrichten id Bearbeiten

6. Listener

7. Fehlerbehandlung

📦 Installation

npm install @deathnaitsa/wa-api@latest

🔌 Import & Setup

// CommonJS
const wa = require('@deathnaitsa/wa-api');

// ES Module
import * as wa from '@deathnaitsa/wa-api';

🚀 Session Management

await wa.startSession('session1');
await wa.startSessionWithPairingCode('session2', { phoneNumber: '491234567890' });
const all = wa.getAllSession();
const one = wa.getSession('session1');
const loaded = await wa.loadSessionsFromStorage();

💬 Nachrichten senden via sendMessage

Eine zentrale Funktion für alle Nachrichtentypen:

await wa.sendMessage(
  sessionId,      // Session-ID
  jidOrPhone,     // JID oder Telefonnummer
  content,        // AnyMessageContent
  options         // MiscMessageGenerationOptions
);

Beispiele

🔄 Low-level relayMessage Beispiele

Direktes Senden von WAMessage-Stanzas für Spezialfälle.

ProtocolMessage: Nachricht löschen (Revoke)

const deleteNode = {
  protocolMessage: {
    key: { remoteJid: chatJid, fromMe: true, id: targetId },
    type: 7 // MESSAGE_REVOKE
  }
};
await wa.relayMessage(
  sessionId,
  chatJid,
  deleteNode,
  { messageId: targetId }
);

Ephemeral-Modus (Gruppen)

// 24h Ephemeral ein
await wa.relayMessage(
  sessionId,
  groupJid,
  { disappearingMessagesInChat: Defaults.WA_DEFAULT_EPHEMERAL },
  {}
);
// Ephemeral aus
await wa.relayMessage(
  sessionId,
  groupJid,
  { disappearingMessagesInChat: 0 },
  {}
);

Status-Update (Story)

const storyNode = {
  videoMessage: { url: './story.mp4' },
  caption: 'Meine Story' 
};
await wa.relayMessage(
  sessionId,
  'status@broadcast',
  storyNode,
  { statusJidList: ['491234567890@s.whatsapp.net'] }
);

Weiterleiten (Forward)

const origMsg = getMessageFromStore();
const forwardNode = { forward: origMsg };
await wa.relayMessage(
  sessionId,
  chatJid,
  forwardNode,
  { messageId: origMsg.key.id }
);

Profilbild aktualisieren

const updateNode = {
  profilePictureChange: {
    displayPicture: fs.readFileSync('./newprofile.jpg')
  }
};
await wa.relayMessage(
  sessionId,
  userJid,
  updateNode,
  { messageId: 'nishiProfileUpdate' }
);

Chat als gelesen markieren

const readNode = {
  protocolMessage: {
    key: { remoteJid: chatJid },
    type: 3 // READ 
  }
};
await wa.relayMessage(
  sessionId,
  chatJid,
  readNode,
  { messageId: 'nishiMarkRead' }
);

Nachrichten Id selbst Festlegen

 await wa.relayMessage(
    msg.sessionId,               // deine Session-ID
    msg.key.remoteJid,          
    {
    conversation: 'Dies ist eine Relay-Textnachricht'
  },                
    { messageId: `nishi`+ Date.now(); }       
  ); 

🎧 Listener

wa.onConnected(id => console.log('Online:', id));
wa.onQRUpdated(info => console.log('QR:', info));
wa.onMessageReceived(msg => console.log('Nachricht:', msg));

⚠️ Fehlerbehandlung

try {
  await wa.sendMessage(...);
} catch(e) {
  console.error(e);
}

© 2025 @deathnaitsa/wa-api • Support: sebloidl13@gmail.com