English

简体中文

English

简体中文

WeCom ​

Follow the real setup order to connect a WeCom intelligent bot to Baize: create the bot in the WeCom Workspace, select API mode with a long connection to obtain its credentials, then install and configure the WeCom connector in Web Console.

Estimated setup time: 5–10 minutes.

Before you start ​

  • An account with permission to manage the WeCom Workspace.
  • A running Baize instance.

Step 1: Create a robot in the WeCom Workspace ​

  1. Open WeCom and enter Workspace.
  2. Select Create.
  3. Choose Create robot to create a new intelligent bot.
  4. Enter the robot name, avatar and description, then finish creation.

Create a robot in Workspace

Step 2: Select API mode and enable a long connection ​

Open the settings for the robot you just created:

  1. Select API mode.
  2. Select Use long connection as the connection method.
  3. Choose the SDK long-connection configuration method.
  4. Copy the Bot ID.
  5. Select Get and copy the Secret.
  6. Save the configuration in WeCom.

Long connection mode does not require a public domain or callback URL, which makes it suitable for private and self-hosted deployments. Treat the Bot ID and Secret as sensitive credentials and never commit them to a repository or share them publicly.

API mode and long-connection configuration

Step 3: Install and configure WeCom in Web Console ​

Return to Web Console → Channels and integrations in Baize:

  1. Find WeCom in the available channels.
  2. Select Install and wait for the component to finish installing.
  3. Open the installed WeCom channel card.
  4. Enter the Bot ID and Secret in API configuration.
  5. Select Verify and save.
  6. Start the connector and confirm that its status changes from Not configured to Running.

WeCom API configuration in Web Console

Verify the connection ​

  1. Open the new robot in WeCom.
  2. Send a direct message and confirm that Baize replies.
  3. To use it in a group, add the robot and mention it as required by WeCom.
  4. Return to Web Console and confirm the channel status and runtime logs.

Troubleshooting ​

  • The robot cannot be created: confirm that the account has Workspace-management permission.
  • The long connection does not start: check that the Bot ID and Secret were copied completely and that API mode was saved in WeCom.
  • Verify and save fails: confirm that the Baize instance can reach WeCom services; regenerate the Secret if necessary.
  • The bot does not reply: confirm that the channel is Running and inspect the Web Console logs.