Send a Discord message

Send a message to a Discord channel. It's useful for notifying your team or community when someone interesting happens, like a user signup, Stripe payment, mention on social media, etc.

Usage

1. Create a Discord Webhook

Follow the instructions here. It only takes a minute.

2. Copy webhook URL

Paste the webhook URL into your val's environment variables as DISCORD_WEBHOOK_URL.

3. Send a message!

import { discordWebhook } from "https://esm.town/v/stevekrouse/discordWebhook/main.ts"; await discordWebhook({ content: "Hi from val town!" });

Parameters

content

Any text, rendered as markdown. If over 2000 characters, we will truncate it to the first 2000 for you.

url

You can pass the webhook url as a parameter explicitly. Otherwise, this helper function will implicitly look in your env variables under DISCORD_WEBHOOK_URL.

flags

ie "SUPPRESS_EMBEDS". Learn more about flag options here.

Contributing

This helper function only supports content and flags as parameters. There are other parameters that Discord supports. PRs welcome!