This guide walks you through connecting Slack so MokonyxSocial can post your Joomla content into a Slack channel using an Incoming Webhook. Good to know up front: a webhook is tied to exactly one channel — the one you pick when you create it — so each Slack service targets a single channel. To post somewhere else, you'll add another service with that channel's webhook.
What you need
- A Slack workspace where you can install apps (or an admin who can approve one).
- An Incoming Webhook URL for the channel you want to post to.
Get your credentials
Webhook URL webhook_url (required)
This is the Incoming Webhook endpoint Slack generates for you — MokonyxSocial simply POSTs your message to it. It looks like https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX and encodes both your workspace and the destination channel.
Here's how to get it:
- Go to https://api.slack.com/apps and click Create New App → From scratch. Give it a name (like "MokonyxSocial") and choose your workspace.
- In the app's left sidebar, open Incoming Webhooks and switch Activate Incoming Webhooks to On.
- Scroll down and click Add New Webhook to Workspace.
- Pick the channel you want posts to land in and click Allow. (If your workspace requires admin approval, an admin will need to approve the app first.)
- Back on the Incoming Webhooks page, copy the Webhook URL that now appears for that channel.
- Paste it into the
webhook_urlfield.
Treat that URL like a secret — anyone who has it can post to your channel. To revoke it, just delete the webhook (or the app) in your Slack app settings.
Set it up in MokonyxSocial
- In Joomla admin, go to Components → MokonyxSocial → Services → New.
- Choose Slack.
- Enter your
webhook_url. - Click Send Test to verify, then Save & Close and make sure it's Published.
Verify
Open the Slack channel the webhook points to and confirm your test message showed up (posted by your app). It's basically instant.
Troubleshooting
- "no_service" or "404" — the webhook URL is mistyped or revoked, or the app was deleted. Recreate the webhook and paste the full URL.
- "invalid_payload" or a badly formatted message — the content had characters that broke the JSON payload. MokonyxSocial should escape these, but very large messages can exceed Slack's limits (see below).
- It posts to the wrong channel — a webhook is locked to the channel you chose when creating it. Make a new webhook for the right channel.
- "channel_not_found" or archived — the target channel was archived or the app was removed. Pick an active channel and re-add the webhook.
Notes & limits
- One webhook equals one fixed channel — you can't redirect it by editing a field. Add a separate service for each channel.
- Slack messages have a size cap (around 40,000 characters, though much shorter reads better), so long articles get trimmed to a summary plus a link.
- Incoming Webhooks post as your app's identity, not as a user — you can set the app's name and icon in the Slack app settings.
- Rate limits apply (roughly one message per second per webhook), so avoid rapid bursts.