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.

Follow the instructions here. It only takes a minute.

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

Create val
import { discordWebhook } from "https://esm.town/v/stevekrouse/discordWebhook/main.ts";

await discordWebhook({ content: "Hi from val town!" });

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

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.

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

When true (the default), adds an "Edit Val" button to your Discord message that links back to the val. Set to false to disable this button.

Create val
// With the Edit Val button (default)
await discordWebhook({ content: "Check this out!" });

// Without the Edit Val button
await discordWebhook({ content: "Check this out!", editValButton: false });

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