WeChat Quick Start

The WeChat connector enables brands to use Live Assist as their messaging platform to manage WeChat Official Service Account at scale.

Prerequisite

An Official Service Account is required for this integration. To open a WeChat account, please see: https://wechatwiki.com/wechat-resources/wechat-official-account-registration-fees/

Setting up WeChat Connector

To set up WeChat Connector Integration, we need the following information from your account:

• 1. Original ID - also called “WeChat ID”
  2. Developer ID - also called “appID” in sandbox accounts
  3. Developer Password - also called “appsecret” in sandbox accounts

Step 1 - Get WeChat Account Details

• Login to your WeChat Account.
• Go to the top right-hand corner and select Account details.
  
• Under the Account details section, scroll to the bottom and see the Registration information section. This will contain the email you signed up for WeChat with and an Original ID that follows the “gh_XXXXXX” format.
• Next, you need to get the Developer ID. Go to Settings and Development on the left-hand side control pane, then select Basic Configuration. You should see a Developer ID.
  
• You will then need to provide us with the Developer Password (AppSecret). This will only appear on the screen once when the account is set up and saved. If you lost this, you will need to reset it. It will require you to scan a QR code using a regular WeChat account to accept the terms and conditions associated with having developer access.
  
• At this point, raise a Support Ticket with the subject 'WeChat Integration' and provide us with the following information:
  • • Original ID
    • Developer ID
    • Developer Password
    • Microsoft Dynamics CRM URL
• We then need to perform some actions in the back-end environment and provide you with a Token.

Step 2 - Enter the Configuration Settings into WeChat

Once this has been actioned, we will respond to you by providing you with a Verification Key.  This will be required for the final step in the WeChat account.

• Log back into WeChat. Under Setup and Development, select Basic Configuration then hit the enable button.
  
• Once enabled select Change setting. You will need to set the following:
  
  
  • • URL - The URL used will vary based on region. The full URL will look similar to the following: https://{region}.wechat-gw.liveperson.net/api/v1/{siteid}/{wechatID}/message
      

      ** replace parameters that starts with { and ends with } with appropriate information
      ie: https://va.wechat-gw.liveperson.net/api/v1/2323323/gw-9523xxbfts4/message

      The region you require can be worked out by Microsoft Dynamics CRM URL. Where the .crmX. part of the URL will indicate which region you require. For example, https://laexample.crm11.dynamics.com is crm11 which indicates a region in Europe requires lo to replace {region} in the URL.

      region

      • va → North America (crm, crm3)
      • sy → Asia Pacific (crm5, crm6,crm7, crm8)
      • lo → Europe (crm2, crm4, crm11)

      Your siteid can be obtained from the Demo Page or the Engagement Portal.
       - Engagement Portal

      
      - Demo Portal
      

      Your wechatID is your Original ID obtained from Step 1.

    • Token - Finally, you need to take the Token we provided you with.

      So you should end up with something looking similar to the following:
      
      If you're still unsure, respond in the support ticket and we can provide you your URL.

    • IP Whitelist - Based on your earlier region, add the following address to the IP whitelist: 

      • North America
        • 208.89.15.251
        • 208.89.12.137
      • Europe
        • 178.249.99.251
        • 178.249.98.9
      • Asia Pacific
        • 43.251.43.251
        • 43.251.40.4

      From the left pane select Settings and Development then Basic Configuration. Under IP whitelist click View and then Modify.

      
      Enter the appropriate IP address and select Confirm Modification.

Now when somebody sends a message to your official account via WeChat, you will see a message come into the messaging widget similar to the following:

To learn more about other social network connectors, see: Setting up Social Network connectors for Messaging.