Google Chat — Connect it to MokonyxSocial

Connect a Google Chat room and MokonyxSocial will drop a message into it whenever you publish — a handy way to keep your team in the loop. One thing to know up front: this works with Google Workspace accounts, not personal @gmail.com ones.

What you need

• A Google Workspace account (the paid Google business/organization kind — personal Gmail chat can't do this).
• The Google Chat room (space) where you want messages to appear, and you need to be a member of it.
• Permission to add a webhook to that room. If you can't, your Workspace administrator may need to switch the feature on.

Get your credentials

There's just one thing to grab: a special web link (a "webhook URL") for your chat room.

Webhook URL — webhook_url (required)

This is a private link that lets MokonyxSocial post into one specific chat room. It's long and starts with https://chat.googleapis.com/.... Anyone who has this link can post to the room, so keep it private.

1. Open Google Chat in your browser at https://chat.google.com and go into the room you want messages to go to.
2. Click the room's name at the top to open its menu, then choose Apps & integrations (it may say Manage webhooks).
3. Click Webhooks → Add webhooks, give it a name like "MokonyxSocial", and save.
4. Copy the whole link it gives you and paste it here.

> Don't see that menu option? It usually means either your Workspace admin has turned webhooks off (ask them to enable it), or you're on a personal Gmail account, which doesn't support this.

Set it up in MokonyxSocial

1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
2. Choose Google Chat.
3. Enter the credentials from the section above.
4. Click Send Test to verify the connection, then Save & Close and ensure the service is Published.

Verify

• Send Test sends a test message — pop into your Google Chat room and check that it showed up.
• Then publish something for real and confirm the message lands in the same room.

Troubleshooting

• "Room not found" or the link doesn't work — the webhook may have been removed, or you didn't copy the full link. Make a new webhook and copy the entire link.
• "Unauthorized" error — the link is likely incomplete or webhooks were turned off by your admin. Recreate the webhook and try again.
• Nothing shows up, but no error — you might be looking at a different room than the webhook posts to. Double-check the webhook belongs to the room you're watching.
• "Not available" message — you're probably on a personal Gmail account; this needs Google Workspace.

Notes & limits

• Each webhook posts to one room. Want messages in several rooms? Add a separate Google Chat service for each.
• Very long posts get shortened (there's roughly a 4,000-character cap on a message).
• Sending lots of messages very quickly may get slowed down by Google.
• Keep the link private — if it leaks, delete that webhook and make a new one.