Skip to content
Quipthread Documentation

Notifications

Quipthread can notify you when new comments are submitted. Notifications are sent in batches after a configurable cooldown period to avoid alert fatigue.

Choose the right setup

Section titled “Choose the right setup”

Self-hosted Docker and source builds support SMTP email only. The email API, Telegram, Slack, Discord, and webhook channels below apply to managed cloud builds. Multiple channels can be active in a cloud deployment.

Self-hosted email

Section titled “Self-hosted email”

Self-hosted builds deliver notifications through SMTP. Cloud builds also support email API providers. Authentication emails always require SMTP. Set NOTIFY_EMAIL_TO to specify a fallback recipient when the site owner has no email address on their account.

# SMTP (reuses the SMTP_* vars)
SMTP_HOST=smtp.example.com
SMTP_USER=[email protected]
SMTP_PASS=your-password
SMTP_FROM=[email protected]


# Fallback recipient
NOTIFY_EMAIL_TO=[email protected]
Additional channels for cloud deployment operators

These environment variables configure the managed backend. They are not settings that cloud customers need to add to their websites.

Email API

Section titled “Email API”
EMAIL_PROVIDER=resend
EMAIL_API_KEY=your-api-key

Telegram

Section titled “Telegram”
TELEGRAM_BOT_TOKEN=your-bot-token
TELEGRAM_CHAT_ID=your-chat-id

Create a bot via @BotFather to get the token. The chat ID can be a personal chat, group, or channel.

Slack

Section titled “Slack”
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...

Create an incoming webhook in your Slack workspace’s app settings.

Discord

Section titled “Discord”
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...

Create a webhook in your Discord server’s channel settings.

Generic webhook

Section titled “Generic webhook”
WEBHOOK_URL=https://your-endpoint.example.com/hook

Quipthread posts a JSON payload to this URL for each notification batch.

Batching and cooldown

Section titled “Batching and cooldown”

To prevent notification floods, Quipthread groups pending comments before sending.

NOTIFY_BATCH_SIZE=5      # default: 5 — send when this many comments are queued
NOTIFY_COOLDOWN_HOURS=24 # default: 24 — minimum hours between notification sends

A notification is triggered when new comments are submitted that require moderation. Comments that auto-approve (from users with previously approved comments) do not trigger notifications.