WeChat

WeChat is a China-based mobile text and voice messaging communication service. With over 700 million active users, it’s become the de facto hub for Chinese conversational commerce.

Our WeChat integration lets your customers message you from WeChat, while you reply using your favorite business apps.

Capabilities

Telegram supports a wide variety of capabilities as seen in the channel capabilities grid. Below is a detailed view of each capabilities.

Content Types

  • Full Support

    API

    Text

    Plain text messages

  • Full Support

    API

    Image

    Display static images

  • Partial Support

    API

    File

    Send and receive any file types

  • Full Support

    API

    Emoji

    Unicode Emojis✨

  • Full Support

    API

    GIF

    Send animated GIFs

  • Partial Support

    API

    Location

    Receive the geolocation of the user

Action Types

  • Full Support

    API

    Link

    Display web links

  • Partial Support

    API

    Extensions

    Send custom interactive experiences built with Jav...

  • Full Support

    API

    Buy

    Request payments within a conversation

  • Full Support

    API

    Postback

    Send text to the user to trigger events on your se...

  • Full Support

    API

    Replies

    Suggest a few answers to reply to a message

  • Partial Support

    API

    Location Request

    Request the current location of the user

Structured Messages

  • Full Support

    API

    Compound Messages

    Compose messages with multiple actions

  • Partial Support

    API

    Carousel

    Send a set of message items that can contain text ...

Indicators

  • Full Support

    API

    Conversation Start

Configuring WeChat

In order to configure WeChat, you’ll need a WeChat Official Account. You can apply for an International-Market Official Account here and for a Mainland China-Market here. Alternatively, you can also test using the sandbox.

Once you’ve created your account, you will need to go through the account verification process. In order to do so, log in to your WeChat dashboard and go to the “WeChat Certification | 微信认证” page below the Set Up section.

Once your account has been verified, go to the integration page, connect the integration, and follow these steps.

  1. In the WeChat dashboard, go to the “Basic Configuration | 基本配置” page below the Develop section and add the following IP addresses to the whitelist separated by new lines.

    • 34.224.190.28
    • 52.6.201.31
    • 52.0.232.16
  2. In the WeChat dashboard, copy and paste your App ID and App Secret on the Smooch integration page.

  3. In the WeChat dashboard, click on “Modify Configuration | 修改配置” below Basic Configuration, then copy the Webhook URL and Token from the Smooch integration page and paste it there.

  4. After saving your settings, click on Connect to WeChat to complete the integration.

Safe Mode

Optionally, you can configure “Safe Mode” in the WeChat dashboard. With this mode enabled, all outgoing messages from WeChat will be encrypted using a secure 43 character AES key.

In order to have Safe Mode functioning correctly with Smooch, simply copy your EncodingAESKey from WeChat and paste it in the WeChat integration page. Messages will be automatically decrypted in a secure fashion.

Persistent Menu

WeChat Persistent Menu

It’s possible to configure a menu on the WeChat UI by calling the Smooch REST API. WeChat allows up to two levels of menu hierarchy and they can contain 1 to 3 menu items at its first level and 1 to 5 menu items for a submenu. Menus are configured per app or per integration, not per user. Menu items can be link, postback or submenu type actions.

List

WeChat supports native list messages. List messages are a vertically scrollable set of items that may each contain text, an image and a link. Once a user clicks on an item with a link, it opens a URL. See the WeChat list section in the REST API documentation for more information on how list messages are rendered in WeChat.

wechat list

Integrate with WeChat Sandbox

WeChat offers a sandbox environment to easily test their messaging features similar to an offical account. Using your WeChat user account on your mobile phone, scan the QR code and log in to the WeChat Sandbox dashboard.

  1. In the WeChat Sandbox dashboard, the “Test Numbers | 测试号信息” section will provide you with an App ID and App Secret to be entered into the Smooch integration page.

  2. In the “Interface Configuration | 接口配置信息” section, click on “Modification | 修改” and enter the Webhook URL and Token from the Smooch integration page.

  3. After saving your settings, click on Connect to WeChat to complete the integration.

In the “Test QR Code | 测试号二维码” section, scan your Sandbox QR code to message your WeChat Sandbox account.