Zum Hauptinhalt springen

WeCom Callback einrichten

Der WeCom Callback bringt eingehende Enterprise-WeChat Events in Pragma. Danach erscheinen Nachrichten und Roh-Events im Workspace.

Voraussetzungen​

  • Zugriff auf die WeCom Admin-Konsole.
  • Workspace- oder Server-Secrets für WECOM_TOKEN, WECOM_ENCODING_AES_KEY und WECOM_RECEIVE_ID.
  • Eine öffentlich erreichbare App-URL, zum Beispiel https://app.mikemuellers.de.

Callback-URL​

Trage in WeCom diese URL ein:

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

WeCom nutzt dieselbe URL für die initiale Verifikation per GET und für verschlüsselte Events per POST.

Secrets setzen​

  1. Öffne in Pragma Integrations oder als Master /admin/integrations.
  2. Setze die drei WeCom-Werte:
    • WECOM_TOKEN
    • WECOM_ENCODING_AES_KEY
    • WECOM_RECEIVE_ID
  3. Speichere und deploye oder starte den Dienst neu, wenn die Werte als Server-Env gesetzt wurden.
  4. Wiederhole die WeCom-Verifikation.

Prüfen​

  1. Sende eine Testnachricht in WeCom.
  2. Öffne in Pragma WeCom Events.
  3. Prüfe, ob ein neues Event erscheint.
  4. Öffne das Event, wenn du das entschlüsselte XML kontrollieren willst.

Häufige Probleme​

  • Verifikation schlägt fehl: Token, AES-Key oder Receive-ID passen nicht zur WeCom-App.
  • Events kommen an, aber Nachrichten fehlen: Prüfe, ob die Event-Art unterstützt wird und ob der Workspace korrekt aufgelöst wird.
  • 403 oder 500: Server-Logs prüfen; meistens ist ein Secret leer oder falsch.

Betrieb​

Lege nach der Einrichtung einen Monitoring-Check auf /readyz und prüfe regelmäßig die WeCom Event-Liste, wenn WeCom geschäftskritisch ist.