> For the complete documentation index, see [llms.txt](https://carliff-1.gitbook.io/yeshellold/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://carliff-1.gitbook.io/yeshellold/wechat.md).

# WeChat

{% hint style="info" %}
To connect WeChat, a verified WeChat Official Account is required. We have a [guide to creating one here](/yeshellold/wechat.md).
{% endhint %}

![](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-LFRx4w3tqbEMa6ytaDx%2F-LFRx6fU338J_phkk0pC%2FWeChat%20Logo.png?alt=media\&token=3b1d312b-8c8a-4860-8ffd-e9f3b5f8b0fa)

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 by 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

**1. Navigate** to Settings > Add Channel > WeChat*.*

![Connecting WeChat](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M3PTWLi7SuD_YMS7y6q%2F-M3Pb6xeiEqejvpe1OQl%2Fimage.png?alt=media\&token=43ea6018-7b1d-4660-a799-48670454779b)

**2. Sign** in to the [WeChat Official Accounts Platform](https://mp.weixin.qq.com/?lang=en_US\&token=).

**3. Navigate** to the Basic Configuration | 基本配置 page.

![Connecting WeChat](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M4DUfoeGZ9eCjWjcVjH%2F-M4DWPx0OAkBksVSRZ_n%2FScreen%20Shot%202020-04-06%20at%204.02.31%20PM.png?alt=media\&token=4d612787-5b26-470b-b9cc-2d8878bf349e)

**4. Find** the AppID and add it in the field provided.

**5. Generate** the App Secret and add it in the field provided.

To generate the App Secret, you have to pass two verification steps. First, you will have to scan a QR code on the webpage. After which, you will be asked to re-enter your account password.

Once you have completed the security measures, a brand new App Secret will be generated.

**6. Press** Next.

![Connecting WeChat](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M3PTWLi7SuD_YMS7y6q%2F-M3PdpsIvNY_AtMeFP64%2Fimage.png?alt=media\&token=2a2700ee-260a-40dc-bffd-5877c7bacde3)

**7. Add** the IPs listed below to the IP Whitelist on WeChat Official Accounts Platform.

```
52.74.35.155
18.138.31.163
54.169.155.20
```

**8. Press** the Change Configuration button to open Server Configurations.

![WeChat Configuration Menu (translated)](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M3PTWLi7SuD_YMS7y6q%2F-M3Pg4pIIjKtuRWv_SzJ%2Fimage.png?alt=media\&token=5bcc3233-e52b-431c-b796-0253bc936df2)

**9. Add** the URL generated to the URL field on WeChat Official Accounts Platform.

**10. Add** the Token generated to the Token field on WeChat Official Accounts Platform.

**11. Generate** an Encoding AES key (although it's not used) and select Plain Text Mode for message encryption.

**12. Press** Submit to save these settings.

**13. Press** on the green Enable button. It should then turn red.

![Enabling the Connection](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-LFRw_TaV9_5QdsM3d4h%2F-LFRwbRHbY1OzhbAzDky%2FEnable.png?alt=media\&token=8e795528-d820-44b5-9d2a-5b08b570b14e)

**14. Press** Done on the platform.

{% hint style="success" %}
Any messages sent to your WeChat Official Account will now be received in your Space.
{% endhint %}

## Channel Configuration

Every WeChat channel connected can be configured with a unique:

* Channel Name
* Greeting Message

**1. Navigate** to Settings > Channel Settings.

**2. Find** the WeChat channel to configure.

![Channel Settings](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M3PTWLi7SuD_YMS7y6q%2F-M3Pi9oD321tsXKUdWFM%2Fimage.png?alt=media\&token=c36c7d7e-1206-4e6f-bab2-4ed640a81c07)

**3. Press** the blue Configure button.

![](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M3PTWLi7SuD_YMS7y6q%2F-M3Pj_bmmUUpKu6s29Xr%2Fimage.png?alt=media\&token=b1738403-eb52-447c-bc2c-ce49dd791a75)

**4. Add** Channel Name. 

Note that the Channel Name is private and will only be used within the platform to identify this channel.

**5. Add** Greeting Message. 

This is the first message that will be sent to your Contact when they message you through the WeChat.

**6. Press** Done to update channel configuration.

{% hint style="info" %}
Other information regarding channel connection is listed here as well.
{% endhint %}

## Limitation

The WeChat Channel has the limitation listed below:

* WeChat audio messages do not play in Chrome as the format .wav sent by WeChat is not supported by Chrome. <br>

## Troubleshoot

**1. Navigate** to YesHello Settings > Channel Settings.

**2. Find** the WeChat channel to troubleshoot.

![Channel Settings](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M7rYsOkKvjLOo5oGLrA%2F-M7rZfPo7m2RROaWNWeQ%2FScreenshot%202020-05-21%20at%203.58.17%20PM.png?alt=media\&token=4c9ce6ba-154b-4358-98bd-e97c1424a068)

**3. Press** the Troubleshoot button for the channel.

![WeChat Troubleshooting](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M3PTWLi7SuD_YMS7y6q%2F-M3PpAKVRLzWSedWJAaz%2Fimage.png?alt=media\&token=1b040920-3416-4afc-a58e-fb11bd45c4cc)

**4. Configure** the channel.&#x20;

**5. Press** Done.

{% hint style="success" %}
Your Channel Name and/or Greeting Message has been edited.
{% endhint %}

Still having trouble with the channel? Contact us [here](https://www.yeshello.chat/contact-us)!