Class Webhook

Represents a webhook.

Hierarchy

Base
- Webhook

Index

Constructors

constructor

new Webhook(data: RawWebhook, client: Client<ClientEvents>): Webhook
Parameters
- data: RawWebhook
- client: Client<ClientEvents>
Returns Webhook
Overrides Base.constructor
- Defined in lib/structures/Webhook.ts:48

Properties

`Optional` application

application?: null | ClientApplication

The application associated with this webhook.

applicationID

applicationID: null | string

The ID of the application associated with this webhook.

avatar

avatar: null | string

The hash of this webhook's avatar.

channelID

channelID: null | string

The ID of the channel this webhook is for, if applicable.

client

client: Client<ClientEvents>

guildID

guildID: null | string

The id of the guild this webhook is in, if applicable.

id

id: string

name

name: null | string

The username of this webhook, if any.

`Optional` sourceChannel

sourceChannel?: Pick<RawChannel, "name" | "id">

The source channel for this webhook (channel follower only).

`Optional` sourceGuild

sourceGuild?: Pick<RawGuild, "name" | "id" | "icon">

The source guild for this webhook (channel follower only).

`Optional` token

token?: string

The token for this webhook (not present for webhooks created by other applications)

type

type: WebhookTypes

The type of this webhook.

user

user: null | User

The user that created this webhook.

Accessors

channel

get channel(): undefined | null | AnyGuildTextChannel
The channel this webhook is for, if applicable.

Returns undefined | null | AnyGuildTextChannel
- Defined in lib/structures/Webhook.ts:64

createdAt

get createdAt(): Date
Returns Date
Inherited from Base.createdAt
- Defined in lib/structures/Base.ts:31

guild

get guild(): null | Guild
The guild this webhook is for, if applicable. This will throw an error if the guild is not cached.

Returns null | Guild
- Defined in lib/structures/Webhook.ts:73

url

get url(): string
Returns string
- Defined in lib/structures/Webhook.ts:89

Methods

avatarURL

avatarURL(format?: "jpg" | "jpeg" | "png" | "webp" | "gif", size?: number): null | string
The url of this webhook's avatar.
Parameters
- Optional format: "jpg" | "jpeg" | "png" | "webp" | "gif"
  
  The format the url should be.
- Optional size: number
  
  The dimensions of the image.
Returns null | string
- Defined in lib/structures/Webhook.ts:98

delete

delete(reason?: string): Promise<void>
Delete this webhook (requires a bot user, see deleteToken).
Parameters
- Optional reason: string
  
  The reason for deleting this webhook.
Returns Promise<void>
- Defined in lib/structures/Webhook.ts:106

deleteMessage

deleteMessage(messageID: string, options?: DeleteWebhookMessageOptions, token?: string): Promise<void>
Delete a message from this webhook.
Parameters
- messageID: string
  
  The ID of the message.
- Optional options: DeleteWebhookMessageOptions
  
  The options for deleting the message.
- Optional token: string
  
  The token for the webhook, if not already present.
Returns Promise<void>
- Defined in lib/structures/Webhook.ts:116

deleteToken

deleteToken(token?: string): Promise<void>
Delete this webhook via its token.
Parameters
- Optional token: string
  
  The token for the webhook, if not already present.
Returns Promise<void>
- Defined in lib/structures/Webhook.ts:128

edit

edit(options: EditWebhookOptions): Promise<Webhook>
Edit this webhook (requires a bot user, see editToken).
Parameters
- options: EditWebhookOptions
  
  The options for editing the webhook.
Returns Promise<Webhook>
- Defined in lib/structures/Webhook.ts:140

editMessage

editMessage<T>(messageID: string, options: EditWebhookMessageOptions, token?: string): Promise<Message<T>>
Edit a webhook message.
Type Parameters
- T extends AnyGuildTextChannel = AnyGuildTextChannel
Parameters
- messageID: string
  
  The ID of the message to edit.
- options: EditWebhookMessageOptions
  
  The options for editing the message.
- Optional token: string
  
  The token of the webhook.
Returns Promise<Message<T>>
- Defined in lib/structures/Webhook.ts:151

editToken

editToken(options: EditWebhookOptions, token?: string): Promise<Webhook>
Edit a webhook via its token.
Parameters
- options: EditWebhookOptions
  
  The options for editing the webhook.
- Optional token: string
  
  The token for the webhook, if not already present.
Returns Promise<Webhook>
- Defined in lib/structures/Webhook.ts:164

execute

execute<T>(options: ExecuteWebhookWaitOptions, token?: string): Promise<Message<T>>
Execute the webhook.
Type Parameters
- T extends AnyGuildTextChannel
Parameters
- options: ExecuteWebhookWaitOptions
  
  The options for executing the webhook.
- Optional token: string
  
  The token for the webhook, if not already present.
Returns Promise<Message<T>>
- Defined in lib/structures/Webhook.ts:177
execute(options: ExecuteWebhookOptions, token?: string): Promise<void>
Parameters
- options: ExecuteWebhookOptions
- Optional token: string
Returns Promise<void>
- Defined in lib/structures/Webhook.ts:178

executeGithub

executeGithub(options: Record<string, unknown> & {
wait: false;
}, token?: string): Promise<void>
Execute this webhook as GitHub compatible.
Parameters
- options: Record<string, unknown> & {
  wait: false;
  }
  
  The options to send. See GitHub's documentation for more information.
- Optional token: string
  
  The token for the webhook, if not already present.
Returns Promise<void>
- Defined in lib/structures/Webhook.ts:192
executeGithub<T>(options: Record<string, unknown> & {
wait?: true;
}, token?: string): Promise<Message<T>>
Type Parameters
- T extends AnyGuildTextChannel
Parameters
- options: Record<string, unknown> & {
  wait?: true;
  }
- Optional token: string
Returns Promise<Message<T>>
- Defined in lib/structures/Webhook.ts:193

executeSlack

executeSlack(options: Record<string, unknown> & {
wait: false;
}, token?: string): Promise<void>
Execute this webhook as slack compatible.
Parameters
- options: Record<string, unknown> & {
  wait: false;
  }
  
  The options to send. See Slack's Documentation for more information.
- Optional token: string
  
  The token for the webhook, if not already present.
Returns Promise<void>
- Defined in lib/structures/Webhook.ts:207
executeSlack<T>(options: Record<string, unknown> & {
wait?: true;
}, token?: string): Promise<Message<T>>
Type Parameters
- T extends AnyGuildTextChannel
Parameters
- options: Record<string, unknown> & {
  wait?: true;
  }
- Optional token: string
Returns Promise<Message<T>>
- Defined in lib/structures/Webhook.ts:208

getMessage

getMessage<T>(messageID: string, threadID?: string, token?: string): Promise<Message<T>>
Get a webhook message.
Type Parameters
- T extends AnyGuildTextChannel
Parameters
- messageID: string
  
  The ID of the message.
- Optional threadID: string
  
  The ID of the thread the message is in.
- Optional token: string
  
  The token for the webhook, if not already present.
Returns Promise<Message<T>>
- Defined in lib/structures/Webhook.ts:223

sourceGuildIconURL

sourceGuildIconURL(format?: "jpg" | "jpeg" | "png" | "webp" | "gif", size?: number): null | string
The url of this webhook's sourceGuild icon (only present on channel follower webhooks).
Parameters
- Optional format: "jpg" | "jpeg" | "png" | "webp" | "gif"
  
  The format the url should be.
- Optional size: number
  
  The dimensions of the image.
Returns null | string
- Defined in lib/structures/Webhook.ts:236

toJSON

toJSON(): JSONWebhook
Returns JSONWebhook
Overrides Base.toJSON
- Defined in lib/structures/Webhook.ts:240

toString

toString(): string
Returns string
Inherited from Base.toString
- Defined in lib/structures/Base.ts:56

`Static` getCreatedAt

getCreatedAt(id: string): Date
Parameters
- id: string
Returns Date
Inherited from Base.getCreatedAt
- Defined in lib/structures/Base.ts:20

`Static` getDiscordEpoch

getDiscordEpoch(id: string): number
Parameters
- id: string
Returns number
Inherited from Base.getDiscordEpoch
- Defined in lib/structures/Base.ts:24

Class Webhook

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

data: RawWebhook

client: Client<ClientEvents>

Returns Webhook

Properties

Optional application

applicationID

avatar

channelID

client

guildID

id

name

Optional sourceChannel

Optional sourceGuild

Optional token

type

user

Accessors

channel

Returns undefined | null | AnyGuildTextChannel

createdAt

Returns Date

guild

Returns null | Guild

url

Returns string

Methods

avatarURL

Parameters

Optional format: "jpg" | "jpeg" | "png" | "webp" | "gif"

Optional size: number

Returns null | string

delete

Parameters

Optional reason: string

Returns Promise<void>

deleteMessage

Parameters

messageID: string

Optional options: DeleteWebhookMessageOptions

Optional token: string

Returns Promise<void>

deleteToken

Parameters

Optional token: string

Returns Promise<void>

edit

Parameters

options: EditWebhookOptions

Returns Promise<Webhook>

editMessage

Type Parameters

T extends AnyGuildTextChannel = AnyGuildTextChannel

Parameters

messageID: string

options: EditWebhookMessageOptions

Optional token: string

Returns Promise<Message<T>>

editToken

Parameters

options: EditWebhookOptions

Optional token: string

Returns Promise<Webhook>

execute

Type Parameters

T extends AnyGuildTextChannel

Parameters

options: ExecuteWebhookWaitOptions

Optional token: string

Returns Promise<Message<T>>

`Optional` application

`Optional` sourceChannel

`Optional` sourceGuild

`Optional` token

`Optional` format: "jpg" | "jpeg" | "png" | "webp" | "gif"

`Optional` size: number

`Optional` reason: string

`Optional` options: DeleteWebhookMessageOptions

`Optional` token: string

`Optional` token: string

`Optional` token: string

`Optional` token: string

`Optional` token: string

`Optional` token: string

options: Record<string, unknown> & {
wait: false;
}

`Optional` token: string

options: Record<string, unknown> & {
wait?: true;
}

`Optional` token: string

options: Record<string, unknown> & {
wait: false;
}

`Optional` token: string

options: Record<string, unknown> & {
wait?: true;
}

`Optional` token: string

`Optional` threadID: string

`Optional` token: string

`Optional` format: "jpg" | "jpeg" | "png" | "webp" | "gif"

`Optional` size: number

`Static` getCreatedAt

`Static` getDiscordEpoch