WhatsApp Cloud API SDK for Rust

A Rust SDK for the WhatsApp Cloud API hosted by Meta. This library provides a type-safe, async interface for integrating WhatsApp Business messaging into your Rust applications.

Features

• Messages API - Send text, media, templates, interactive messages, and more
• Media API - Upload, download, and manage media files
• Templates API - Create and manage message templates
• Phone Numbers API - Manage business phone numbers
• Webhooks - Type-safe webhook payload parsing
• Async/Await - Built on Tokio for async operations
• Type-Safe - Strongly typed API with Serde serialization

Installation

Add this to your Cargo.toml:

[dependencies]
whatsapp-cloud-api = "0.1"
tokio = { version = "1", features = ["full"] }

Quick Start

use whatsapp_cloud_api::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Create a client
    let client = Client::new(
        "YOUR_ACCESS_TOKEN",
        "YOUR_PHONE_NUMBER_ID"
    );

    // Send a text message
    let response = client
        .messages()
        .send_text("628123456789", "Hello from Rust!")
        .await?;

    println!("Message sent: {:?}", response.messages[0].id);
    Ok(())
}

Usage Examples

Send Text Message

let response = client
    .messages()
    .send_text("628123456789", "Hello!")
    .await?;

Send Text with URL Preview

let response = client
    .messages()
    .send_text_with_preview("628123456789", "Check this out: https://example.com")
    .await?;

Send Image

// By URL
let response = client
    .messages()
    .send_image_url("628123456789", "https://example.com/image.jpg", Some("Caption"))
    .await?;

// By Media ID (after upload)
let response = client
    .messages()
    .send_image_id("628123456789", "media_id_here", Some("Caption"))
    .await?;

Send Video

let response = client
    .messages()
    .send_video_url("628123456789", "https://example.com/video.mp4", Some("Watch this!"))
    .await?;

Send Document

let response = client
    .messages()
    .send_document_url(
        "628123456789",
        "https://example.com/document.pdf",
        Some("report.pdf"),
        Some("Here's the report")
    )
    .await?;

Send Location

let response = client
    .messages()
    .send_location(
        "628123456789",
        -6.2088,           // latitude
        106.8456,          // longitude
        Some("Jakarta"),   // name
        Some("Indonesia")  // address
    )
    .await?;

Send Reaction

// Add reaction
let response = client
    .messages()
    .send_reaction("628123456789", "message_id_here", "👍")
    .await?;

// Remove reaction
let response = client
    .messages()
    .remove_reaction("628123456789", "message_id_here")
    .await?;

Send Interactive Buttons

use whatsapp_cloud_api::messages::Button;

let buttons = vec![
    Button::reply("btn_yes", "Yes"),
    Button::reply("btn_no", "No"),
    Button::reply("btn_maybe", "Maybe"),
];

let response = client
    .messages()
    .send_buttons(
        "628123456789",
        Some("Question"),         // header
        "Do you want to proceed?", // body
        Some("Tap a button"),     // footer
        buttons
    )
    .await?;

Send Interactive List

use whatsapp_cloud_api::messages::{ListSection, ListRow};

let sections = vec![
    ListSection {
        title: "Products".to_string(),
        rows: vec![
            ListRow::new("prod_1", "Product 1").with_description("$10.00"),
            ListRow::new("prod_2", "Product 2").with_description("$20.00"),
        ],
    },
];

let response = client
    .messages()
    .send_list(
        "628123456789",
        Some("Our Products"),   // header
        "Choose a product",     // body
        Some("Powered by WA"),  // footer
        "View Products",        // button text
        sections
    )
    .await?;

Send Template Message

use whatsapp_cloud_api::messages::{TemplateComponent, TemplateParameter};

let components = vec![
    TemplateComponent {
        component_type: "body".to_string(),
        sub_type: None,
        index: None,
        parameters: Some(vec![
            TemplateParameter {
                param_type: "text".to_string(),
                text: Some("John".to_string()),
                currency: None,
                date_time: None,
                image: None,
                document: None,
                video: None,
            },
        ]),
    },
];

let response = client
    .messages()
    .send_template("628123456789", "hello_world", "en_US", Some(components))
    .await?;

Upload Media

// From file
let response = client
    .media()
    .upload_file("./image.jpg")
    .await?;
println!("Media ID: {}", response.id);

// From bytes
let response = client
    .media()
    .upload_bytes(&file_bytes, "image.jpg", "image/jpeg")
    .await?;

Handle Webhooks

use whatsapp_cloud_api::webhooks::{WebhookPayload, WebhookEvent};

fn handle_webhook(payload: &str) -> Result<(), Box<dyn std::error::Error>> {
    let webhook: WebhookPayload = serde_json::from_str(payload)?;

    for event in webhook.events() {
        match event {
            WebhookEvent::TextMessage { from, text, message_id } => {
                println!("Text from {}: {}", from, text);
            }
            WebhookEvent::ImageMessage { from, media_id, .. } => {
                println!("Image from {}: {}", from, media_id);
            }
            WebhookEvent::ButtonReply { from, button_id, button_title, .. } => {
                println!("Button {} clicked by {}", button_title, from);
            }
            WebhookEvent::MessageDelivered { message_id, recipient } => {
                println!("Message {} delivered to {}", message_id, recipient);
            }
            _ => {}
        }
    }
    Ok(())
}

API Reference

Client

Messages API

Media API

Environment Variables

You can set these environment variables:

WHATSAPP_ACCESS_TOKEN=your_access_token
WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id

Getting Started with WhatsApp Cloud API

1. Create a Meta Developer Account
2. Create a new app and add the WhatsApp product
3. Get your access token and phone number ID from the app dashboard
4. Set up webhooks to receive messages

For more information, see the WhatsApp Cloud API documentation.

License

MIT

Author

Abdul Muttaqin - @taqin