Rocket.Chat
Post to your self-hosted Rocket.Chat server via an incoming webhook.
What it does
Posts your notifications to a channel on your Rocket.Chat server.
Before you start
Your server must both be reachable from the public internet over HTTPS and have incoming integrations enabled.
You will need a user to post as that has the "Impersonate other users" permission, which the "bot" and "app" roles default to having. Rocket.Chat refuses the whole message without it.
Set it up
Create an incoming integration in Rocket.Chat:
- Choose the gear icon and under "Manage" choose "Workspace"
- Choose "Integrations" then "New"
- Fill in "Post to Channel" and "Post as"
- Choose "Save"
- Expand "Instructions" at the top and 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 @here or @all) in messages.
Troubleshooting
Messages stop arriving
Recent Rocket.Chat versions don't tell Prowl that a webhook stopped working, so the Destination will continue to look healthy even if the webhook is deleted. If messages stop arriving, check in Rocket.Chat that:
- The webhook is still in "Integrations" and enabled
- The "Post as" user still exists, is not deactivated, and still has the "Impersonate other users" permission
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 integration's configuration inside Rocket.Chat under "Integrations".
Remove the Destination to stop posting. The integration stays in Rocket.Chat until you delete it there.