How to Send Zabbix Alerts to Feishu Groups Using Python API

Implementation Overview

Feishu provides rich APIs for sending messages. This guide shows how to use the Feishu API to send text messages from Zabbix alerts.

Authorization Tokens

Three tokens are required:

app_access_token – access App resources.

tenant_access_token – access enterprise resources.

user_access_token – access user resources.

Getting Authorization Tokens

1. Obtain App ID and App Secret

Log in to the developer console, create a self‑built enterprise app, and retrieve the App ID and App Secret.

2. Get tenant_access_token

Use the self‑built app method to request a tenant access token.

3. Request token with App ID and Secret

def gettenant_access_token():
    tokenurl="https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal/"
    headers={"Content-Type":"application/json"}
    data={"app_id":"cli_9ec625abcdefg","app_secret":"f716Gi27Yi25n5K0Wbafgwghhstv"}
    request=requests.post(url=tokenurl,headers=headers,json=data)
    response=json.loads(request.content)['tenant_access_token']
    return response

Getting user_id

user_id can be retrieved by mobile number or email via the Feishu user API.

def getuserid(tenant_access_token):
    # mobiles="15101234584"
    userurl="https://open.feishu.cn/open-apis/user/v1/batch_get_id?mobiles=%s"%mobiles
    headers={"Authorization":"Bearer %s"%tenant_access_token}
    request=requests.get(url=userurl,headers=headers)
    response=json.loads(request.content)['data']['mobile_users'][mobiles][0]['user_id']
    return response

Getting chat_id

Two methods exist: add the bot to a group and read the group info, or create a group via the bot. The example uses the first method.

Add bot to group

Request chat_id

def getchatid(tenant_access_token):
    #获取chatid
    chaturl="https://open.feishu.cn/open-apis/chat/v4/list?page_size=20"
    headers={"Authorization":"Bearer %s"%tenant_access_token,"Content-Type":"application/json"}
    request=requests.get(url=chaturl,headers=headers)
    response=json.loads(request.content)['data']['groups'][0]['chat_id']
    return response

Send Message to Feishu Group or User

Provide user_id, chat_id, and tenant_access_token, then send the alert text.

def sendmes(user_id,chat_id,tenant_access_token):
    #向群里发送消息
    sendurl="https://open.feishu.cn/open-apis/message/v4/send/"
    headers={"Authorization":"Bearer %s"%tenant_access_token,"Content-Type":"application/json"}
    data={"chat_id":chat_id,
        "msg_type":"text",
        "content":{
            "text":"%s<at user_id=\"%s\">test</at>"%(messages,user_id)
        }
    }
    request=requests.post(url=sendurl,headers=headers,json=data)
    print(request.content)

Configure Zabbix Alert Action

Media Type

Set the correct parameter order.

User Contact

Enter the phone number registered in Feishu.

Action

Alert Test

Disable one Windows agent to trigger a test alert.

Full code is available on GitHub: https://github.com/sunsharing-note/zabbix/blob/master/feishu.py

Feel free to discuss.