Struct BotBuilder 

pub struct BotBuilder { /* private fields */ }

Implementations

impl BotBuilder

pub fn on_event<F, Fut>(self, handler: F) -> Self

where F: Fn(Event, Arc<Client>) -> Fut + Send + Sync + 'static, Fut: Future<Output = ()> + Send + 'static,

pub fn with_enc_handler<H>( self, enc_type: impl Into<String>, handler: H, ) -> Self

where H: EncHandler + 'static,

Register a custom handler for a specific encrypted message type

Arguments

• enc_type - The encrypted message type (e.g., “frskmsg”)
• handler - The handler implementation for this type

Returns

The updated BotBuilder

pub fn for_device(self, device_id: i32) -> Self

Specify which device ID to use for multi-account scenarios. If not specified, single device mode will be used.

pub fn with_backend(self, backend: Arc<dyn Backend>) -> Self

Use a backend implementation for storage. This is the only way to configure storage - there are no defaults.

Arguments

• backend - The backend implementation that provides all storage operations

Example

let backend = Arc::new(SqliteStore::new("whatsapp.db").await?);
let bot = Bot::builder()
    .with_backend(backend)
    .build()
    .await?;

pub fn with_version(self, version: (u32, u32, u32)) -> Self

Override the WhatsApp version used by the client.

By default, the client will automatically fetch the latest version from WhatsApp’s servers. Use this method to force a specific version instead.

Arguments

• version - A tuple of (primary, secondary, tertiary) version numbers

Example

let bot = Bot::builder()
    .with_backend(backend)
    .with_version((2, 3000, 1027868167))
    .build()
    .await?;

pub fn with_os_info( self, os_name: Option<String>, version: Option<AppVersion>, ) -> Self

Override the OS information sent to WhatsApp servers. This allows customizing the device properties that WhatsApp sees.

Arguments

• os_name - Optional OS name (e.g., “Android”, “iOS”, “Windows”)
• version - Optional OS version as AppVersion struct

You can pass None for either parameter to keep the default value.

Example

use waproto::whatsapp::device_props;

// Set only OS name, keep default version
let bot = Bot::builder()
    .with_backend(backend)
    .with_os_info(Some("Android".to_string()), None)
    .build()
    .await?;

// Set only version, keep default OS
let bot = Bot::builder()
    .with_backend(backend)
    .with_os_info(None, Some(device_props::AppVersion {
        primary: Some(10),
        secondary: Some(0),
        tertiary: Some(0),
        ..Default::default()
    }))
    .build()
    .await?;

pub async fn build(self) -> Result<Bot>

Trait Implementations

impl Default for BotBuilder

fn default() -> BotBuilder

Returns the “default value” for a type.