WeChat - profClaw

WeChat is China’s dominant super-app. profClaw integrates via the WeChat Official Account (OA) platform for business messaging and automated responses.

Capabilities

Feature	Supported
1:1 messages	Yes
Passive response	Yes
Text messages	Yes
Rich media	Yes
Menu buttons	Yes
Template messages	Yes
Webhook	Yes

Requirements

WeChat Official Account (Subscription or Service Account)
Business verification for advanced features
Server with public HTTPS URL

Setup

Apply at mp.weixin.qq.com. Service Accounts have more API access than Subscription Accounts.

Enable developer mode

Go to Settings > Official Account Settings > Features > Developer and enable the developer mode.

Configure server settings

Set:

Server URL: https://your-domain.com/webhooks/wechat
Token: your custom token
EncodingAESKey: generate or use the random one provided
Message encryption: Recommended (EncodingAESKey required)

Get App credentials

Under Development > Basic Configuration, copy AppID and AppSecret.

Configure profClaw

WECHAT_APP_ID=wx1234567890abcdef
WECHAT_APP_SECRET=your-app-secret
WECHAT_TOKEN=your-verify-token
WECHAT_ENCODING_AES_KEY=your-encoding-aes-key

Environment Variables

WECHAT_APP_ID

string

required

WeChat Official Account AppID.

WECHAT_APP_SECRET

string

required

WeChat Official Account AppSecret.

WECHAT_TOKEN

string

required

Server token for webhook verification.

WECHAT_ENCODING_AES_KEY

string

43-character AES key for encrypted message mode.

Configuration Example

.env
settings.yml

WECHAT_APP_ID=wx1234567890abcdef
WECHAT_APP_SECRET=abc123...
WECHAT_TOKEN=my-verify-token
WECHAT_ENCODING_AES_KEY=yourRandomAESKey43Chars...

chat:
  wechat:
    app_id: "${WECHAT_APP_ID}"
    app_secret: "${WECHAT_APP_SECRET}"
    token: "${WECHAT_TOKEN}"
    encoding_aes_key: "${WECHAT_ENCODING_AES_KEY}"

Notes

Status: Beta
WeChat’s API operates in a passive response model - it sends you a message and you must reply within 5 seconds.
For asynchronous (slow) responses, use customer service messages (requires Service Account).
WeChat server IPs must be whitelisted in the developer settings.
Template messages for proactive outreach require prior user consent and WeChat approval.
Server must be accessible from WeChat’s IP ranges (China-based).

Chat Providers Overview - Compare all 27 supported channels
Zalo - Leading messaging platform in Vietnam
LINE - Dominant messaging platform in Japan and Taiwan
profclaw channels - Enable and test the WeChat connection from the CLI

Chat Providers

​Capabilities

​Requirements

​Setup

​Environment Variables

​Configuration Example

​Notes

​Related

Capabilities

Requirements

Setup

Environment Variables

Configuration Example

Notes

Related