# WeCom Bot Integration

> Integrate FastGPT applications with WeCom custom apps and group bots to power internal knowledge retrieval and employee self-service Q&A.

Source: https://doc.fastgpt.io/guide/build/publish/wecom
Last Updated: 2026-11-12

* Starting from version 4.12.4, FastGPT commercial edition supports direct WeCom bot integration without additional APIs.
* Starting from version 4.14.4, FastGPT cloud service edition supports WeCom intelligent bot integration through custom domain configuration.

![FastGPT wecom channel configuration with empty credentials](https://cdn.jsdelivr.net/gh/labring/fastgpt-img@main/optimized/current/publish-wecom.png.webp)

The screenshot shows the FastGPT configuration form. Enter credentials from your own platform application. Follow the official platform console linked below for its current console layout.

## 1. (Required for Cloud Service Edition) Configure Custom Domain

WeCom requires intelligent bot message push addresses to use the enterprise's primary domain, so cloud service edition users must configure a custom domain before using WeCom bots.

* [Configure Custom Domain](https://doc.fastgpt.io/guide/workspace/customDomain)

If you are a commercial edition user, continue using your enterprise domain.

## 2. Create an Intelligent Bot

### 2.1 Super Admin Login

[Click to open WeCom Admin Console](https://work.weixin.qq.com/)

### 2.2 Find the Intelligent Bot Entry

On the "Security & Management" - "Management Tools" page, click "Intelligent Bot" (Note: Only the enterprise creator or super admin has permission to see this entry)

### 2.3 Select "API Mode Creation" for the Intelligent Bot

On the create bot page, scroll down and click "API Mode Creation"

### 2.4 Get Key Credentials

Randomly generate or manually enter Token and Encoding-AESKey, and record them

### 2.5 Create WeCom Bot Publishing Channel

The WeCom Bot channel is hidden by default. The root user must first turn on the **WeCom publishing channel** switch in **Admin → System configuration**.

In FastGPT, select the Agent you want to use. On the **Publishing Channels → WeCom Bot** page, click **New** in the upper-right corner.

### 2.6 Configure Publishing Channel Information

Configure the publishing channel information. You need to enter the Token and AESKey recorded in step 2.4 (Token and Encoding-AESKey)

### 2.7 Copy Callback URL

After clicking "Confirm", select your configured custom domain, copy the callback URL, and paste it back into the WeCom intelligent bot configuration page.

## 3. Use the Intelligent Bot

In the WeCom platform's "Contacts", find the created bot and start sending messages. If the bot does not respond, verify the trusted domain, `Token`, `Encoding-AESKey`, and FastGPT conversation logs via [App, Chat, and Plugin FAQ](https://doc.fastgpt.io/guide/build/faq).
