MessagePayload

MessagePayload is a builder pattern for constructing MessagePayloadData. Used in all message sending methods: channel.send, message.reply, message.edit, etc.

MessagePayloadData

The final structure passed to REST methods. All fields are optional during serialization - missing fields are not included in JSON.

Field	Type	Description
`content`	`Option<String>`	Text content. Maximum 2000 characters.
`embeds`	`Option<Vec<ApiEmbed>>`	List of embed blocks. Maximum 10.
`attachments`	`Option<Vec<AttachmentPayload>>`	Attachment metadata. Populated automatically when sending files.
`message_reference`	`Option<ApiMessageReference>`	Reference to a message for a reply.
`tts`	`Option<bool>`	Send as a TTS message.
`flags`	`Option<u32>`	Message bitfield flags.

MessagePayloadData implements Serialize and Deserialize, so it can be stored, cloned, and passed around like a regular data structure.

Builder for MessagePayloadData. All methods take self and return Self - method chaining is supported.

Creating

`MessagePayload::new`

pub fn new() -> Self

Creates an empty builder.

`MessagePayload::from_content`

pub fn from_content(content: impl Into<String>) -> Self

Creates a builder with content already set. Equivalent to MessagePayload::new().content(content).

Methods

`content`

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

Sets the text content of the message.

Panics at runtime if the string length exceeds 2000 characters. Truncate text in advance using fluxer_util::truncate if the data source is not controlled.

`embeds`

pub fn embeds(self, embeds: Vec<ApiEmbed>) -> Self

Sets the embed list entirely. Replaces any previously added embeds.

Panics if embeds.len() > 10.

`add_embed`

pub fn add_embed(self, embed: ApiEmbed) -> Self

Appends a single embed to the list.

`add_embed_builder`

pub fn add_embed_builder(self, builder: EmbedBuilder) -> Self

Calls .build() on the given EmbedBuilder and appends the result. Convenient for inline chaining without an intermediate variable.

Example: message with text and an embed

use fluxer_builders::{EmbedBuilder, MessagePayload};

let payload = MessagePayload::new()
    .content("Operation result:")
    .add_embed_builder(
        EmbedBuilder::new()
            .title("Success")
            .description("Everything went fine.")
            .color(0x57F287),
    )
    .build();

channel.send(&rest, &payload).await?;

`attachments`

pub fn attachments(self, attachments: Vec<AttachmentPayload>) -> Self

Sets the attachment metadata list manually. Not needed in most cases - metadata is generated automatically when calling send_files.

`reply`

pub fn reply(
    self,
    channel_id: impl Into<String>,
    message_id: impl Into<String>,
    guild_id: Option<String>,
) -> Self

Sets message_reference to reply to a specific message.

When using message.reply() and message.reply_with(), the message_reference field is set automatically - calling reply() manually is not needed.

Example: manually set a reply reference

let payload = MessagePayload::new()
    .content("Replying to your message!")
    .reply(&message.channel_id, &message.id, message.guild_id.clone())
    .build();

channel.send(&rest, &payload).await?;

`tts`

pub fn tts(self, tts: bool) -> Self

If true, the message is read aloud via TTS for all channel members who have TTS enabled.

`flags`

pub fn flags(self, flags: u32) -> Self

Sets the message bitfield flags.

`attach_file`

pub fn attach_file(self, file: FileAttachment) -> Self

Adds a single file to the send. Files are stored inside the builder and included when calling build_with_files or build_form.

`attach_files`

pub fn attach_files(self, files: impl IntoIterator<Item = FileAttachment>) -> Self

Adds multiple files.

Finalizing

`build`

pub fn build(self) -> MessagePayloadData

Extracts MessagePayloadData. Files added via attach_file are not included in the result - use build_with_files or build_form to send with files.

`build_with_files`

pub fn build_with_files(self) -> (MessagePayloadData, Vec<FileAttachment>)

Returns MessagePayloadData and the file list separately. Use together with rest.post_multipart.

`build_form`

pub fn build_form(self) -> reqwest::multipart::Form

Assembles a ready-to-use multipart::Form for direct passing to rest.post_multipart. Includes payload_json and all attached files.

`has_files`

pub fn has_files(&self) -> bool

Returns true if at least one file has been attached to the builder.

AttachmentPayload

Attachment metadata. Generated automatically inside build_multipart_form.

Field	Type	Description
`id`	`u32`	Sequential file index (0, 1, 2, …).
`filename`	`String`	File name in the request. For spoilers, the `SPOILER_` prefix is added.
`description`	`Option<String>`	Attachment description (displayed as alt text).

Examples

Message with text only

let payload = MessagePayload::new()
    .content("Hello!")
    .build();

channel.send(&rest, &payload).await?;

Multiple embed blocks

let embed1 = EmbedBuilder::new()
    .title("Block 1")
    .color(0x5865F2)
    .build();

let embed2 = EmbedBuilder::new()
    .title("Block 2")
    .color(0xED4245)
    .build();

let payload = MessagePayload::new()
    .embeds(vec![embed1, embed2])
    .build();

channel.send(&rest, &payload).await?;

Send with a file

use fluxer_builders::{FileAttachment, MessagePayload};

let file = FileAttachment::new("report.txt", b"Report contents".to_vec())
    .content_type("text/plain")
    .description("Daily report");

let payload = MessagePayload::new()
    .content("Here is the file:")
    .build();

channel.send_files(&rest, &payload, &[file]).await?;

Reply with an embed using reply_with

let embed = EmbedBuilder::new()
    .title("Reply")
    .description("This is a reply with an embed.")
    .color(0xFEE75C)
    .build();

let payload = MessagePayload::new()
    .add_embed(embed)
    .build();

message.reply_with(&rest, &payload).await?;

Getting Started

Client

Structures

Builders

Networking

Utilities

MessagePayload

MessagePayloadData

MessagePayload

Creating

`MessagePayload::new`

`MessagePayload::from_content`

Methods

`content`

`embeds`

`add_embed`

`add_embed_builder`

`attachments`

`reply`

`tts`

`flags`

`attach_file`

`attach_files`

Finalizing

`build`

`build_with_files`

`build_form`

`has_files`

AttachmentPayload

Examples

​MessagePayloadData

​MessagePayload

​Creating

​MessagePayload::new

​MessagePayload::from_content

​Methods

​content

​embeds

​add_embed

​add_embed_builder

​attachments

​reply

​tts

​flags

​attach_file

​attach_files

​Finalizing

​build

​build_with_files

​build_form

​has_files

​AttachmentPayload

​Examples

MessagePayloadData

MessagePayload

Creating

`MessagePayload::new`

`MessagePayload::from_content`

Methods

`content`

`embeds`

`add_embed`

`add_embed_builder`

`attachments`

`reply`

`tts`

`flags`

`attach_file`

`attach_files`

Finalizing

`build`

`build_with_files`

`build_form`

`has_files`

AttachmentPayload

Examples