drago_whatsapp_flutter 0.3.1

This plugin will allow to send text, files in the background using whatsapp web

drago_whatsapp_flutter

A powerful Flutter plugin to automate WhatsApp Web interactions. Built on top of wa-js (WPPConnect) and flutter_inappwebview, it allows you to send messages, media, manage groups, and listen to events either headlessly or through an interactive UI.

Features

• 🚀 Fast Connect: Optimized initialization sequence and early script injection.
• 🎭 Headless & Visual Modes: Run in the background or embed WhatsApp Web in your UI.
• 📱 Messaging: Send text (edit/pin), images, videos, documents, and buttons/templates.
• 👥 Group Management: Fetch groups, manage participants (promote/demote), and more.
• 📉 Status/Story: Post text, image, and video updates to your status.
• 🏷️ Labels: Full support for WhatsApp Business labels (list/add/delete).
• 🔔 Event Stream: Real-time listeners for messages, calls, and connection states.
• 💾 Session Management: Persistent login support for seamless restarts.
• 🛠️ Customizable: Supply specific wa-js versions and configurations.

Platform Support

Android	iOS	Windows	macOS	Linux	Web
✅	✅	✅	✅	✅	❌

Getting Started

Add the dependency to your pubspec.yaml:

dependencies:
  drago_whatsapp_flutter: ^0.3.0

or run:

flutter pub add drago_whatsapp_flutter

Basic Usage

Initialize Headless Connection

This is ideal for background bots.

WhatsappClient? client;

client = await DragoWhatsappFlutter.connect(
  saveSession: true,
  onConnectionEvent: (event) {
    print("Connection Event: ${event.name}");
  },
  onQrCode: (qrCodeUrl, imageBytes) {
    // Display QR Code to user
  },
);

if (client != null) {
  print("Connected successfully!");
}

Send a Message

await client?.chat.sendTextMessage(
  phone: "1234567890", // With country code
  message: "Hello from Flutter!",
);

Send Media/Buttons

// Send Image
await client?.chat.sendFileMessage(
  phone: "1234567890",
  fileBytes: imageBytes,
  fileType: WhatsappFileType.image,
  caption: "Check this out!",
);

// Send Buttons (Templates)
await client?.chat.sendTextMessage(
  phone: "1234567890",
  message: "Pick an option:",
  useTemplate: true,
  buttons: [
    MessageButtons(
      text: "Visit Google",
      buttonData: "https://google.com",
      buttonType: ButtonType.url,
    ),
  ],
);

Check the result

A send returns a Message whose ack is WhatsApp's delivery state (MessageAck): -1 failed, 0 pending, 1 accepted by the server (sent), 2 delivered, 3 read. A send that throws or returns null did not go out.

final msg = await client?.chat.sendTextMessage(phone: "91...", message: "Hi");
final sent = msg != null && !msg.isFailed;

When sending to many numbers, pause a few seconds between sends -- rapid bulk sends are the quickest way to get a number banned.

Groups and Channels

Every send method takes a full chat id as phone, so the same calls post to a group ([e-mail]) or a channel you own or administer (...@newsletter).

final groups = await client!.group.list();          // WhatsappChatSummary
final channels = await client!.newsletter.list();
for (final target in [...groups, ...channels].where((t) => t.canPost)) {
  await client!.chat.sendFileMessage(
    phone: target.id,
    fileBytes: catalogPage,
    fileType: WhatsappFileType.image,
    caption: "New arrivals",
  );
}

// The WhatsApp Business catalog itself, as a tap-to-browse card
await client!.chat.sendCatalogMessage(
  phone: groups.first.id,
  catalogOwner: "91XXXXXXXXXX", // your business number
  textMessage: "Browse our catalog",
);

Listen to Incoming Messages

client?.on(WhatsappEvent.chatnewmessage, (data) {
  final List<Message> messages = Message.parse(data);
  for (var msg in messages) {
    print("New message from ${msg.from}: ${msg.body}");
  }
});

Advanced Configuration

Using specific wa-js version

By default a tested wa-js release (WppConnect.defaultWppVersion) is downloaded, falling back to the latest release if that download fails. Pick another tag from wa-js releases, or ship the script with your app and pass it as wppJsContent.

client = await DragoWhatsappFlutter.connect(
  wppVersion: "v4.6.1",
);

Session takeover

With autoTakeover: true (the default) the bot takes the session back when WhatsApp Web is opened elsewhere. Turn it off if the business also uses WhatsApp Web in a browser, or the two keep kicking each other off.

TLS

This package no longer installs a global HttpOverrides. The old enableHttpOverrides flag is deprecated and off by default: it disabled certificate checks for every HttpClient in the app.

Visual Browser Integration

If you want the user to see the WhatsApp Web interface (useful for debugging or first-time login):

// In your UI using flutter_inappwebview
InAppWebView(
  onLoadStop: (controller, url) async {
    client = await DragoWhatsappFlutter.connectWithInAppBrowser(
      controller: controller,
    );
  },
)

Session Cleanup

To logout and clear all saved credentials:

await client?.clearSession(); 

Credits

This package is built using:

• WPPConnect wa-js for the WhatsApp Web bridge.
• flutter_inappwebview for the browser engine.

License

This project is licensed under the MIT License - see the LICENSE file for details.