WorqHat
Utility

Send Discord Message

Category
Communication
Node Type
Utility

Overview

The Send Discord Message node posts messages to a Discord channel using a webhook. Use it for alerts, summaries, notifications, and community updates directly from your workflow.

Description

Post updates to Discord.

Provide a Discord webhook URL and message content. You can send simple text messages or rich embeds with titles, colors, and images.

Alerts & Logs

Notify your team about system events or errors.

Community Updates

Post announcements to public channels automatically.

Input Parameters

Configure the message content.

webhookUrlstringRequired
The Discord webhook URL.
Example
"https://discord.com/api/webhooks/..."
messagestringRequired
Main text content of the message.
Example
"Build successful!"
titlestringOptional
Title for the embed.
colorstringOptional
Embed color (decimal or hex).
Example
"65280"
imagestringOptional
URL of an image to include.

Output Parameters

The node returns the delivery status.

deliveryStatusstringOptional
'success' or 'failed'.
responseStatusnumberOptional
HTTP status code (e.g., 204).

Output Type

Output Type: JSON

Returns a JSON object confirming the message delivery.

Example Usage

Example 1: Simple Notification

Send a text message.

{  "webhookUrl": "https://discord.com/api/webhooks/...",  "message": "New user signed up: Jane Doe"}
{  "deliveryStatus": "success",  "responseStatus": 204}

Example 2: Rich Embed

Send a styled alert.

{  "webhookUrl": "https://discord.com/api/webhooks/...",  "title": "Deployment Success",  "message": "Version 2.0 is live.",  "color": "5763719"}
{  "deliveryStatus": "success",  "responseStatus": 204}

How to Use in a No-Code Workflow

1

Add the Node

Place the Send Discord Message node in your workflow.

2

Get Webhook

Paste your Discord Webhook URL (see guide below).

3

Compose Message

Enter the message text and optional title or color.

4

Run

Execute the node to post the message to the channel.

Create a Discord Webhook URL

Follow these steps to generate a webhook URL for your server:

1

Server Settings

Open Discord, click the arrow next to your server name, and select Server Settings.

2

Integrations

Go to Integrations in the sidebar and click on Webhooks.

3

Create Webhook

Click New Webhook. Give it a name and choose the Channel where it will post.

4

Copy URL

Click Copy Webhook URL. Use this URL in the node's webhookUrl field.

Keep your webhook URL secure. Anyone with this URL can post messages to your channel.

Best Practices

  • Use embeds for structured, professional-looking updates.
  • Rate-limit your messages to avoid being blocked by Discord.

Do / Don’t

Do
  • ✔️ Use distinct colors for different alert types (e.g., Red for Error, Green for Success).
  • ✔️ Include timestamps or IDs in the message for reference.
Don’t
  • ❌ Don’t post sensitive user data (PII) to public channels.
  • ❌ Don’t spam the channel with high-frequency logs.

Common Errors

Invalid webhookErrorOptional
The URL is incorrect or the webhook was deleted.
Request blockedErrorOptional
You are sending messages too quickly (Rate Limited).

Example Workflow Integration

Use Case: CI/CD Pipeline Alert

Notify the team when a build completes.

  1. Webhook Trigger: Build system sends status.
  2. If/Else: Check if success or failure.
  3. Discord Message: Send green embed for success, red for failure.

Workflow Data Flow:

{{build.status}} → {{condition.value}}
{{build.logs}} → {{discord.message}}