Enum SendError 

#[non_exhaustive]
pub enum SendError {
    Client(ClientError),
    NotLoggedIn,
    Iq(IqError),
    InvalidRequest(String),
    Internal(Error),
}

Error returned by the message send path (Client::send_message, Client::send_text, Client::forward_message, reactions, edits, revokes, pins, polls, events, comments, status) and the bot crate::bot::MessageContext helpers.

Wraps the shared ClientError (transport/connection/IQ) and surfaces the actionable send-time failure modes explicitly. Internal is the last-resort catch-all for crypto/encoding paths that still thread anyhow internally.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Client(ClientError)

Connection/transport/IQ failure (embeds the shared base error).

NotLoggedIn

The client has no PN/LID identity yet (not paired / mid LID migration).

Iq(IqError)

An IQ issued as part of the send (e.g. a group-info query) failed.

InvalidRequest(String)

The recipient JID or send arguments are invalid for this operation (e.g. a newsletter JID on the E2E path, an empty status recipient list).

Internal(Error)

Catch-all for internal send failures (Signal encrypt, protobuf, group resolution) that have no dedicated variant yet. Display forwards to the inner error while source() still exposes it for downcast.

Trait Implementations

impl Debug for SendError

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

Formats the value using the given formatter.

impl Display for SendError

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

Formats the value using the given formatter.

impl Error for SendError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ClientError> for SendError

fn from(err: ClientError) -> Self

Converts to this type from the input type.

impl From<Error> for SendError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<GroupError> for SendError

fn from(err: GroupError) -> Self

Converts to this type from the input type.

impl From<IqError> for SendError

fn from(source: IqError) -> Self

Converts to this type from the input type.

impl From<SendError> for PluginMessagingError

Available on crate feature plugins only.

fn from(source: SendError) -> Self

Converts to this type from the input type.

impl From<SendError> for PollError

fn from(source: SendError) -> Self

Converts to this type from the input type.