Configure WeChat

WeChat is one of the many chat channels which users can leverage to chat with Luma. To configure WeChat with Luma, it is required to first have an official WeChat account. Once the account is setup, an organization's users can chat with Luma through WeChat using the WeChat Messaging API. 

To configure WeChat with Luma, a Skills Builder Administrator needs to complete the following high-level steps:

1. Register in WeChat by creating an official account. Your service number and business number need to be populated in accordance with certain certifying documentation and materials. However, if you have not yet prepared your certifying documentation, you can still register for an Official Account and perform re-selection using the same e-mail address and login password later. To learn more about official account registration, refer to https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433401084.
2. From the WeChat official account, copy the Developer ID(AppID) and the Developer Password(AppSecret) and retain them in an easily accessible location for later use.
3. Configure the WeChat chat channel in Luma using the access Token and Server Address (URL) from the Skills Builder.
4. Enable the WeChat channel in the Skills Builder interface.

Configure Luma Details in WeChat

Once the WeChat official account registration is complete, login to the WeChat account and do the following:

1. On the home page, click the Basic Configuration sub menu under Development.
   The Basic Configuration page appears as shown below.
   
   
   
2. Copy the Developer ID(AppID) and Developer Password(AppSecret) and keep it at an easily retrievable location such as notepad or a text editor tool.
3. Include the IP whitelist details to set the access source IPs as whitelisted.
4. In the Server Configuration section, include the Server Address (URL) and Token details as shown below.
   
   
   
5. Copy the Encoding AES Key which is used to encrypt or decrypt the messages.
6. Select the Message Encryption Method.
7. Click Submit to complete the process.

Enable WeChat Channel in Skills Builder

To enable the WeChat in Skills Builder, do the following: 

1. On the Bots dashboard, from more options  click Bot Configuration as shown below.
   
2. On the Bot Configuration page, click the Channels tab.
   The Channels page appears as shown below.
   
3. Select WeChat from the Configure Channel list.
   The Configure WeChat dialog box appears as shown below.
   

4. Paste the copied Developer ID (App ID) and Developer Password (App Secret) (from step 2 in Enable WeChat Channel in section) in the Configure WeChat dialog box.

   Note

   Developer ID (App ID) and Developer Password (App Secret) are used to send messages from Luma to WeChat.

5. Copy the Token and Server Address (URL) and paste it in the WeChat Basic Configuration page (step 4 in Enable WeChat Channel section). You can use the copy icon to the right to simplify the operation. 

6. Click Save to enable the WeChat channel. The WeChat channel is now enabled.
7. The configured WeChat is shown on the Channels page.
   1. If required, use the toggle button () to make the channel inactive. You can inactivate the WeChat if you do not want to use it. 
   2. If required, use the edit button () to edit the WeChat details.
      

Chat with Luma

Once the WeChat registration is completed and WeChat is enabled in the Skills Builder, to chat with Luma, do the following:

1. On your phone, search the required official account and add it.
2. Once the official account is added, you can execute the skills.
3. To view the sent messages, on the WeChat home page, click Messages under Management as shown below. 
   All the sent messages appear in the All message tab.
   
   
   
4. To view the received messages, click the Received messages tab.