Skip to main content

Configure Private WeChat Work Address

In WeDa private deployment environments, when you need to push approval workflow messages to WeChat Work, you need to configure the access address for private WeChat Work. This document provides detailed instructions on how to configure it in different deployment modes.

Prerequisites

Important Notice

Before starting the configuration, please ensure you have obtained the access address for private WeChat Work.

Configuration Methods

Standalone Deployment

Step 1: Modify Configuration File

  1. Navigate to the WeDa installation directory:

    cd /data/tencent/weda
  2. Edit the config.yaml configuration file and add WeChat Work configuration:

    weixin:
    tokenWxUrl: https://<private-wechat-work-address>/cgi-bin/gettoken?corpid={0}&corpsecret={1}
Configuration Instructions

Please replace <private-wechat-work-address> with your actual private WeChat Work access address.

Step 2: Get Latest Version

Download the latest installation script:

wget -L -O install.sh https://software-1302110647.cos.ap-guangzhou.myqcloud.com/rc/lastest/install.sh && chmod +x install.sh

Step 3: Restart Service

Execute the upgrade script to make the configuration take effect:

./upgrade.sh

Cluster Deployment

Step 1: Get Installation Tools

Obtain the latest cluster deployment tools. For detailed download methods, please refer to: Online Installation Guide

Step 2: Modify Configuration File

  1. Find the config.yaml configuration file in the installation directory

  2. Add WeChat Work configuration under the weda field:

    weda:
    weixin:
    tokenWxUrl: https://<private-wechat-work-address>/cgi-bin/gettoken?corpid={0}&corpsecret={1}
Configuration Instructions

Please replace <private-wechat-work-address> with your actual private WeChat Work access address.

Step 3: Redeploy Service

Execute the installation command to make the configuration take effect:

./wedaCli install

Configuration Verification

After completing the configuration, you can verify whether the configuration is effective through the following methods:

  1. Check Service Status: Confirm that related services have restarted normally
  2. Test Message Push: Create a test approval workflow to verify whether messages can be pushed to WeChat Work normally
  3. View Logs: If you encounter problems, you can check service logs for troubleshooting

Important Notes

Important Reminders
  1. It is recommended to backup the original configuration file before modifying it
  2. Related services must be restarted after configuration changes to take effect
  3. Please ensure network connectivity to the private WeChat Work address
  4. If using HTTPS protocol, please ensure certificate configuration is correct

Common Issues

Message Push Failure After Configuration

Possible Causes:

  • Incorrect WeChat Work address configuration
  • Network connectivity issues
  • WeChat Work application configuration problems

Solutions:

  1. Check if the address in the configuration file is correct
  2. Test network connectivity
  3. Verify the corpid and corpsecret configuration of the WeChat Work application

Service Restart Failure

Possible Causes:

  • Configuration file format error
  • Insufficient permissions

Solutions:

  1. Check if the YAML file format is correct
  2. Ensure sufficient operation permissions
  3. View detailed error logs

If you encounter other issues, please contact technical support for assistance.