Agent Foundation

Java Spring Boot service for Enterprise WeChat callbacks and internal APIs.

Core API

• POST /v1/chat/completions
• GET /v1/healthz

WeCom Callback

• Callback URL: /v1/integrations/wecom/callback
• Verifies Enterprise WeChat callback signatures
• Decrypts encrypted callback payloads when safe mode is enabled
• Deduplicates text messages
• Sends Enterprise WeChat text content to the configured Coze workflow
• Sends the Coze workflow reply back to the same Enterprise WeChat user

The old internal agent orchestration code has been removed. Intelligent responses now go through Coze while keeping this callback entrypoint.

Coze Workflows

Configure multiple Coze workflow agents under foundation.coze.workflows. Business code calls them by key, for example wecom-default.

foundation:
  coze:
    default-workflow: wecom-default
    workflows:
      wecom-default:
        workflow-id: "7661923520095862811"
        app-id: "7661851003527954473"
        parameters: {}

Required env vars

• DEEPSEEK_API_KEY
• WECOM_CORP_ID
• WECOM_AGENT_ID
• WECOM_SECRET
• WECOM_TOKEN
• COZE_API_KEY

WeCom backend settings

1. Create a WeCom self-built app.
2. Enable message receive API and set callback URL to:
   • https://your-domain/v1/integrations/wecom/callback
3. Set callback Token equal to WECOM_TOKEN.
4. Make sure app has send-message permission to internal users.

Run

1. Set env vars.
2. Start app from IDE or mvn spring-boot:run.