Skip to main content
Connect your AI Expert to WeCom (WeChat Work), allowing team members to use your Expert directly in WeCom conversations. The WeCom channel features a unique “edit mode” message delivery — replies are updated in real time within a single message, providing a smoother reading experience.

​
Integration Methods

Choose manual setup when you need fine-grained permission control:
1

Create a WeCom App

Log in to the WeCom Admin Console, go to “App Management” → “Custom” → Create App. Fill in the app name, icon, and visibility scope.
2

Configure Message Receiving

In the app details under “Receive Messages,” enable API message receiving. Enter the callback URL provided by Profy, and take note of the Token and EncodingAESKey.
3

Obtain Credentials

Record the app’s AgentId, along with the enterprise’s CorpId and app Secret.
4

Enter in Profy

Enter the CorpId, AgentId, Secret, Token, and EncodingAESKey in the Profy channel configuration panel.
5

Verify Callback

After saving the configuration, WeCom will send a verification request to the callback URL. The Profy service handles verification automatically.

​
Message Delivery: Edit Mode

The WeCom channel’s message style differs from other platforms:
WeCom uses “edit mode” (StreamBridge) — the Expert’s reply is updated in real time within a single message rather than sending multiple message bubbles. Similar to the typewriter effect you see on the web interface.

​
Advantages of Edit Mode

​
Tool Call Display

When the Expert calls a tool, the message content updates to show the current execution status (e.g., “Searching…”). Once complete, it’s replaced with the final reply. The entire process happens within a single message.

​
How to Use

​
In-App Conversation

Find the configured app in WeCom’s “Workbench,” tap to enter the conversation interface, and start sending messages directly.

​
One-on-One Chat

Find the app bot in your contacts and send a message to start a private conversation.
WeCom’s edit mode is particularly well-suited for scenarios requiring long replies (such as document generation or analysis reports), since responses won’t be split into multiple messages.

​
Detailed Setup Steps (Manual Mode)

1

Create App in WeCom Admin Console

Under “App Management” → “Custom,” create an app with:
  • App name (recommended to match your Expert’s name)
  • App icon
  • Visibility scope (select which departments/members can access it)
2

Enable API Message Receiving

Go to App Details → “Receive Messages” → Set up API receiving:
  • URL: Enter the callback URL provided by Profy
  • Token: Auto-generated or custom
  • EncodingAESKey: Auto-generated or custom
3

Configure Trusted Domain

Add Profy’s service egress IP to the “Trusted Enterprise IPs” if required.
4

Submit Profy Configuration

Enter all credentials in the Profy Expert Studio channel configuration and click save.
5

Test

Send a test message to the app in WeCom and verify that you receive a proper reply.

​
Important Notes

  • Creating WeCom apps requires admin privileges
  • The visibility scope determines which employees can use this Expert
  • In edit mode, message update frequency is subject to WeCom API rate limits — extremely rapid consecutive updates may be throttled

​
FAQ

Ensure the Token and EncodingAESKey are exactly identical in both the Profy configuration and WeCom configuration. Watch out for trailing spaces.
Verify that your WeCom account is within the app’s visibility scope. If the scope was recently modified, it may take a few minutes to take effect.
WeCom has a character limit per message. If the Expert’s reply exceeds the limit, it will be truncated. Consider adjusting the reply length in your Expert configuration.

Channels Overview

Learn about all supported IM platforms

WeChat Integration

WeChat Official Account channel setup guide