Connecting your space 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.
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.
In order to connect Enterprise WeChat to your space, you will need the following:
A WeChat Official Enterprise Account (企业号) (also known as a Corporate Account)
The Enterprise WeChat app installed on your phone
To log into the Enterprise WeChat Admin page on your desktop, you will have to scan a QR code with your phone.
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.
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.
Go ahead and tap the blue "登录 | Login" button to login to the Enterprise WeChat Admin page on your desktop.
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.
On the "应用 | Applications" page, press the "+ 创建应用 | Create Application" button under the "自建 | Custom" section. This should open 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.
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.
Go ahead and enter a suitable name for the channel. This will be used internally on the platform.
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.
Under the "企业信息 | Enterprise Details" page, you can find the the Corporate ID under the "企业ID | Corporate ID" field.
To find your App Details, navigate to the Applications page by clicking on the "应用与小程序 | Applications and Applets" tab on the top of the page.
On the "应用 | Applications" page, find and click on your Enterprise App under the "自建 | Custom" section. This opens your App Details page.
From your App Details page, you can find your Agent ID and Secret under the fields "AgentId" and "Secret", respectively.
On the App Details page, find the "接收消息 | Receiving Messages" section below and press the blue "设置API接收 | Configure API" button.
Once you have clicked on the "Configure API" under "Receiving messages", the API Authentication menu should open.
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.
Once you are done with the channel settings, the platform will generate a Webhook URL for your Enterprise App.
Go back to the API Authentication menu on Enterprise WeChat and paste the Webhook URL into the "URL" field.
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.