Enterprise WeChat

Connecting Rocketbots to Enterprise WeChat.

Enterprise WeChat (企业微信 or Qiye Weixin), also known as "WeChat Work," is a special version of the popular WeChat app designed for work purposes, companies and business communication. The app helps employees separate work from private life.

The Enterprise WeChat Logo

Similarly to the original WeChat app, Enterprise WeChat supports a multitude of features, including attachments and location prompts. You can also set up a custom Chat Menus that can be seen on the Enterprise WeChat app.

For a detailed list of features against the other channels, you can take a look at the comparison table.

Setting Up Enterprise WeChat

In order to connect Enterprise WeChat to your space, you will need the following:

Logging into the Enterprise WeChat Admin Page

To log into the Enterprise WeChat Admin page on your desktop, you will have to scan a QR code with your phone.

On your computer, navigate to the Enterprise WeChat admin login screen by pressing the blue "企业登录 | Enterprise Login" button on the top right of their homepage or by following this link.

The Enterprise WeChat Login Screen

On the login screen, you will find a unique QR code that has been freshly generated. You will have to scan this code via the Enterprise WeChat app on your phone.

The Enterprise WeChat App

On the Enterprise WeChat app, tap the "+" button on the top right corner and select the "扫描QR Code | Scan QR Code" option to open up the scanner.

Once you have successfully scanned the QR code with your phone camera, you will be asked for desktop login confirmation on the phone.

The Login Confirmation Screen

Go ahead and tap the blue "登录 | Login" button to login to the Enterprise WeChat Admin page on your desktop.

Note that the QR code used for logging in will expire after a certain duration of time.

Creating an Enterprise App

Once you have logged into the Enterprise WeChat Admin Page, you will have to create an Enterprise App. This will handle the connection to your space on the side of Enterprise WeChat.

On the top of the page, press the "应用与小程序 | Applications and Applets" tab to navigate to the Applications page.

The Enterprise Applications Page

On the "应用 | Applications" page, press the "+ 创建应用 | Create Application" button under the "自建 | Custom" section. This should open the Enterprise App Creation Menu.

The Enterprise App Creation Menu

From the top of the Enterprise App Creation Menu, you will have to upload a logo or profile picture for your app under "应用logo | App Logo".

Next, enter a name for your Enterprise App under the "应用名称 | App Name" field, e.g. "Rocketbots Platform".

You can also enter a short optional description for your app under the "应用介绍 (选填) | App Description (Optional)" field.

Finally, you can set who and which department has access to the app under the "可见范围 | Permissions" field.

Once you have entered the app details, finish by pressing the blue "创建应用 | Create Application" button at the bottom.

Connecting to Enterprise WeChat

To add a new channel to an existing Space, navigate to Settings and select the blue "Add Channel" button under Manage Channels.

This should take you to your App Details page.

On the Rocketbots Platform, select the Enterprise Logo under the Channel Connection menu.

Once you have done so, you should be asked for a Channel Name, Corporate ID, Agent ID, Secret, Token, and an Encoding Key (AES) under Channel Settings.

Channel Settings for Enterprise WeChat

Go ahead and enter a suitable name for the channel. This will be used internally on the platform.

Corporate ID

To access your Corporate ID, log into the desktop Enterprise WeChat Admin page if you have not done so already. Select the "我的企业 | My Enterprise" tab on the top of the page to access the "企业信息 | Enterprise Details" page.

The Enterprise Details Page

Under the "企业信息 | Enterprise Details" page, you can find the the Corporate ID under the "企业ID | Corporate ID" field.

App Details

To find your App Details, navigate to the Applications page by clicking on the "应用与小程序 | Applications and Applets" tab on the top of the page.

The Enterprise Applications Page

On the "应用 | Applications" page, find and click on your Enterprise App under the "自建 | Custom" section. This opens your App Details page.

Example App Details Page

From your App Details page, you can find your Agent ID and Secret under the fields "AgentId" and "Secret", respectively.

Token and Encoding Key

On the App Details page, find the "接收消息 | Receiving Messages" section below and press the blue "设置API接收 | Configure API" button.

The Receiving Messages Section under App Details

Once you have clicked on the "Configure API" under "Receiving messages", the API Authentication menu should open.

The API Authentication Menu

To generate your app Token and Encoding Key, press the "随机获取 | Randomly Generate" buttons on the right of their respective fields. Copy the randomly generated Token and AES Key and paste them onto the Rocketbots Platform.

Once you have entered your Token and AES Encoding Key, press the blue "Next" button on the Rocketbots Platform.

Connecting to the Platform

Once you are done with the channel settings, the platform will generate a Webhook URL for your Enterprise App.

Enterprise WeChat Webhook URL

Go back to the API Authentication menu on Enterprise WeChat and paste the Webhook URL into the "URL" field.

The API Authentication Menu

Once you have pasted it in, hit the blue "保存 | Save" button to complete the authentication process.

Return to the Rocketbots Platform and press the blue "Done" button. Your space will now be connected to your Enterprise WeChat!

Go ahead and press "Finish" to create the space.

Any messages sent to your Enterprise WeChat account will now be received in your space.