WhatsApp — Connect it to MokonyxSocial

MokonyxSocial sends your Joomla content as WhatsApp messages via the WhatsApp Cloud API from Meta. One important catch: outside a 24-hour window after someone messages you, WhatsApp only allows pre-approved message templates — plain text gets rejected.

What you need

• A Meta Business account and a WhatsApp Business (Cloud API) app.
• A verified sending number in WhatsApp Manager (with its Phone Number ID).
• A Cloud API access_token and the number's phone_number_id.

Get your credentials

Access token access_token (required)

This is the token the Cloud API uses to authenticate your send requests. Here's how to get one:

1. Sign in at https://developers.facebook.com/ , open or create an app, and add the WhatsApp product.
2. Under WhatsApp → API Setup you'll see a temporary token for testing. For production, create a System User in Meta Business Settings (business.facebook.com), assign it to the app with the whatsapp_business_messaging permission, and generate a permanent access token.
3. Copy the token.

Phone number ID phone_number_id (required)

This is the internal ID of your sending number — not the phone number itself.

1. In the app dashboard, go to WhatsApp → API Setup (or WhatsApp Manager → Phone numbers).
2. Find your business number and copy the long numeric Phone number ID next to it.

Recipient recipient (optional)

A default destination number in E.164 format (like +15551234567) for posts that don't specify one. Leave it blank if you'll set the recipient elsewhere.

1. Use the full international number with country code.
2. Enter it as E.164 — a leading + and digits only.

Set it up in MokonyxSocial

1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
2. Choose WhatsApp.
3. Enter the credentials above.
4. Click Send Test to verify, then Save & Close and make sure it's Published.

Verify

When Send Test succeeds, check the recipient's WhatsApp for the test message. During testing you may first need to add that number as an allowed test recipient under API Setup.

Troubleshooting

• Invalid access token (401): your temporary token expired (they only last ~24h) — generate a permanent System User token.
• "Recipient not in allowed list": in test mode, add the number under API Setup → To.
• "Template required": you're outside the 24-hour window, so free text is blocked — send an approved template.
• Wrong sender / 404: your phone_number_id is off — recopy it from WhatsApp Manager.

Notes & limits

• Free-form messages only work within 24 hours of the user's last message — otherwise use approved templates.
• Temporary tokens die in ~24 hours; production needs a permanent System User token.
• Meta caps how many people you can message based on your number's tier and quality rating.