webhook

package
v0.8.7 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 29, 2022 License: Apache-2.0 Imports: 6 Imported by: 46

README

webhook

Webhook module of disgo

Usage

Import the package into your project.

import "github.com/disgoorg/disgo/webhook"

Create a new Webhook by webhook_id and webhook_token. (This WebhookClient should be created once as it holds important state)

client := webhook.NewClient(snowflake.Snowflake("webhookID"), "webhookToken")

webhook.NewClient takes a vararg of type webhook.ConfigOpt as third argument which lets you pass additional optional parameter like a custom logger, rest client, etc

Optional Arguments
client := webhook.NewClient(snowflake.Snowflake("webhookID"), "webhookToken",
	webhook.WithLogger(logrus.New()),
	webhook.WithDefaultAllowedMentions(discord.AllowedMentions{
		RepliedUser: false,
	}),
)
Send Message

You can send a message as following

client := webhook.NewClient(snowflake.Snowflake("webhookID"), "webhookToken")

message, err := client.CreateContent("hello world!")

message, err := client.CreateEmbeds(discord.NewEmbedBuilder().
	SetDescription("hello world!").
	Build(),
)

message, err := client.CreateMessage(webhook.NewWebhookMessageCreateBuilder().
	SetContent("hello world!").
	Build(),
)
Edit Message

Messages can also be edited

client := webhook.NewClient(snowflake.Snowflake("webhookID"), "webhookToken")

message, err := client.UpdateContent("870741249114652722", "hello world!")

message, err := client.UpdateEmbeds("870741249114652722", discord.NewEmbedBuilder().
	SetDescription("hello world!").
	Build(),
)

message, err := client.UpdateMessage("870741249114652722", webhook.NewWebhookMessageUpdateBuilder().
	SetContent("hello world!").
	Build(),
)
Delete Message

or deleted

client := webhook.NewClient(snowflake.Snowflake("webhookID"), "webhookToken")

err := client.DeleteMessage("message_id")
Full Example

a full example can be found here

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Client 

type Client interface {
	// ID returns the configured Webhook id
	ID() snowflake.Snowflake
	// Token returns the configured Webhook token
	Token() string
	// URL returns the full Webhook URL
	URL() string
	// Close closes all connections the Webhook Client has open
	Close(ctx context.Context)
	// Rest returns the underlying rest.Webhooks
	Rest() rest.Webhooks

	// GetWebhook fetches the current Webhook from discord
	GetWebhook(opts ...rest.RequestOpt) (*discord.IncomingWebhook, error)
	// UpdateWebhook updates the current Webhook
	UpdateWebhook(webhookUpdate discord.WebhookUpdateWithToken, opts ...rest.RequestOpt) (*discord.IncomingWebhook, error)
	// DeleteWebhook deletes the current Webhook
	DeleteWebhook(opts ...rest.RequestOpt) error

	// CreateMessage creates a new Message from the discord.WebhookMessageCreate
	CreateMessage(messageCreate discord.WebhookMessageCreate, opts ...rest.RequestOpt) (*discord.Message, error)
	// CreateMessageInThread creates a new Message from the discord.WebhookMessageCreate in the provided thread
	CreateMessageInThread(messageCreate discord.WebhookMessageCreate, threadID snowflake.Snowflake, opts ...rest.RequestOpt) (*discord.Message, error)
	// CreateContent creates a new Message from the provided content
	CreateContent(content string, opts ...rest.RequestOpt) (*discord.Message, error)
	// CreateEmbeds creates a new Message from the provided discord.Embed(s)
	CreateEmbeds(embeds []discord.Embed, opts ...rest.RequestOpt) (*discord.Message, error)

	// UpdateMessage updates an already sent Webhook Message with the discord.WebhookMessageUpdate
	UpdateMessage(messageID snowflake.Snowflake, messageUpdate discord.WebhookMessageUpdate, opts ...rest.RequestOpt) (*discord.Message, error)
	// UpdateMessageInThread updates an already sent Webhook Message with the discord.WebhookMessageUpdate in the provided thread
	UpdateMessageInThread(messageID snowflake.Snowflake, messageUpdate discord.WebhookMessageUpdate, threadID snowflake.Snowflake, opts ...rest.RequestOpt) (*discord.Message, error)
	// UpdateContent updates an already sent Webhook Message with the content
	UpdateContent(messageID snowflake.Snowflake, content string, opts ...rest.RequestOpt) (*discord.Message, error)
	// UpdateEmbeds updates an already sent Webhook Message with the discord.Embed(s)
	UpdateEmbeds(messageID snowflake.Snowflake, embeds []discord.Embed, opts ...rest.RequestOpt) (*discord.Message, error)

	// DeleteMessage deletes an already sent Webhook Message
	DeleteMessage(messageID snowflake.Snowflake, opts ...rest.RequestOpt) error
	// DeleteMessageInThread deletes an already sent Webhook Message in the provided thread
	DeleteMessageInThread(messageID snowflake.Snowflake, threadID snowflake.Snowflake, opts ...rest.RequestOpt) error
}

func NewClient 

func NewClient(id snowflake.Snowflake, token string, opts ...ConfigOpt) Client

NewClient returns a new Client

type ClientImpl 

type ClientImpl struct {
	// contains filtered or unexported fields
}

ClientImpl is used to interact with the discord webhook api

func (*ClientImpl) Close 

func (c *ClientImpl) Close(ctx context.Context)

Close closes all connections the webhook client has open

func (*ClientImpl) CreateContent 

func (c *ClientImpl) CreateContent(content string, opts ...rest.RequestOpt) (*discord.Message, error)

CreateContent creates a new message from the provided content

func (*ClientImpl) CreateEmbeds 

func (c *ClientImpl) CreateEmbeds(embeds []discord.Embed, opts ...rest.RequestOpt) (*discord.Message, error)

CreateEmbeds creates a new message from the provided embeds

func (*ClientImpl) CreateMessage 

func (c *ClientImpl) CreateMessage(messageCreate discord.WebhookMessageCreate, opts ...rest.RequestOpt) (*discord.Message, error)

CreateMessage creates a new message from the discord.WebhookMessageCreate

func (*ClientImpl) CreateMessageInThread 

func (c *ClientImpl) CreateMessageInThread(messageCreate discord.WebhookMessageCreate, threadID snowflake.Snowflake, opts ...rest.RequestOpt) (*discord.Message, error)

CreateMessageInThread creates a new Message in the provided thread

func (*ClientImpl) DeleteMessage 

func (c *ClientImpl) DeleteMessage(messageID snowflake.Snowflake, opts ...rest.RequestOpt) error

DeleteMessage deletes an already sent webhook message

func (*ClientImpl) DeleteMessageInThread 

func (c *ClientImpl) DeleteMessageInThread(messageID snowflake.Snowflake, threadID snowflake.Snowflake, opts ...rest.RequestOpt) error

DeleteMessageInThread deletes an already sent webhook message in a thread

func (*ClientImpl) DeleteWebhook 

func (c *ClientImpl) DeleteWebhook(opts ...rest.RequestOpt) error

DeleteWebhook deletes the current webhook

func (*ClientImpl) GetWebhook 

func (c *ClientImpl) GetWebhook(opts ...rest.RequestOpt) (*discord.IncomingWebhook, error)

GetWebhook fetches the current webhook from discord

func (*ClientImpl) ID 

func (c *ClientImpl) ID() snowflake.Snowflake

func (*ClientImpl) Rest 

func (c *ClientImpl) Rest() rest.Webhooks

func (*ClientImpl) Token 

func (c *ClientImpl) Token() string

func (*ClientImpl) URL 

func (c *ClientImpl) URL() string

URL returns the full webhook URL

func (*ClientImpl) UpdateContent 

func (c *ClientImpl) UpdateContent(messageID snowflake.Snowflake, content string, opts ...rest.RequestOpt) (*discord.Message, error)

UpdateContent updates an already sent webhook message with the content

func (*ClientImpl) UpdateEmbeds 

func (c *ClientImpl) UpdateEmbeds(messageID snowflake.Snowflake, embeds []discord.Embed, opts ...rest.RequestOpt) (*discord.Message, error)

UpdateEmbeds updates an already sent webhook message with the embeds

func (*ClientImpl) UpdateMessage 

func (c *ClientImpl) UpdateMessage(messageID snowflake.Snowflake, messageUpdate discord.WebhookMessageUpdate, opts ...rest.RequestOpt) (*discord.Message, error)

UpdateMessage updates an already sent webhook message with the discord.WebhookMessageUpdate

func (*ClientImpl) UpdateMessageInThread 

func (c *ClientImpl) UpdateMessageInThread(messageID snowflake.Snowflake, messageUpdate discord.WebhookMessageUpdate, threadID snowflake.Snowflake, opts ...rest.RequestOpt) (*discord.Message, error)

UpdateMessageInThread updates an already sent webhook message with the discord.WebhookMessageUpdate in a thread

func (*ClientImpl) UpdateWebhook 

func (c *ClientImpl) UpdateWebhook(webhookUpdate discord.WebhookUpdateWithToken, opts ...rest.RequestOpt) (*discord.IncomingWebhook, error)

UpdateWebhook updates the current webhook

type Config 

type Config struct {
	Logger                 log.Logger
	RestClient             rest.Client
	RestClientConfigOpts   []rest.ConfigOpt
	Webhooks               rest.Webhooks
	DefaultAllowedMentions *discord.AllowedMentions
}

Config is the configuration for the webhook client

func DefaultConfig 

func DefaultConfig() *Config

DefaultConfig is the default configuration for the webhook client

func (*Config) Apply 

func (c *Config) Apply(opts []ConfigOpt)

Apply applies all options to the config

type ConfigOpt 

type ConfigOpt func(config *Config)

ConfigOpt is used to provide optional parameters to the webhook client

func WithDefaultAllowedMentions 

func WithDefaultAllowedMentions(allowedMentions discord.AllowedMentions) ConfigOpt

WithDefaultAllowedMentions sets the default allowed mentions for the webhook client

func WithLogger 

func WithLogger(logger log.Logger) ConfigOpt

WithLogger sets the logger for the webhook client

func WithRestClient 

func WithRestClient(restClient rest.Client) ConfigOpt

WithRestClient sets the rest client for the webhook client

func WithRestClientConfigOpts 

func WithRestClientConfigOpts(opts ...rest.ConfigOpt) ConfigOpt

WithRestClientConfigOpts sets the rest client configuration for the webhook client

func WithWebhooks 

func WithWebhooks(webhooks rest.Webhooks) ConfigOpt

WithWebhooks sets the webhook service for the webhook client

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.