WeChat Official Account connection guide
Because of regulatory requirements, WeChat is a channel that takes time to prepare and verify the account. Including account and verification setup, it takes roughly 3–6 weeks, but once everything is ready, connecting to the CRM itself only takes about 30 minutes. Foreign entities can register as well.
Coauths handles the connection for you
WeChat has a complex setup (account registration, verification, server configuration) and the console is entirely in Chinese, so the integration is done directly by your Coauths representative. If you already have — or are preparing — the prerequisites above (Service Account · Verified Account), contact us using the button below, and we’ll take care of the rest.
Common issues
AppSecret menu is not visible
Accounts registered after 2025-12 issue AppSecret from developers.weixin.qq.com. If not visible in mp.weixin, switch to that console. See the Console menu structure guide.
Webhook verification fails
Complete "Connect and verify" in the CRM first, then make sure you pasted the Webhook URL from the success screen into the console without changing a single character. The Token must be exactly the same string in the CRM form and the WeChat console, and the encryption mode must be 明文模式 (plain text).
IP block error when refreshing access_token
Disable the IP whitelist or leave it empty. Coauths CRM calls from a cloud environment without fixed IPs — with the whitelist on, it would be blocked every time. AppSecret alone is sufficient for security.
Patient name shown as "WeChat User"
After PIPL enforcement, the WeChat API returns empty nicknames/avatars. This is normal. The CRM falls back to remark or channel labels; match real names via Patient Linking.
Connection suddenly broke after 1 year of Verified
The 微信认证 was not renewed. See Annual renewal. USD 99 must be paid every year.
How to respond outside the 48-hour window?
Pre-register template messages (模板消息/订阅消息) and pass Tencent review to send certain categories. Strict frequency and category restrictions apply.
The channel card shows an error
When an error occurs, a "Reconnect" button appears on the channel card in the channel connection page. If you reset the AppSecret, reconnect with the new value. If the problem persists, contact your Coauths representative.
📄 Download the full guide PDF
For offline reference. A print-optimized PDF version of this page.