Skip to main content

Configure the WeCom Callback

The WeCom callback brings inbound Enterprise WeChat events into Pragma.

Prerequisites​

  • Access to the WeCom admin console.
  • Workspace or server secrets for WECOM_TOKEN, WECOM_ENCODING_AES_KEY, and WECOM_RECEIVE_ID.
  • A public app URL, for example https://app.mikemuellers.de.

Callback URL​

Use this URL in WeCom:

https://app.mikemuellers.de/webhooks/wecom

WeCom uses the same URL for initial verification via GET and encrypted events via POST.

Configure Secrets​

  1. Open Integrations in Pragma, or /admin/integrations as master.
  2. Set WECOM_TOKEN, WECOM_ENCODING_AES_KEY, and WECOM_RECEIVE_ID.
  3. Save and redeploy or restart if the values are server environment variables.
  4. Run WeCom verification again.

Verify​

  1. Send a test message in WeCom.
  2. Open WeCom Events in Pragma.
  3. Confirm a new event appears.
  4. Open the event if you need to inspect the decrypted XML.

Common Issues​

  • Verification fails: token, AES key, or receive ID does not match the WeCom app.
  • Events arrive but messages do not: check whether the event type is supported.
  • 403 or 500: inspect server logs; usually a secret is missing or invalid.