Discord Notifications

PubCounter can send notifications to a Discord channel when important events occur, keeping your team informed in real-time.

What Gets Notified?

Discord notifications are sent for:

Event	Notification
New reorder request	When a user submits a new reorder
Request approved	When an admin approves a reorder
Request rejected	When an admin rejects a reorder (includes reason)
Order placed	When a reorder is marked as ordered
Order received	When publications arrive
Request modified	When quantities are changed or cancelled

Setting Up Discord Notifications

Step 1: Create a Discord Webhook

1. Open Discord server settings

   In your Discord server, go to Server Settings → Integrations.

2. Create a webhook

   Click “Webhooks” → “New Webhook.”

3. Configure the webhook

   • Name: “PubCounter” (or your preference)
   • Channel: Select the channel for notifications
   • Avatar: Upload a custom icon (optional)

4. Copy the webhook URL

   Click “Copy Webhook URL” and save it securely.

Tip

Create a dedicated channel like #inventory-notifications to keep notifications organized.

Step 2: Configure in PubCounter

1. Access Kingdom Hall Settings

   Sign in as a super admin and go to Admin → Kingdom Hall Settings.

2. Go to Integrations

   Find the Discord Webhook section.

3. Paste webhook URL

   Enter the webhook URL you copied from Discord.

4. Save changes

   Click Save to enable notifications.

Step 3: Test the Integration

After saving:

1. Create a test reorder request
2. Check your Discord channel for the notification
3. If received, the integration is working

Notification Format

Discord notifications appear as rich embeds with:

• Title: Event description
• Color: Color-coded by event type
• Fields: Relevant details (publication, quantity, user, etc.)
• Timestamp: When the event occurred

Example notification:

📦 New Reorder Request

Publication: Bible Teach (bh-E)
Quantity: 25
Requested by: John Smith
Congregation: North Congregation

Submitted: January 15, 2025 at 2:30 PM

Notification Colors

Event Type	Color
New request	Blue
Approved	Green
Rejected	Red
Ordered	Purple
Received	Green
Modified	Yellow

Managing Notifications

Muting Notifications

If notifications become overwhelming:

1. In Discord, right-click the channel
2. Select “Notification Settings”
3. Choose your preferred notification level

Channel Permissions

Control who sees notifications:

1. Set channel permissions in Discord
2. Limit visibility to admins or specific roles
3. Use category permissions for organization

Multiple Channels

For different notification types:

1. Create multiple webhooks in different channels
2. PubCounter currently supports one webhook per Kingdom Hall
3. Consider using Discord’s thread feature for organization

Note

Future updates may support multiple webhooks for different event types.

Troubleshooting

Notifications not appearing

• Verify the webhook URL is correct
• Check the webhook hasn’t been deleted in Discord
• Ensure the channel still exists
• Test the webhook directly using Discord’s test feature

Webhook was deleted

1. Create a new webhook in Discord
2. Update the URL in PubCounter settings
3. Save changes

Rate limiting

Discord has rate limits on webhooks:

• 30 requests per minute per channel
• During high activity, some notifications may be delayed
• Notifications aren’t lost, just queued

Wrong channel

1. Create a new webhook in the correct channel
2. Update the URL in PubCounter
3. Delete the old webhook in Discord (optional)

Privacy Considerations

Notifications include:

• Publication names and quantities
• User names (who submitted/approved)
• Congregation names

Do not use notifications in public Discord servers. Keep your PubCounter Discord channel:

• Private to your Kingdom Hall members
• Restricted to those who need the information
• Properly secured with Discord permissions

Best Practices

Channel Organization

• Use a dedicated channel for inventory notifications
• Pin important messages or create a summary thread
• Archive old notifications periodically

Notification Management

• Review notifications regularly
• Follow up on rejected requests
• Acknowledge received orders promptly

Security

• Keep webhook URLs private
• Regenerate webhooks if compromised
• Limit channel access to authorized users

Next Steps

• Configure Pubmate integration for automated submissions
• Set up Kingdom Hall settings for other options