Struct twilight_http::request::channel::message::create_message::CreateMessage

pub struct CreateMessage<'a> { /* fields omitted */ }

Send a message to a channel.

Example

use twilight_http::Client;
use twilight_model::id::ChannelId;

let client = Client::new("my token".to_owned());

let channel_id = ChannelId(123);
let message = client
    .create_message(channel_id)
    .content("Twilight is best pony")?
    .tts(true)
    .exec()
    .await?;

Implementations

impl<'a> CreateMessage<'a>

pub fn allowed_mentions(self, allowed_mentions: AllowedMentions) -> Self

Specify the AllowedMentions for the message.

pub fn components(
    self,
    components: &'a [Component]
) -> Result<Self, CreateMessageError>

Add multiple Components to a message.

Calling this method multiple times will clear previous calls.

Errors

Returns an CreateMessageErrorType::ComponentCount error type if too many components are provided.

Returns an CreateMessageErrorType::ComponentInvalid error type if one of the provided components is invalid.

pub fn content(self, content: &'a str) -> Result<Self, CreateMessageError>

Set the content of the message.

The maximum length is 2000 UTF-16 characters.

Errors

Returns a CreateMessageErrorType::ContentInvalid error type if the content length is too long.

pub fn embeds(self, embeds: &'a [Embed]) -> Result<Self, CreateMessageError>

Attach multiple embeds to the message.

Embed total character length must not exceed 6000 characters. Additionally, the internal fields also have character limits. Refer to the discord docs for more information.

Errors

Returns a CreateMessageErrorType::EmbedTooLarge error type if an embed is too large.

pub const fn fail_if_not_exists(self) -> Self

Whether to fail sending if the reply no longer exists.

pub const fn files(self, files: &'a [(&'a str, &'a [u8])]) -> Self

Attach multiple files to the message.

Calling this method will clear any previous calls.

pub const fn nonce(self, nonce: u64) -> Self

Attach a nonce to the message, for optimistic message sending.

pub const fn payload_json(self, payload_json: &'a [u8]) -> Self

JSON encoded body of any additional request fields.

If this method is called, all other fields are ignored, except for files. See Discord Docs/Create Message.

pub const fn reply(self, other: MessageId) -> Self

Specify the ID of another message to create a reply to.

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

Specify true if the message is TTS.

pub fn exec(self) -> ResponseFuture<Message>

Execute the request, returning a future resolving to a Response.