Connect WeChat (Official Account)

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

1. In mp.weixin.qq.com, go to Development → Basic Configuration and copy the AppID and AppSecret.
2. 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).
3. 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.
4. Back in mp.weixin.qq.com's Server Configuration section, paste that URL, the same token, and turn on server mode.
5. 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.