Documentation

POST <your URL>
Content-Type: application/json
User-Agent: PingZen-Alert-Service/1.0

{
  "text": "🔴 My Website - Service Down",
  "body": "URL: https://example.com\nProtocol: HTTPS\nStatus: DOWN\nResponse Time: 5000ms\n\nOpen monitor: https://pingzen.dev/monitors/123?ws=4",
  "priority": "critical",
  "timestamp": "2026-04-22T10:30:00+00:00",
  "source": "pingzen",
  "monitor_url": "https://pingzen.dev/monitors/123?ws=4",
  "monitor_id": 123,
  "monitor_name": "My Website",
  "trigger": "down",
  "status": "down",
  "probes": [
    {"label": "Moscow", "status": "up", "fail_streak": 0},
    {"label": "Istanbul", "status": "down", "fail_streak": 3}
  ]
}

# configuration.yaml — automations
# 1. Real alerts (DOWN / still_down / recovered / degraded …)
- alias: PingZen alert
  trigger:
    platform: webhook
    webhook_id: pingzen
    allowed_methods: [POST]
    local_only: false
  # IMPORTANT: skip "Test" button deliveries so they don't change entity state.
  # Test payloads carry "test": true (production payloads omit the key).
  condition:
    - "{{ trigger.json.test | default(false) == false }}"
  variables:
    monitor_id: "{{ trigger.json.monitor_id | int(0) }}"
    event:      "{{ trigger.json.trigger }}"   # down | still_down | recovered | degraded | certificate_expiring
  action:
    - choose:
        # Router: react to the first DOWN only, ignore reminders
        - conditions: "{{ monitor_id == 123 and event == 'down' }}"
          sequence:
            - service: light.turn_on
              target: { entity_id: light.kitchen }
              data: { flash: short }
        # NAS: react to the first DOWN AND to reminder pings
        - conditions: "{{ monitor_id == 456 and event in ['down', 'still_down'] }}"
          sequence:
            - service: notify.mobile_app
              data:
                title: "{{ trigger.json.text }}"
                message: "{{ trigger.json.body }}"
        # Any monitor recovered → log it
        - conditions: "{{ event == 'recovered' }}"
          sequence:
            - service: logbook.log
              data:
                name: "PingZen"
                message: "{{ trigger.json.monitor_name }} recovered"
      default:
        - service: persistent_notification.create
          data:
            title: "{{ trigger.json.text }}"
            message: "{{ trigger.json.body }}"

# 2. Sync state from Test click — iterates the monitors array and sets
#    every entity to match PingZen (handy after HA restart or when entity
#    state drifts from reality).
- alias: PingZen sync from Test click
  trigger:
    platform: webhook
    webhook_id: pingzen
    allowed_methods: [POST]
    local_only: false
  # ONLY run on Test deliveries that include the monitors array
  condition:
    - "{{ trigger.json.test | default(false) == true }}"
    - "{{ 'monitors' in trigger.json }}"
  action:
    - repeat:
        for_each: "{{ trigger.json.monitors }}"
        sequence:
          # Adjust this entity_id template to match your naming convention
          - service: "{{ 'input_boolean.turn_on' if repeat.item.status == 'up' else 'input_boolean.turn_off' }}"
            target:
              entity_id: "input_boolean.pingzen_{{ repeat.item.id }}"