workgroups/vendor/github.com/DisgoOrg/disgohook
Marvin Preuss 1d4ae27878
All checks were successful
continuous-integration/drone/push Build is passing
ci: drone yaml with reusable anchors
2021-09-24 17:34:17 +02:00
..
api ci: drone yaml with reusable anchors 2021-09-24 17:34:17 +02:00
internal ci: drone yaml with reusable anchors 2021-09-24 17:34:17 +02:00
.gitignore ci: drone yaml with reusable anchors 2021-09-24 17:34:17 +02:00
disgohook.go ci: drone yaml with reusable anchors 2021-09-24 17:34:17 +02:00
LICENSE ci: drone yaml with reusable anchors 2021-09-24 17:34:17 +02:00
README.md ci: drone yaml with reusable anchors 2021-09-24 17:34:17 +02:00

disgohook

Go Reference Go Report Go Version License Disgo Version Disgo Discord

DisgoHook is a simple Discord Webhook library written in Go aimed to be easy to use

Getting Started

Installing

go get github.com/DisgoOrg/disgohook

Usage

Import the package into your project.

import "github.com/DisgoOrg/disgohook"

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

As first param you can optionally pass your own *http.Client and as second parameter you can pass your own logger implementing this interface. This webhook then can be used to send, edit and delete messages

Send Message

webhook, err := disgohook.NewWebhookClientByToken(nil, nil, "webhook_id/webhook_token")

message, err := webhook.SendContent("hello world!")
message, err := webhook.SendEmbeds(api.NewEmbedBuilder().
	SetDescription("hello world!").
	Build(),
)
message, err := webhook.SendMessage(api.NewWebhookMessageCreateBuilder().
	SetContent("hello world!").
	Build(),
)

Edit Message

webhook, err := disgohook.NewWebhookClientByToken(nil, nil, "webhook_id/webhook_token")

message, err := webhook.EditContent("870741249114652722", "hello world!")
message, err := webhook.EditEmbeds("870741249114652722", 
	api.NewEmbedBuilder().
	SetDescription("hello world!").
	Build(),
)
message, err := webhook.EditMessage("870741249114652722", 
	api.NewWebhookMessageUpdateBuilder().
	SetContent("hello world!").
	Build(), 
)

Delete Message

webhook, err := disgohook.NewWebhookClientByToken(nil, nil, "webhook_id/webhook_token")

err := webhook.DeleteMessage("870741249114652722")

Documentation

Documentation is unfinished and can be found under

  • Go Reference
  • Discord Webhook Documentation

Examples

You can find examples under example and dislog

Troubleshooting

For help feel free to open an issues or reach out on Discord

Contributing

Contributions are welcomed but for bigger changes please first reach out via Discord or create an issue to discuss your intentions and ideas.

License

Distributed under the License . See LICENSE for more information.