Quick Messenger For WhatsApp -(Support iOS version 17 and Swift 5)

Introduction

Quick Messenger is a popular open-source messaging library for WhatsApp-based solutions. It allows you to integrate WhatsApp messaging into your iOS app, making it easy to send messages, make voice and video calls, and even create WhatsApp Business accounts. In this tutorial, we'll focus on using Quick Messenger to send messages programmatically within an iOS app, supporting both iOS 17 and Swift 5.

Before starting, make sure you have the following:

1. Xcode 12 (or later) installed on your Mac.
2. Swift 5.x project set up in Xcode.
3. An existing WhatsApp account (you'll need to register as a developer to get the API key).
4. Your WhatsApp Business API key, which you'll receive once you've registered as a developer.

Step 1: Add Quick Messenger to Your Project

To use Quick Messenger in your project, follow these steps:

1. Open your Xcode project and navigate to File > Swift Packages > Add Package Dependency.
2. Enter the following package information:
   • Name: QuickMessenger
   • URL: https://github.com/QuickMessenger/QuickMessenger.git
   • Version: up to date (or specific version if you prefer)
3. Click Next and then Finish to add the package to your project.

Step 2: Install Pod

If you have existing pods in your project, you might need to remove them to avoid conflicts with Quick Messenger. Once the package is added, update your pods by running:

pod update

This step might take a few seconds to complete.

Step 3: Get WhatsApp API Key

Go to the WhatsApp Business API and register as a developer to get your API key.

Step 4: Configure Quick Messenger

Before using Quick Messenger, you need to configure it. Create a new Swift file (e.g., WhatsAppManager.swift) and add the following code:

import UIKit
import QuickMessenger

class WhatsAppManager: NSObject {
    let appDelegate: AppDelegate
    let ws: WhatsAppSession!

    init(appDelegate: AppDelegate) {
        self.appDelegate = appDelegate
        ws = WhatsAppSession(session: URLSession.shared,
                              apiVersion: "whatsapp-2")
    }

    func configureApi() {
        let whatsappApi = WhatsAppAPI(version: ws.apiVersion, apiKey: "YOUR_API_KEY_HERE")
        ws.configure(api: whatsappApi)
    }
}

Replace YOUR_API_KEY_HERE with the actual API key from your WhatsApp Business API registration.

Step 5: Send Messages

Create another Swift file (e.g., SendMessage.swift) and add the following code:

import UIKit
import QuickMessenger

class SendMessage {
    let whatsappManager: WhatsAppManager

    init(with whatsappManager: WhatsAppManager) {
        self.whatsappManager = whatsappManager
    }

    func sendMessage(to phoneNumber: String, message: String) {
        whatsappManager.configureApi()
        let messageRequest = WhatsAppMessage(text: message)
        let target = WhatsAppTarget(type:.individual, value: phoneNumber)
        ws.send(message: messageRequest, to: target, progress: { (progress) in
            // Do something with the progress...
        }) { (error) in
            if let error = error {
                print("Error sending message: (error)")
            }
        }
    }
}

You can now use this code to send messages. Instantiate the SendMessage class and call the sendMessage method, passing in the target phone number and the message you want to send.

Full Example Code

Here's an example of how to integrate Quick Messenger into your Swift 5 project using the above steps:

import UIKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?
    var whatsappManager: WhatsAppManager!

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        whatsappManager = WhatsAppManager(appDelegate: self)
        //...
        return true
    }

    func sendTextMessage() {
        let message = "Hello from iOS!"
        let sender = SendMessage(with: whatsappManager)
        sender.sendMessage(to: "+1234567890", message: message)
    }
}

You can now call the sendTextMessage function whenever you want to send a message.

Additional Information

This tutorial covered the basics of using Quick Messenger to send messages from an iOS app. If you want to explore more advanced features, such as video and voice calls, I recommend checking out the Quick Messenger documentation and exploring the library's source code.