Alerts in Slack and Discord

WP Foreman can post alerts to your team’s Slack or Discord. Add as many channels as you like. Each one gets the alerts you pick, for all your sites or for one client’s sites. For example, downtime and failed backups to #ops, new administrators to #security, and everything about Acme to the channel you share with Acme.

Get a Slack webhook

1. Go to api.slack.com/apps, click Create New App › From scratch, name it (for example “WP Foreman”) and pick your workspace.
2. Open Incoming Webhooks, switch it on, and click Add New Webhook to Workspace.
3. Pick the channel and click Allow. Copy the webhook URL (it starts with https://hooks.slack.com/services/).

Each webhook posts to one channel. For another channel, click Add New Webhook to Workspace again.

Get a Discord webhook

1. In Discord, open the channel’s settings (the cog next to its name) › Integrations › Webhooks.
2. Click New Webhook, give it a name, then Copy Webhook URL (it starts with https://discord.com/api/webhooks/).

You need the Manage Webhooks permission on the server.

Add it to WP Foreman

1. Go to Settings › Notifications and click Add a Slack or Discord channel.
2. Paste the webhook URL and give the channel a name you’ll recognise.
3. Choose All sites or one client’s sites.
4. Tick the alerts this channel should get. The usual ones are ticked to start with.
5. Click Add and send a test. A “WP Foreman is connected” message shows up in the channel within a few seconds.

To change a channel’s alerts or sites later, click Choose alerts next to it. The paper plane sends another test; pause and remove are next to it. Only the account owner can add or change channels.

The alerts

• Downtime: a site goes down (confirmed from more than one location), comes back up, or an SSL certificate or domain is about to expire.
• Backups and updates: a backup fails, an update fails or only partly works.
• Changes outside WP Foreman: a new administrator, a plugin installed, deleted or switched off, WordPress updated by hand, or any change at all.
• Site health: a site disconnects, a known security issue is found, mobile speed drops, a visual check finds pages that look different, the site’s emails stop sending or arriving.
• Forms: a form test fails, or a failing form works again.
• Your team: someone logs hands-on work; the morning report (sent on the account owner’s report schedule, to channels set to all sites).

Each message names the site (and its client), says what happened, includes the error when there is one, and links to the site’s log. Messages use your agency name from Settings › Branding when you’ve set one. They never mention @everyone or @here.

If messages stop

If Slack or Discord says the webhook was deleted or revoked, or it keeps failing, WP Foreman switches the channel off and shows why on Settings › Notifications. Fix or replace the webhook, then click the play button to switch it back on.