[−][src]Struct serenity::model::webhook::Webhook
A representation of a webhook, which is a low-effort way to post messages to channels. They do not necessarily require a bot user or authentication to use.
Fields
id: WebhookId
The unique Id.
Can be used to calculate the creation date of the webhook.
avatar: Option<String>
The default avatar.
This can be modified via ExecuteWebhook::avatar
.
channel_id: ChannelId
The Id of the channel that owns the webhook.
guild_id: Option<GuildId>
The Id of the guild that owns the webhook.
name: Option<String>
The default name of the webhook.
This can be modified via ExecuteWebhook::username
.
token: String
The webhook's secure token.
user: Option<User>
The user that created the webhook.
Note: This is not received when getting a webhook by its token.
Methods
impl Webhook
[src]
impl Webhook
pub fn delete(&self) -> Result<()>
[src]
pub fn delete(&self) -> Result<()>
Deletes the webhook.
As this calls the http::delete_webhook_with_token
function,
authentication is not required.
pub fn edit(&mut self, name: Option<&str>, avatar: Option<&str>) -> Result<()>
[src]
pub fn edit(&mut self, name: Option<&str>, avatar: Option<&str>) -> Result<()>
Edits the webhook in-place. All fields are optional.
To nullify the avatar, pass Some("")
. Otherwise, passing None
will
not modify the avatar.
Refer to http::edit_webhook
for httprictions on editing webhooks.
As this calls the http::edit_webhook_with_token
function,
authentication is not required.
Examples
Editing a webhook's name:
use serenity::http; let id = 245037420704169985; let token = "ig5AO-wdVWpCBtUUMxmgsWryqgsW3DChbKYOINftJ4DCrUbnkedoYZD0VOH1QLr-S3sV"; let mut webhook = http::get_webhook_with_token(id, token) .expect("valid webhook"); let _ = webhook.edit(Some("new name"), None).expect("Error editing");
Setting a webhook's avatar:
use serenity::http; let id = 245037420704169985; let token = "ig5AO-wdVWpCBtUUMxmgsWryqgsW3DChbKYOINftJ4DCrUbnkedoYZD0VOH1QLr-S3sV"; let mut webhook = http::get_webhook_with_token(id, token) .expect("valid webhook"); let image = serenity::utils::read_image("./webhook_img.png") .expect("Error reading image"); let _ = webhook.edit(None, Some(&image)).expect("Error editing");
pub fn execute<F: FnOnce(ExecuteWebhook) -> ExecuteWebhook>(
&self,
wait: bool,
f: F
) -> Result<Option<Message>>
[src]
pub fn execute<F: FnOnce(ExecuteWebhook) -> ExecuteWebhook>(
&self,
wait: bool,
f: F
) -> Result<Option<Message>>
Executes a webhook with the fields set via the given builder.
The builder provides a method of setting only the fields you need, without needing to pass a long set of arguments.
Examples
Execute a webhook with message content of test
:
use serenity::http; let id = 245037420704169985; let token = "ig5AO-wdVWpCBtUUMxmgsWryqgsW3DChbKYOINftJ4DCrUbnkedoYZD0VOH1QLr-S3sV"; let mut webhook = http::get_webhook_with_token(id, token) .expect("valid webhook"); let _ = webhook.execute(false, |w| w.content("test")).expect("Error executing");
Execute a webhook with message content of test
, overriding the
username to serenity
, and sending an embed:
use serenity::http; use serenity::model::channel::Embed; let id = 245037420704169985; let token = "ig5AO-wdVWpCBtUUMxmgsWryqgsW3DChbKYOINftJ4DCrUbnkedoYZD0VOH1QLr-S3sV"; let mut webhook = http::get_webhook_with_token(id, token) .expect("valid webhook"); let embed = Embed::fake(|e| e .title("Rust's website") .description("Rust is a systems programming language that runs blazingly fast, prevents segfaults, and guarantees thread safety.") .url("https://rust-lang.org")); let _ = webhook.execute(false, |w| w .content("test") .username("serenity") .embeds(vec![embed])) .expect("Error executing");
pub fn refresh(&mut self) -> Result<()>
[src]
pub fn refresh(&mut self) -> Result<()>
Retrieves the latest information about the webhook, editing the webhook in-place.
As this calls the http::get_webhook_with_token
function,
authentication is not required.
Trait Implementations
impl Clone for Webhook
[src]
impl Clone for Webhook
fn clone(&self) -> Webhook
[src]
fn clone(&self) -> Webhook
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
impl Debug for Webhook
[src]
impl Debug for Webhook
fn fmt(&self, f: &mut Formatter) -> Result
[src]
fn fmt(&self, f: &mut Formatter) -> Result
Formats the value using the given formatter. Read more
impl Serialize for Webhook
[src]
impl Serialize for Webhook
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
__S: Serializer,
[src]
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
__S: Serializer,
Serialize this value into the given Serde serializer. Read more
impl<'de> Deserialize<'de> for Webhook
[src]
impl<'de> Deserialize<'de> for Webhook
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
[src]
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
Auto Trait Implementations
Blanket Implementations
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
type Owned = T
fn to_owned(&self) -> T
[src]
fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
fn clone_into(&self, target: &mut T)
[src]
fn clone_into(&self, target: &mut T)
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
impl<T> From for T
[src]
impl<T> From for T
impl<T, U> TryFrom for T where
T: From<U>,
[src]
impl<T, U> TryFrom for T where
T: From<U>,
type Error = !
try_from
)The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
try_from
)Performs the conversion.
impl<T> Borrow for T where
T: ?Sized,
[src]
impl<T> Borrow for T where
T: ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
impl<T> BorrowMut for T where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
try_from
)The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
try_from
)Performs the conversion.
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Any for T where
T: 'static + ?Sized,
fn get_type_id(&self) -> TypeId
[src]
fn get_type_id(&self) -> TypeId
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static
Gets the TypeId
of self
. Read more
impl<T> DeserializeOwned for T where
T: Deserialize<'de>,
[src]
impl<T> DeserializeOwned for T where
T: Deserialize<'de>,
impl<T> Erased for T
impl<T> Erased for T
impl<T> Typeable for T where
T: Any,
impl<T> Typeable for T where
T: Any,
impl<T> DebugAny for T where
T: Any + Debug,
[src]
impl<T> DebugAny for T where
T: Any + Debug,
impl<T> CloneAny for T where
T: Clone + Any,
[src]
impl<T> CloneAny for T where
T: Clone + Any,
fn clone_any(&self) -> Box<dyn CloneAny + 'static>
[src]
fn clone_any(&self) -> Box<dyn CloneAny + 'static>
fn clone_any_send(&self) -> Box<dyn CloneAny + 'static + Send> where
T: Send,
[src]
fn clone_any_send(&self) -> Box<dyn CloneAny + 'static + Send> where
T: Send,
fn clone_any_sync(&self) -> Box<dyn CloneAny + 'static + Sync> where
T: Sync,
[src]
fn clone_any_sync(&self) -> Box<dyn CloneAny + 'static + Sync> where
T: Sync,
fn clone_any_send_sync(&self) -> Box<dyn CloneAny + 'static + Sync + Send> where
T: Send + Sync,
[src]
fn clone_any_send_sync(&self) -> Box<dyn CloneAny + 'static + Sync + Send> where
T: Send + Sync,
impl<T> UnsafeAny for T where
T: Any,
impl<T> UnsafeAny for T where
T: Any,