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: Chunked Bubbles

Like every other IM channel, WeCom delivers replies as chunked bubbles — not as the character-by-character typewriter update you see on the web. The reason is simple: WeCom’s message API offers no way to edit an already-sent message, so the Expert accumulates output and sends a bubble when it reaches a semantic boundary.

​
How tool calls appear

The Expert sends a status notice first (e.g. ”🔍 Searching…”), up to three of them. When the tool finishes, the real reply arrives as a new bubble — it does not replace the earlier notice.

​
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.
When you need long-form output (analysis reports, document drafts), ask the Expert to write it to a file and send that instead. The chat window will always chunk long text; a file won’t.

​
Key numbers

​
Failures and fixes

​
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