Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hugoalh/send-discord-webhook-ghaction
A GitHub Action to send Discord webhook.
https://github.com/hugoalh/send-discord-webhook-ghaction
discord gh-action ghaction github-action webhook
Last synced: about 1 month ago
JSON representation
A GitHub Action to send Discord webhook.
- Host: GitHub
- URL: https://github.com/hugoalh/send-discord-webhook-ghaction
- Owner: hugoalh
- License: other
- Created: 2020-04-28T07:33:16.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-19T03:22:23.000Z (2 months ago)
- Last Synced: 2024-10-19T05:15:57.547Z (2 months ago)
- Topics: discord, gh-action, ghaction, github-action, webhook
- Language: TypeScript
- Homepage: https://github.com/marketplace/actions/send-discord-webhook
- Size: 19.6 MB
- Stars: 10
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Send Discord Webhook (GitHub Action)
[**⚖️** MIT](./LICENSE.md)
[](https://github.com/hugoalh/send-discord-webhook-ghaction)
A GitHub Action to send Discord webhook.
> [!IMPORTANT]
> - This documentation is v7.0.0 based; To view other version's documentation, please visit the [versions list](https://github.com/hugoalh/send-discord-webhook-ghaction/tags) and select the correct version.
## 🌟 Features
- Support attachments/files.
- Support poll.
- Support thread.
## 🔰 Begin
### 🎯 Targets
| | **GitHub** |
|:--|:--|
| **[GitHub Actions Runner](https://github.com/actions/runner)** | [✔️ Docker](https://docs.github.com/en/actions) |
> [!NOTE]
> - It is possible to use this action in other methods/ways which not listed in here, however those methods/ways are not officially supported, and should beware maybe cause security issues.
### #️⃣ Resources Identifier
- **GitHub:**
```
hugoalh/send-discord-webhook-ghaction[@{Tag}]
```
> [!NOTE]
> - It is recommended to use this action with tag for immutability.
### 🛡️ Require GitHub Token Permissions
*This action does not require any GitHub token permission.*
## 🧩 Inputs
Almost all of the inputs are optional, but these groups of inputs must be defined:
- [`key`](#key)
- One of:
- [`content`](#content), [`embeds`](#embeds), and/or [`files`](#files)
- [`poll_question`](#poll_question) and [`poll_answers`](#poll_answers)
- One of:
- *None*
- [`thread_id`](#thread_id)
- [`thread_name`](#thread_name) and optional [`thread_tags`](#thread_tags)
> | **Legend** | **Description** |
> |:-:|:--|
> | 🔐 | Should be an encrypted secret. |
### `key`
**🔐** `` Discord webhook key; These syntaxes are acceptable:
- **Webhook ID & Token:** `{webhook.id}/{webhook.token}`
- **URL:** `https://discord.com/api/webhooks/{webhook.id}/{webhook.token}`
- **URL (Legacy):** `https://discordapp.com/api/webhooks/{webhook.id}/{webhook.token}`
### `username`
`` Override the default webhook username, maximum 80 characters; "Clyde" is not allowed.
### `avatar_url`
`` Override the default webhook avatar, only support URL of HTTP and HTTPS.
### `content`
`` Message content, maximum 2000 characters; Support Discord Markdown.
### `content_links_no_embed`
`` Links' regular expressions to prevent Discord resolve and display matches links in the [`content`](#content) as embed under the message, only support URL of HTTP and HTTPS, separate each value per line.
Examples:
- **All:** `.+`
- **`.png` Image:** `\.png(?:\?|#|$)`
- **`.webp` Image:** `\.webp(?:\?|#|$)`
- **Twitch:** `twitch\.tv`
### `embeds`
`` Message embed rich content, by JSON or YAML with restricted syntaxes, maximum 10 embeds, and maximum 6000 characters for summation from inputs:
- [`embeds[*].title`](#embedstitle)
- [`embeds[*].description`](#embedsdescription)
- [`embeds[*].footer.text`](#embedsfootertext)
- [`embeds[*].author.name`](#embedsauthorname)
- [`embeds[*].fields[*].name`](#embedsfieldsname)
- [`embeds[*].fields[*].value`](#embedsfieldsvalue)
#### `embeds[*].title`
`` Message embed title, maximum 256 characters; Support Discord Markdown.
#### `embeds[*].description`
`` Message embed description, maximum 4096 characters; Support Discord Markdown.
#### `embeds[*].url`
`` Message embed URL.
#### `embeds[*].timestamp`
`` Message embed timestamp, by ISO 8601 format (e.g.: `"2011-11-11T11:11:11Z"`).
#### `embeds[*].color`
`` Message embed colour (i.e.: left border's colour of the embed); These syntax are acceptable:
- **RGB Integer:** `{number}` (e.g.: `2105893`)
- **Hex:** `#{hex}{hex}{hex}` / `#{hex}{hex}{hex}{hex}{hex}{hex}` (e.g.: `#0063B1`)
- **Namespace:** (e.g.: `Blue`)
- **CSS:** (e.g.: `rgb(32, 34, 37)`)
- **Random:** `Random`
- **Special:**
- 
`Discord Embed Default` / `#202225` / `rgb(32, 34, 37)`
- 
`Discord Embed Background Dark` / `#2F3136` / `rgb(47, 49, 54)`
- 
`Discord Blurple` / `#5865F2` / `rgb(88, 101, 242)`
- 
`Discord Fuchsia` / `#EB459E` / `rgb(254, 231, 92)`
- 
`Discord Green` / `#57F287` / `rgb(87, 242, 135)`
- 
`Discord Red` / `#ED4245` / `rgb(237, 66, 69)`
- 
`Discord Yellow` / `#FEE75C` / `rgb(254, 231, 92)`
> [!NOTE]
> - Alpha channel is not supported.
> - General namespace are provided by NPM package [`color-name-list`](https://www.npmjs.com/package/color-name-list), list maybe change or remove without any notification, it is recommended to use value instead.
#### `embeds[*].footer`
`` Message embed footer.
#### `embeds[*].footer.text`
`` Message embed footer text, maximum 2048 characters; Support Discord Markdown.
#### `embeds[*].footer.icon_url`
`` Message embed footer icon, only support URL of HTTP, HTTPS, and attachments.
#### `embeds[*].image`
`` Message embed image.
#### `embeds[*].image.url`
`` Message embed image URL, only support URL of HTTP, HTTPS, and attachments.
#### `embeds[*].thumbnail`
`` Message embed thumbnail.
#### `embeds[*].thumbnail.url`
`` Message embed thumbnail URL, only support URL of HTTP, HTTPS, and attachments.
#### `embeds[*].author`
`` Message embed author.
#### `embeds[*].author.name`
`` Message embed author name, maximum 256 characters.
#### `embeds[*].author.url`
`` Message embed author URL.
#### `embeds[*].author.icon_url`
`` Message embed author icon, only support URL of HTTP, HTTPS, and attachments.
#### `embeds[*].fields`
`` Message embed fields, maximum 25 fields.
#### `embeds[*].fields[*].name`
`` Message embed field name, maximum 256 characters; Support Discord Markdown.
#### `embeds[*].fields[*].value`
`` Message embed field value, maximum 1024 characters; Support Discord Markdown.
#### `embeds[*].fields[*].inline`
`` Whether the message embed field should display inline.
### `poll_question`
`` Message poll question, maximum 300 characters.
### `poll_answers`
`` Message poll answers, by JSON or YAML with restricted syntaxes, maximum 10 answers, and maximum 55 characters per answer text.
Poll answer can either text only, or append emoji with either custom emoji (`id`) or default emoji (`name`).
Example:
```yml
- emoji: # Default
name: "🐈"
text: "Cat"
- emoji: # Default
name: "🐕"
text: "Dog"
- emoji: # Custom
id: "1"
text: "Me"
- text: "Other"
```
### `poll_duration`
`` Message poll duration, by hours, maximum 32 days (i.e.: 768 hours).
### `poll_allow_multiselect`
`` Whether the message poll allow multiple select answers.
### `files`
`` Message attachments/files, by Glob path or literal path (select by input [`files_glob`](#files_glob)) under the workspace, separate each value per line, maximum 8 MB and 10 files.
### `files_glob`
`` Whether input [files](#files) should accept Glob path instead of literal path.
### `allowed_mentions_parse_everyone`
`` Whether the message allowed `@everyone` and `@here` mentions.
### `allowed_mentions_parse_roles`
`` Whether the message allowed roles mentions.
### `allowed_mentions_parse_users`
`` Whether the message allowed users mentions.
### `allowed_mentions_roles`
`` Message allowed mention roles, by role ID, separate each value with comma (`,`) or per line, maximum 100 roles.
### `allowed_mentions_users`
`` Message allowed mention users, by user ID, separate each value with comma (`,`) or per line, maximum 100 users.
### `tts`
`` Whether the message use TTS (Text To Speech).
### `thread_id`
`` Message channel thread ID. When this input is defined, the message will send to the specify thread, the thread will automatically unarchive.
### `thread_name`
`` Forum channel thread name, maximum 100 characters. When this input is defined, the message will create a new thread with the name.
### `thread_tags`
`` Forum channel thread tags, by thread tag ID, separate each value with comma (`,`) or per line, maximum 5 tags.
### `notification`
`` Whether the message trigger push and desktop notifications.
### `truncate_enable`
`` Whether to try truncate firstly when inputs are too large. Truncate will not work on inputs:
- [`poll_question`](#poll_question)
- [`poll_answers`](#poll_answers)
### `truncate_ellipsis`
`` Ellipsis mark.
### `truncate_position`
`` Ellipsis position.
- **`"end"`:** At the end of the string.
- **`"middle"`:** At the middle of the string.
- **`"start"`:** At the start of the string.
### `wait`
`` Whether to wait for Discord confirmation of message send before response, and returns the created message body. When this input is `false`, a message that is not saved does not return an error.
## 🧩 Outputs
### `response`
`` Response content.
### `status_code`
`` Request status code.
### `status_ok`
`` Whether the request was successful.
### `status_text`
`` Request status text.
## ✍️ Examples
- Hello, world!
```yml
jobs:
job_id:
name: "Send Discord Webhook"
runs-on: "ubuntu-latest"
steps:
- uses: "hugoalh/[email protected]"
with:
key: "${{secrets.DISCORD_WEBHOOK_KEY}}"
content: "Hello, world!"
```
- birdie0 (from [birdie0's Discord Webhooks Guide](https://birdie0.github.io/discord-webhooks-guide/discord_webhook.html))
```yml
jobs:
job_id:
name: "Send Discord Webhook"
runs-on: "ubuntu-latest"
steps:
- uses: "hugoalh/[email protected]"
with:
key: "${{secrets.DISCORD_WEBHOOK_KEY}}"
username: "Webhook"
avatar_url: "https://i.imgur.com/4M34hi2.png"
content: "Text message. Up to 2000 characters."
embeds: |
[
{
"author": {
"name": "Birdie♫",
"url": "https://www.reddit.com/r/cats/",
"icon_url": "https://i.imgur.com/R66g1Pe.jpg"
},
"title": "Title",
"url": "https://google.com/",
"description": "Text message. You can use Markdown here. *Italic* **bold** __underline__ ~~strikeout~~ [hyperlink](https://google.com) `code`",
"color": 15258703,
"fields": [
{
"name": "Text",
"value": "More text",
"inline": true
},
{
"name": "Even more text",
"value": "Yup",
"inline": true
},
{
"name": "Use `\"inline\": true` parameter, if you want to display fields in the same line.",
"value": "okay..."
},
{
"name": "Thanks!",
"value": "You're welcome :wink:"
}
],
"thumbnail": {
"url": "https://upload.wikimedia.org/wikipedia/commons/3/38/4-Nature-Wallpapers-2014-1_ukaavUI.jpg"
},
"image": {
"url": "https://upload.wikimedia.org/wikipedia/commons/5/5a/A_picture_from_China_every_day_108.jpg"
},
"footer": {
"text": "Woah! So cool! :smirk:",
"icon_url": "https://i.imgur.com/fKL31aD.jpg"
}
}
]
```
## 📚 Guides
- Discord
- [Execute Webhook](https://discord.com/developers/docs/resources/webhook#execute-webhook)
- [Intro to Webhooks](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks)
- GitHub Actions
- [Enabling debug logging](https://docs.github.com/en/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging)
- [Encrypted secrets](https://docs.github.com/en/actions/security-guides/encrypted-secrets)