How to Send Zabbix Alerts to WeChat via a Private API Script

1. Register a WeChat public account

Apply for a WeChat public platform account at https://mp.weixin.qq.com/ . One person can register up to five accounts.

After registration, follow Tencent’s prompts, then scan the QR code with your own WeChat to follow the public account.

View the number of users and obtain a user’s WeChat ID by clicking “User” and locating the red ID in the browser.

2. Download and configure the private WeChat API

Clone the repository: git clone https://github.com/lealife/WeiXin-Private-API Copy the files to Zabbix’s alert‑scripts directory and adjust ownership:

# cp -r WeiXin-Private-API/ /usr/local/zabbix/share/zabbix/alertscripts/

# cd /usr/local/zabbix/share/zabbix/alertscripts/WeiXin-Private-API

# chown zabbix.zabbix /usr/local/zabbix/share/zabbix/alertscripts/WeiXin-Private-API

Edit config.php to set your WeChat account, password and cache paths:

$G_CONFIG["weiXin"] = array(
    'account' => 'WeChat public account login',
    'password' => 'WeChat public account password',
    'cookiePath' => $G_ROOT . '/cache/cookie',
    'webTokenPath' => $G_ROOT . '/cache/webToken',
);

Create test.php with the minimal code needed to send a message:

<?php
require "config.php";
require "include/WeiXin.php";

$weiXin = new WeiXin($G_CONFIG['weiXin']);
$testFakeId = "$argv[1]";
$msg = "$argv[3]";
print_r($weiXin->send($testFakeId, "$msg"));

Note: $msg = "$argv[3]" is the third argument passed by Zabbix (the alert content).

3. Create the Zabbix alert script

Create a file named weixin in /usr/local/zabbix/share/zabbix/alertscripts/ containing:

/usr/bin/php /usr/local/zabbix/share/zabbix/alertscripts/WeiXin-Private-API/test.php "$1" "$2" "$3"

Make the script executable and owned by the Zabbix user:

# chown -R zabbix.zabbix weixin

# chmod +x weixin

4. Configure Zabbix

Add a new media type (e.g., “WeChat”) and associate it with a user such as the default administrator.

Create an action that uses this media type; the default conditions are sufficient.

Save the configuration.

5. Verify the integration

Trigger a test alert, for example:

# /usr/local/zabbix/share/zabbix/alertscripts/weixin 770373640 "" "hello"

The script returns a JSON object with ret => 0 and err_msg => ok. Check the WeChat account and you should receive the alert message, confirming that Zabbix alerts are successfully delivered via WeChat.