• Applicable Software: MokonyxSocial
  • Min Version Number: 01.03.00 and later
  • Max Version Number: Not Applicable

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:

  1. Go to https://api.slack.com/apps and click Create New AppFrom scratch. Give it a name (like "MokonyxSocial") and choose your workspace.
  2. In the app's left sidebar, open Incoming Webhooks and switch Activate Incoming Webhooks to On.
  3. Scroll down and click Add New Webhook to Workspace.
  4. 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.)
  5. Back on the Incoming Webhooks page, copy the Webhook URL that now appears for that channel.
  6. Paste it into the webhook_url field.

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

  1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
  2. Choose Slack.
  3. Enter your webhook_url.
  4. 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.