Struct SendOptions 

#[non_exhaustive]
pub struct SendOptions {
    pub message_id: Option<String>,
    pub extra_stanza_nodes: Vec<Node>,
    pub ephemeral_expiration: Option<u32>,
    pub stanza_type_override: Option<StanzaType>,
    pub group_metadata_freshness: Freshness,
    pub device_freshness: Freshness,
}

Options for Client::send_message_with_options.

Start from SendOptions::default and chain the with_* setters; the struct is #[non_exhaustive] so new knobs can be added without breaking consumers.

let options = SendOptions::default().with_message_id("3EB0ABCDEF");

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

message_id: Option<String>

Override the auto-generated message ID. Useful for resending a failed message with the same ID or idempotency.

extra_stanza_nodes: Vec<Node>

Extra XML child nodes on the message stanza.

ephemeral_expiration: Option<u32>

Ephemeral duration in seconds. Sets contextInfo.expiration on the message (WA Web EProtoGenerator.js:183 parity). Common values: 86400 (24h), 604800 (7d), 7776000 (90d).

stanza_type_override: Option<StanzaType>

Force the <message type="..."> attribute instead of deriving it from content. Escape hatch for a type the classifier can’t infer.

group_metadata_freshness: Freshness

Freshness policy for group metadata used by this send.

device_freshness: Freshness

Freshness policy for recipient device lists used by this send.

Implementations

impl SendOptions

pub fn with_message_id(self, message_id: impl Into<String>) -> Self

See SendOptions::message_id.

pub fn with_extra_stanza_nodes(self, nodes: Vec<Node>) -> Self

See SendOptions::extra_stanza_nodes.

pub fn with_ephemeral_expiration(self, seconds: u32) -> Self

See SendOptions::ephemeral_expiration.

pub fn with_stanza_type_override(self, stanza_type: StanzaType) -> Self

See SendOptions::stanza_type_override.

pub fn with_group_metadata_freshness(self, freshness: Freshness) -> Self

See SendOptions::group_metadata_freshness.

pub fn with_device_freshness(self, freshness: Freshness) -> Self

See SendOptions::device_freshness.

Trait Implementations

impl Clone for SendOptions

fn clone(&self) -> SendOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SendOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SendOptions

fn default() -> SendOptions

Returns the “default value” for a type.