Integrations / Zabbix

Zabbix logo

Monitoring · HTTP checks + webhook media type

Zabbix + Sendjade

Monitor your numbers in Zabbix, and deliver Zabbix alerts to WhatsApp.

Works with the live API

What you can automate

  • Alert when an instance is not authorized
  • Alert when the outgoing queue is backing up
  • Deliver Zabbix alerts as WhatsApp messages

Before you start

  • A Sendjade account with a connected instance (status Authorized). See Getting started.
  • Your **idInstance** (shown on the instance page in the console) and **apiTokenInstance** (shown once when you created the instance; press Generate new token if you lost it). Use a spare number while testing.
  • Zabbix 6.0 or newer with permission to create items and media types.

Set it up

  1. 1. Check instance health

    Create an HTTP agent item (or an external check) that reads the connection state. authorized is healthy; anything else (notAuthorized, starting, blocked) should alert. The token never expires on its own, so no re-sign-in is needed.

    External check script
    curl -s "https://api.sendjade.com/waInstanceYOUR_ID_INSTANCE/getStateInstance/YOUR_API_TOKEN_INSTANCE" | jq -r .stateInstance
  2. 2. Watch the queue (optional)

    A growing queue means messages are not leaving, for example because the number is disconnected or capped. Alert when buffer stays high.

    External check script
    curl -s "https://api.sendjade.com/waInstanceYOUR_ID_INSTANCE/getMessagesCount/YOUR_API_TOKEN_INSTANCE" | jq .buffer
  3. 3. Trigger on it

    Create a trigger such as last(/host/sendjade.state)<>"authorized" so a dropped or logged-out number raises a problem.

  4. 4. Deliver alerts to WhatsApp

    Create a Webhook media type with parameters idInstance, token, to and message, and this script.

    Media type script
    var p = JSON.parse(value);
    var req = new HttpRequest();
    req.addHeader('Content-Type: application/json');
    
    var resp = req.post('https://api.sendjade.com/waInstance' + p.idInstance + '/sendMessage/' + p.token, JSON.stringify({
      chatId: p.to,
      message: p.message
    }));
    
    if (req.getStatus() !== 200) {
      throw 'Sendjade returned HTTP ' + req.getStatus() + ': ' + resp;
    }
    return 'OK';

Test it

Stop one instance in the console. Within one check interval the trigger fires and the alert message reaches your phone.

Troubleshooting

The check returns an empty result

The idInstance or token is wrong (a wrong token returns 401). Copy them again, or generate a new token and update the item.

I get 401 unauthorized

The idInstance or token in the URL is wrong. Copy both again from the console. Generating a new token makes the old one stop working immediately.

I get 409 instance_not_connected

The instance is not Authorized yet. Open it in the console, press Connect and scan the QR code.

I get 400 invalid_chat_id

Use international format with digits only, e.g. 2348012345678 (or 2348012345678@c.us). Remove spaces, dashes and the leading zero of the local number.

I get 422 recipient_opted_out

That person replied STOP (or was added to the opt-out list). Sendjade refuses to message them. Remove the number from Opt-outs only if they asked to hear from you again.

I get 429 daily_limit_reached or rate_limited

The number reached its 24-hour sending cap (default 500) or you are calling too fast. The cap protects your number from restriction. Slow down, and raise the cap only if your volume is genuine.

Ask AI to help me integrate Zabbix

Copy this prompt into ChatGPT, Claude or any assistant. It already knows Sendjade’s API, so the answer matches our endpoints.

The prompt is plain text that you copy yourself. Never paste real keys into an assistant; use placeholders.