5This template will help you:
61. Search for specific mentions on Twitter/X using customizable keywords.
72. Deliver notifications wherever you'd like (email, Discord, Slack, Telegram, etc).
8
9## Example
10This val tracks mentions of "Val Town" and related terms, excluding noise like retweets and irrelevant accounts. Notifications are sent to a Discord webhook but can be easily reconfigured for other platforms.
11<img src="https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/85912106-f625-443e-5321-6e2699453200/public" width="500"/>
12To see exactly how we use this template at Val Town: https://www.val.town/v/stevekrouse/twitterAlert
37### 5. Choose Notification Method
38
39This template uses a Discord webhook for notifications, but
40you can update this to your preferred platform by replacing the `discordWebhook` call
41with a call to [Slack](https://docs.val.town/integrations/slack/send-messages-to-slack/), [`@std/email`](https://docs.val.town/std/email/), etc.
42
43**Create a Discord webhook following [this guide](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks).**
44
45Save your Discord Webhook URL in your [Val Town environment variables](https://www.val.town/settings/environment-variables):
46- Key: `mentionsDiscord`
47- Value: Your Discord webhook URL.
48Notifications will be sent using this function:
49
50```ts
51await discordWebhook({
52 url: Deno.env.get("mentionsDiscord"),
53 content,
54});
1import { discordWebhook } from "https://esm.town/v/stevekrouse/discordWebhook";
2import { socialDataSearch, Tweet } from "https://esm.town/v/stevekrouse/socialDataSearch";
3
25
26 // Format notification content as a list of Tweet URLs
27 // Using fxtwitter, which fixes Twitter Embed Unfurls for Discord
28 const content = response.tweets?.map(({ user: { screen_name }, id_str }) =>
29 `https://fxtwitter.com/${screen_name}/status/${id_str}`
39 // Send notifications (only if isProd is set to true)
40 if (isProd && content?.length) {
41 await discordWebhook({
42 url: Deno.env.get("mentionsDiscord"), // Replace with your Discord webhook URL or other notification method
43 content,
44 });
1226 <a href="?q=image" className="example-link">image</a>
1227 <a href="?q=function" className="example-link">function</a>
1228 <a href="?q=discord" className="example-link">discord</a>
1229 <a href="?q=openai" className="example-link">openai</a>
1230 <a href="?q=react" className="example-link">react</a>
1380 <a href="?q=image" className="example-link">image</a>
1381 <a href="?q=function" className="example-link">function</a>
1382 <a href="?q=discord" className="example-link">discord</a>
1383 <a href="?q=openai" className="example-link">openai</a>
1384 <a href="?q=react" className="example-link">react</a>
1import { discordWebhook } from "https://esm.town/v/stevekrouse/discordWebhook";
2import { socialDataSearch, Tweet } from "https://esm.town/v/stevekrouse/socialDataSearch";
3
26
27 // Format notification content as a list of Tweet URLs
28 // Using fxtwitter, which fixes Twitter Embed Unfurls for Discord
29 const content = response.tweets?.map(({ user: { screen_name }, id_str }) =>
30 `https://fxtwitter.com/${screen_name}/status/${id_str}`
40 // Send notifications (only if isProd is set to true)
41 if (isProd && content?.length) {
42 await discordWebhook({
43 url: Deno.env.get("mentionsDiscord"), // Replace with your Discord webhook URL or other notification method
44 content,
45 });
5This template will help you:
61. Search for specific mentions on Twitter/X using customizable keywords.
72. Deliver notifications wherever you'd like (email, Discord, Slack, Telegram, etc).
8
9## Example
10This val tracks mentions of "Val Town" and related terms, excluding noise like retweets and irrelevant accounts. Notifications are sent to a Discord webhook but can be easily reconfigured for other platforms.
11<img src="https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/85912106-f625-443e-5321-6e2699453200/public" width="500"/>
12To see exactly how we use this template at Val Town: https://www.val.town/x/stevekrouse/twitterAlert
37### 5. Choose Notification Method
38
39This template uses a Discord webhook for notifications, but
40you can update this to your preferred platform by replacing the `discordWebhook` call
41with a call to [Slack](https://docs.val.town/integrations/slack/send-messages-to-slack/), [`@std/email`](https://docs.val.town/std/email/), etc.
42
43**Create a Discord webhook following [this guide](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks).**
44
45Save your Discord Webhook URL in your Environment Variables (you can find this on the left sidebar):
46- Key: `mentionsDiscord`
47- Value: Your Discord webhook URL.
48Notifications will be sent using this function:
49
50```ts
51await discordWebhook({
52 url: Deno.env.get("mentionsDiscord"),
53 content,
54});
10Feel free to edit these examples or add new files to your project.
11
12For inspiration, check out our [Docs](https://docs.val.town/), [Templates](https://www.val.town/explore/use-cases), [Showcase](https://www.val.town/explore/community-showcase) and [Discord](https://discord.val.town/)!
13
14Stay as long as you'd like in this project, or head to your main [dashboard](/dashboard) to keep exploring the rest of Val Town.
5This template will help you:
61. Search Hacker News for specific keywords.
72. Send notifications to your preferred platform (Discord, Slack, email, etc.), the default in this template is Discord.
8
9---
10
11## Example
12This val tracks mentions of "Val Town" on Hacker News and sends updates to a Discord webhook.
13
14
34
35### 5. Set Up Your Notification Method
36This template uses a Discord webhook for notifications. You can update this to your preferred platform:
37
38**Create a Discord webhook following [this guide](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks).**
39Save your webhook URL in your Val Town environment variables (you can find this on the left sidebar):
40- Key: `mentionsDiscord`
41- Value: Your Discord webhook URL.
42Notifications will be sent using this function:
43```
44 await discordWebhook({
45 url: Deno.env.get("mentionsDiscord"),
46 content,
47 });
48```
49
50To switch to another platform (e.g., Slack, email, or custom webhooks), replace the discordWebhook call with the appropriate integration ((e.g., [`@std/email`](https://docs.val.town/std/email/), [Slack](https://docs.val.town/integrations/slack/send-messages-to-slack/), or [anywhere else](https://docs.val.town/guides/creating-a-webhook/))
51
52---
1import { discordWebhook } from "https://esm.town/v/stevekrouse/discordWebhook";
2import { hnEmail } from "https://esm.town/v/stevekrouse/hnEmail";
3import { hnLatestPosts } from "https://esm.town/v/stevekrouse/hnLatestPosts";
17 let { text } = await hnEmail({ posts, footer: false });
18 if (posts.length) {
19 await discordWebhook({
20 url: process.env.mentionsDiscord,
21 content: text,
22 });
12This "migration" runs once on every app startup because it's imported in `index.ts`. You can comment this line out for a slight (30ms) performance improvement on cold starts. It's left in so that users who fork this project will have the migration run correctly.
13
14SQLite has much more limited support for altering existing tables as compared to other databases. Often it's easier to create new tables with the schema you want, and then copy the data over. Happily LLMs are quite good at those sort of database operations, but please reach out in the [Val Town Discord](https://discord.com/invite/dHv45uN5RY) if you need help.
15
16## Queries
1# Discord Reaction to Linear Ticket Automation
2
3**How it works:** React to any Discord message with a configured emoji (like `:huss:` or `🧿` - used as an example in this val) and it automatically becomes a Linear ticket with context from the Discord thread.
4
5_Team members can use custom emojis to identify themselves as the ticket creator._
6
7
8
9## Environment Variables
11Before you can run this cron, you must add the following Environment Variables (via left sidebar of this val):
12
13- `DISCORD_BOT_TOKEN`: Your Discord bot token
14 - Go to [Discord Developer Portal](https://discord.com/developers/applications) → Create application → Complete the steps → Go to `Bot` on the sidebar → Copy token (or `Reset Token` and then `Copy` if you didn't copy it the first time)
15 - **Important:** Enable "Message Content Intent" in Bot → Privileged Gateway Intents
16- `DISCORD_SERVER_ID`: Your Discord server ID (right-click server name → Copy ID)
17- `DISCORD_MONITORED_CHANNELS`: Comma-separated channel IDs to monitor (right-click channel → Copy ID)
18 - Example: `1327384540187983926,1327384540187983927`
19- `LINEAR_API_KEY`: Your Linear API key
23 - Example: `6312a2a0-633b-47dc-a225-81d5d1759bf4`
24
25## Discord Bot Setup
26
271. **Create bot:** [Discord Developer Portal](https://discord.com/developers/applications) → New Application → Bot
282. **Set permissions:** OAuth2 → URL Generator → selecting `bot` unfurls a Bot Permissions dropdown below → Select `View Channels`, `Read Message History`, `Add Reactions`
293. **Enable intents:** Bot → Privileged Gateway Intents → ✅ Message Content Intent
37```typescript
38TARGET_EMOJIS: {
39 "huss": "Huss", // Custom Discord emoji :huss:, use just the name without colons (e.g., `"huss"` for `:huss:`)
40 "nas": "Nas", // Custom Discord emoji :nas:
41 "🧿": "Team", // Unicode built-in emoji, use the actual emoji (e.g., `"🧿"`)
42}
