Broadcast Buddy Dart & Flutter SDK 🚀 #

Official Dart and Flutter client library for the Broadcast Buddy WhatsApp Gateway API. Send formatted text, interactive multi-choice polls, high-resolution media, PDF invoices, GPS location pins, and check real-time phone number registration on WhatsApp.

✨ Features #

• Cross-Platform Compatibility — Works seamlessly across Flutter (iOS, Android, Web, macOS, Windows, Linux) and Server-side Dart (Dart Frog, Shelf).
• 100% Sound Null-Safety — Built for modern Dart 3+ with complete type safety.
• Interactive WhatsApp Polls — Create single and multi-select WhatsApp polls with one line of code.
• High-Res Media Streaming — Send images, documents, audio voice notes, and videos from URLs or Base64.
• Real-Time Number Verification — Verify if customer phone numbers exist on WhatsApp before dispatching broadcasts.
• Hotline Diagnostics — Monitor live WhatsApp session connection states.

📦 Installation #

In your Dart or Flutter project, run:

dart pub add broadcastbuddy

Or for Flutter apps:

flutter pub add broadcastbuddy

🚀 Quickstart #

import 'package:broadcastbuddy/broadcastbuddy.dart';

void main() async {
  // Initialize with your API Key (Session ID)
  final bb = BroadcastBuddy('bb_live_YOUR_API_KEY');

  try {
    // 1. Verify if a recipient is registered on WhatsApp
    final check = await bb.isOnWhatsApp('233240001122');
    print('On WhatsApp: ${check.isRegistered}');

    // 2. Send a WhatsApp Text Message
    final res = await bb.sendMessage(
      '233240001122',
      '🚀 Hello from Broadcast Buddy Flutter SDK!',
    );
    print('Message Sent: ${res.success}');

    // 3. Send an Interactive Multi-Choice Poll
    await bb.sendPoll(
      '233240001122',
      'Which feature should we build next?',
      ['AI Auto-Pilot Agent', 'Custom Webhook Flows', 'Enterprise CRM Sync'],
      isMultiSelect: false,
    );

    // 4. Send Image with Caption (URL or Base64)
    await bb.sendImage(
      '233240001122',
      'https://example.com/receipt.png',
      caption: 'Your Payment Receipt #1092',
    );

    // 5. Send PDF Document / Invoice
    await bb.sendDocument(
      '233240001122',
      'data:application/pdf;base64,...',
      filename: 'Invoice_2026.pdf',
      caption: 'Here is your monthly invoice',
    );

    // 6. Check Hotline Connection Status
    final status = await bb.getStatus();
    print('Hotline Status: ${status.status} (Connected: ${status.success})');
  } catch (e) {
    print('Error: $e');
  } finally {
    bb.close();
  }
}

📚 API Reference #

BroadcastBuddy(String apiKey, {String baseUrl, Duration timeout}) #

📄 License #

MIT © Broadcast Buddy