Connect WeChat (Official Account)
Connect your WeChat Official Account to Omnifox and support your China-based audience from the Inbox.
WeChat is the dominant messaging app in China. This channel connects your Official Account to Omnifox so follower messages land in the same Inbox as every other channel.
Requirements
- A verified Official Account at mp.weixin.qq.com
- That account's AppID and AppSecret
- A verification token you define yourself (any string works)
Steps to connect
- In mp.weixin.qq.com, go to Development → Basic Configuration and copy the AppID and AppSecret.
- In Omnifox, go to Channels → Connect New Channel, pick WeChat, and paste the AppID, AppSecret, and a Verification Token (it must match what you set in WeChat).
- Save the channel once — only then does Omnifox show you the full webhook URL, which includes a
?ch={channel_id}parameter that only appears after the first save. - Back in mp.weixin.qq.com's Server Configuration section, paste that URL, the same token, and turn on server mode.
- WeChat runs an automatic GET verification against that URL before accepting the configuration.
Configuration
- AppID / AppSecret: your Official Account's credentials.
- Verification Token: must be identical on both sides, or the handshake fails.
- Webhook URL: handles both the verification (GET) and the events (POST, XML body).
Example
A follower in Shanghai writes "do you ship internationally?" to your Official Account. The message arrives in the Omnifox Inbox as a WeChat conversation, ready for an agent to answer.
Tips
- Save the channel before copying the final webhook URL — the version without
?ch=won't work. - Unverified Official Accounts face strict API limits; for serious commercial use, the verified plan is worth it.
Troubleshooting
- WeChat rejects the server verification: check that the token is exactly the same on both sides (it's case- and whitespace-sensitive).
- No messages after saving: confirm you copied the URL with
?ch=included, not the pre-save version.
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.