Connect WeCom AI Robot (Bot Mode)

By creating an Intelligent Robot (API Mode) in WeChat Work (WeCom), you can have your Buda Agent reply with a streaming typewriter effect. Buda connects via WebSocket long connection; you only need the robot Bot ID and Secret. No receive-message URL or domain configuration is required.

Step 1: Add an Intelligent Robot

1. Log in to the WeCom Admin Console.
2. In the left menu, go to Security and Management (安全与管理) -> Management Tools (管理工具). Under Smart Zone AI+ (智能专区 AI+), click Intelligent Robot (智能机器人). (Direct link to Management Tools)
3. In the modal "What kind of robot do you need?" (你需要一个什么样的机器人), click Manual Creation (手动创建) at the bottom to open the creation page.
4. [CRITICAL] On the "Create Intelligent Robot" (创建智能机器人) page, scroll to More Settings (更多设置). At the bottom you'll see: "If you need to use your own system to receive chats and send replies, switch to API mode creation." Click API 模式创建. Only API mode lets Buda handle the conversation and streaming replies.
5. On the API configuration page, under Connection method (连接方式), select Use long connection (使用长连接) — "No domain or IP required to receive messages and return results." Do not choose "Use URL callback (使用 URL 回调)".
6. Enter the robot name, logo, and visibility scope, then save to complete creation.

Step 2: Get Bot ID and Secret

1. In the Configuration method (配置方法) area on the API page you'll see Bot ID (copy it) and Secret (click "Click to get" / 点击获取 to reveal).
2. Copy both values for use in Buda.

Step 3: Configure the Channel in Buda

1. Open Channels Settings in Buda.
2. Click Add Channel and select WeCom Intelligent Robot (Bot).
3. Enter the Bot ID and Secret in Buda and save.
4. After saving, Buda will connect to WeCom over a WebSocket long connection.

Step 4: Start Chatting

In the WeCom workspace, enter the robot name in the search box, open the app, then send a message. Replies will show a flowing "..." placeholder first, then stream as typewriter-style text.