Source code to easily create and send webhooks
| Method | Description | Arguments | Notes |
|---|---|---|---|
AddField | Adds a given field to the webhook | f (Field) | |
AddFields | Adds a given list of fields to the webhook | f ([]Field) | |
CreateAuthor | Creates and sets an author to the webhook | name (string) url (string) iconUrl (string) | |
CreateField | Creates and sets a field to the webhook | name (string) value (string) inline (bool) | |
CreateFooter | Creates and sets a footer to the webhook | text (string) iconUrl (string) | iconUrl can be set to "" (empty string) if no icon is needed |
Send | Sends the webhook to a given url | url (string) | |
SetAuthor | Sets a given author to a given webhook | a (Author) | |
SetAvatarUrl | Sets the icon of the webhook | url (string) | |
SetColor | Sets the color of the embed | color (int) | |
SetContent | Sets the message that appears outside of the embed | content (string) | 2,000 characters max |
SetCurrentTimestamp | Adds the current time to the embed's footer | Sets the time when the method was called | |
SetDescription | Sets the description of the embed | description (string) | |
SetFooter | Sets a given footer to the webhook | f (Footer) | |
SetImage | Sets the image of the embed with a given url | url (string) | |
SetThumbnail | Sets the thumbnail of the embed with a given url | url (string) | |
SetTimestamp | Sets a given time to the embed's footer | t (time.Time) | |
SetTitle | Set the title of the embed | title (string) | |
SetUrl | Makes the title of the embed a hyperlink | url (string) | |
SetUsername | Sets the username of the webhook | name (string) |
- When the
.Send()method is called, it returns an*http.Response. If there are no errors in the webhook, the status code will be204and the body will be empty. - If there are any errors with the webhook (whether a rate limit or invalid data), all of the info will be in the response body. Handling the error is as simple as the following:
package main import ( "encoding/json" "io" "net/http" "time" discordwebhook "github.com/Monumental-Shopping/go-discord-webhook" ) func main() { // Create a new webhook w := discordwebhook.NewWebhook() resp, err := w.Send(WEBHOOK_URL) if err != nil { // TODO handle ur errors here } handleResponse(resp) } func handleResponse(resp *http.Response) { // Make sure to close the body after reading resp.Close = true defer resp.Body.Close() // Parse response body, _ := io.ReadAll(resp.Body) response := &struct { Message string `json:"message"` RetryAfter float64 `json:"retry_after"` }{} json.Unmarshal(body, response) if response.Message == "You are being rate limited." || response.Message == "The resource is being rate limited." { time.Sleep(time.Duration(response.RetryAfter) * time.Second) // TODO retry to send your webhook here w.Send(WEBHOOK_URL) } }- Do not forget the close the response. Not doing so can cause leaks.
package main import ( discordwebhook "github.com/Monumental-Shopping/go-discord-webhook" ) func main() { // Create a new webhook w := discordwebhook.NewWebhook() // Add basic data to the webhook w.SetUsername("Webhook Name") w.SetTitle("Webhook Title") w.SetUrl("https://google.com/") w.SetDescription("Text message. You can use Markdown here. *Italic* **bold** __underline__ ~~strikeout~~ [hyperlink](https://google.com) `code`") // Add a message that is OUTSIDE of the embed. Up to 2000 characters. w.SetContent("Text message. Up to 2000 characters.") // Set the color w.SetColor(99833) // Add fields w.CreateField("Text", "More text", true) w.CreateField("__Even more text__", "**Did you notice the markdown in the ||title||?**", true) w.CreateField("Use `\"inline\": true` parameter, if you want to display fields in the same line.", "okay?", false) // Set some images w.SetThumbnail("https://www.techsmith.com/blog/wp-content/uploads/2021/02/video-thumbnails-hero-1.png") w.SetImage("https://static.wikia.nocookie.net/peanuts/images/1/1e/Joecooltrans.png/revision/latest?cb=20200228013110") // Set the timestamp w.SetCurrentTimestamp() // Send the webhook to the channel w.Send(WEBHOOK_URL) }
package main import ( discordwebhook "github.com/Monumental-Shopping/go-discord-webhook" ) func main() { // Create a new webhook w := discordwebhook.NewWebhook() // Add basic data to the webhook w.SetUsername("Webhook Name") w.SetTitle("Webhook Title") w.SetUrl("https://google.com/") w.SetDescription("Text message. You can use Markdown here. *Italic* **bold** __underline__ ~~strikeout~~ [hyperlink](https://google.com) `code`") // Add a message that is OUTSIDE of the embed. Up to 2000 characters. w.SetContent("Text message. Up to 2000 characters.") // Set the color w.SetColor(696969) // Add fields w.CreateField("Text", "More text", true) w.CreateField("__Even more text__", "**Did you notice the markdown in the ||title||?**", true) w.AddField(discordwebhook.Field{ Name: "Use `\"inline\": true` parameter, if you want to display fields in the same line.", Value: "okay?", }) // Add some more fields fields := []discordwebhook.Field{ { Name: "Some other info", Value: "**please** do not leave the value blank", Inline: true, }, { Name: "One more", Value: "because why not", Inline: true, }, } w.AddFields(fields) // Add an author to the webhook w.SetAuthor(discordwebhook.Author{ Name: "Birdie♫", URL: "https://www.reddit.com/r/cats/", IconURL: "https://i.imgur.com/R66g1Pe.jpg", }) // Add a footer w.SetFooter(discordwebhook.Footer{ Text: "Woah! So cool! :smirk:", IconURL: "https://i.imgur.com/fKL31aD.jpg", }) // Set some images w.SetThumbnail("https://www.techsmith.com/blog/wp-content/uploads/2021/02/video-thumbnails-hero-1.png") w.SetImage("https://static.wikia.nocookie.net/peanuts/images/1/1e/Joecooltrans.png/revision/latest?cb=20200228013110") // Set the timestamp w.SetCurrentTimestamp() // Send the webhook to the channel w.Send(WEBHOOK_URL) }
package main import ( "time" discordwebhook "github.com/Monumental-Shopping/go-discord-webhook" ) func main() { // Create a new webhook w := discordwebhook.NewWebhook() // Add basic data to the webhook w.SetUsername("Webhook Name") w.SetTitle("Webhook Title") w.SetUrl("https://google.com/") w.SetDescription("Text message. You can use Markdown here. *Italic* **bold** __underline__ ~~strikeout~~ [hyperlink](https://google.com) `code`") // Set the color of the webhook w.SetColor(15258703) // Add a message that is OUTSIDE of the embed. Up to 2000 characters. w.SetContent("Text message. Up to 2000 characters.") // Add fields w.CreateField("Text", "More text", true) w.CreateField("__Even more text__", "**Did you notice the markdown in the ||title||?**", true) w.AddField(discordwebhook.Field{ Name: "Use `\"inline\": true` parameter, if you want to display fields in the same line.", Value: "okay?", }) // Add some more fields fields := []discordwebhook.Field{ { Name: "Some other info", Value: "**please** do not leave the value blank", Inline: true, }, { Name: "One more", Value: "because why not", Inline: true, }, } w.AddFields(fields) // Add an author to the webhook w.CreateAuthor("Birdie♫", "https://www.reddit.com/r/cats/", "https://i.imgur.com/R66g1Pe.jpg") // Add a footer w.CreateFooter("Woah! So cool! :smirk:", "https://i.imgur.com/fKL31aD.jpg") // Set some images w.SetThumbnail("https://www.techsmith.com/blog/wp-content/uploads/2021/02/video-thumbnails-hero-1.png") w.SetImage("https://static.wikia.nocookie.net/peanuts/images/1/1e/Joecooltrans.png/revision/latest?cb=20200228013110") // Set the timestamp w.SetTimestamp(time.Unix(21600, 0)) // Send the webhook to the channel w.Send(WEBHOOK_URL) }