Table of Contents
- Connecting WeChat
- Channel Configuration
- FAQ and Troubleshooting
- Can I connect to a personal WeChat account?
- How much does a WeChat Official account cost?
- Can I start a conversation with a WeChat Contact?
- Can I send images to my Contacts through the WeChat channel?
- Why don't I see the Contact's name when receiving messages on the WeChat channel?
- Messages Are Not Arriving
- How can I create a QR Code for my WeChat account?
Updated
by JQ Lee
- Connecting WeChat
- Channel Configuration
- FAQ and Troubleshooting
- Can I connect to a personal WeChat account?
- How much does a WeChat Official account cost?
- Can I start a conversation with a WeChat Contact?
- Can I send images to my Contacts through the WeChat channel?
- Why don't I see the Contact's name when receiving messages on the WeChat channel?
- Messages Are Not Arriving
- How can I create a QR Code for my WeChat account?

WeChat (微信 or Weixin) is a Chinese multi-purpose messaging, social media and mobile payment app developed by Tencent. As China's most popular app, it is also one of the world's largest mobile apps with over 1 billion monthly active users and 902 million daily active users. This WeChat Official Account integration lets your respond to messages directly from our platform.
Connecting WeChat
Step 1: Navigate to Channel Settings
From Settings module, navigate to the menu item, Channels.
Step 2: Add Channel
Click Add Channel and choose WeChat. The Connecting WeChat dialog should open up.


Step 3: Sign in to the WeChat Official Accounts Platform
Using your sign-in credential, sign to the WeChat Official Accounts Platform.

Step 4: Navigate to the Basic Configuration
Locate the Basic Configuration | 基本配置 page and navigate to it.

Step 5: Locate the AppID
Find the AppID and add it to the corresponding field on the respond.io platform.
Step 6: Generate the App Secret
To generate the App Secret, you will have to pass two verification steps.
- Scan a QR code on the webpage
- Re-enter your account password
Once you've completed the security measures, a brand new App Secret will be generated. Add it to the corresponding field on the respond.io platform.

Step 7: Follow through the steps at the platform
Once you've copied the necessary fields to the platform, click Next to follow through.

Step 8. Add Whitelisted IPs on the WeChat Official Accounts Platform
Add the IPs listed below to the IP Whitelist section.
52.74.35.155
18.138.31.163
54.169.155.20
Step 9: Add the platform-generated URL to WeChat
On the WeChat Official Accounts Platform, click the Change Configuration button to open the Server Configurations dialog.
Add the generated URL from the respond.io platform to the URL field on the WeChat platform.

Step 10: Add the platform-generated Token to WeChat
Add the generated Token from the respond.io platform to the Token field on the WeChat platform.
Step 11: Generate an Encoding AES key
On the WeChat platform, generate the encoding key and select Plain Text Mode for message encryption.

Step 12: Save settings
Click Submit to save and it will close the Server Configuration.
Step 13: Enable the configuration
Locate the green enable button and click it. The button will then change to red.

Step 14: Complete the setup on the respond.io platform
Click Done to complete the setup.
Channel Configuration
Step 1: Navigate to Channel Settings
From Settings module, navigate to the menu item, Channels.
Step 2: Locate the WeChat channel
Once you've located the WeChat channel, click Configure.

Step 3: Make the necessary configuration
You can configure the following:
- Channel Name - Name used internally to identify the account.
Step 4: Update the configuration
Click Done to update the channel configuration.
FAQ and Troubleshooting
Can I connect to a personal WeChat account?
To connect to a WeChat channel a WeChat Official Account is required. You can create a WeChat Official Account here.
How much does a WeChat Official account cost?
WeChat Official Accounts are free to create. However, an annual fee needs to be paid to verify the account, please check the Verification process here.
Can I start a conversation with a WeChat Contact?
WeChat rules say contacts must message you first before you can message them back. You can share your QR code with your Audience.
Can I send images to my Contacts through the WeChat channel?
Yes, but there are some restrictions for non-China WeChat Official accounts to send files over API.
Why don't I see the Contact's name when receiving messages on the WeChat channel?
This is because WeChat does not provide the contact's profile name as part of the metadata. Metadata refers to data that provides information about other data. In this case, WeChat’s metadata provides information such as the date and time of the messages, sender’s ID, etc. Learn more about WeChat’s API and metadata here.
Messages Are Not Arriving
Step 1: Navigate to Channel Settings
From Settings module, navigate to the menu item, Channels.
Step 2: Locate the WeChat channel
Once you've located the WeChat channel, click Troubleshoot.

Step 3: Refresh Permission
Click Refresh Permission to refresh WeChat permissions.

Step 4: Send a test message
Send a test message to the WeChat channel and check if it arrived.
How can I create a QR Code for my WeChat account?
- Go to your WeChat Official Account Manager > Account Details
- Click Download QR Code
