Mattermost
Post to your self-hosted Mattermost server via an incoming webhook.
What it does
Posts your notifications to a channel on your Mattermost server.
Before you start
Your server must both be reachable from the public internet over HTTPS and have incoming webhooks enabled.
Set it up
Create a webhook:
- Choose the icon grid, then "Integrations"
- Choose "Incoming Webhooks" then "Add Incoming Webhook"
- Give it a title and pick a channel
- Choose "Save" then copy the URL
Paste it into "Webhook URL".
Check it works
Prowl posts a test message to the channel before adding the Destination. If it fails, nothing is added.
Options and behavior
Prowl prevents group mentions (such as @channel, @here, or @all) in messages.
Posts show Prowl's name and icon only if your server lets integrations override them. Otherwise they show the name and picture of whoever created the webhook. To change that, an admin can:
- Choose the icon grid, then "System Console"
- Under "Integrations" choose "Integration Management"
- Turn on "Enable integrations to override usernames"
- Turn on "Enable integrations to override profile picture icons"
- Choose "Save"
Troubleshooting
Messages stop arriving
Mattermost does not tell Prowl when a webhook stops working, so the Destination will continue to look healthy even if the webhook is deleted. If messages stop arriving, check in Mattermost that:
- The webhook is still in "Incoming Webhooks"
- "Last used" is still updating
- The person who created the webhook is still a member of the channel
- Your admin still has "Enable Incoming Webhooks" turned on
Prowl can't reach my server
Prowl cannot reach a private server; it must be accessible on the public internet. Check that the DNS entry for your server hasn't changed to a private address, and that nothing in front of it redirects Prowl elsewhere, since Prowl won't follow a redirect.
Some messages arrive late
If your server rate-limits Prowl or is briefly unreachable, Prowl retries for up to about two hours, after which the notification is skipped.
Disconnect or replace it
You can change the channel that Prowl posts to in the webhook's configuration inside Mattermost under "Incoming Webhooks".
Remove the Destination to stop posting. The webhook stays in Mattermost until you delete it there.