Connectivity

Real-Time Monitoring

Wede continuously monitors connectivity across all operational zones. Each zone has an independent connectivity state that reflects current network conditions in that geographic area. State changes are detected automatically and trigger channel switching without any action required from your integration.

Connectivity States

State	Description	Action
online	Full internet connectivity	Primary REST channel active
degraded	Reduced bandwidth or reliability	Compressed REST, optimised routing
sms_only	Internet unavailable	Structured protocols and voice delivery active
offline	All external channels down	LoRa, satellite, edge processing

Channel Hierarchy

When a zone’s connectivity degrades, Wede activates the next available channel automatically: The channel used for each event delivery is included in the API response and webhook payload, giving you full visibility of how each event was delivered.

Reporting Connectivity

Your field devices and systems can report connectivity state to Wede:

curl -X POST https://api.wede.pt/v1/connectivity/report \
  -H "x-wede-api-key: wede_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "zone_code": "zone_hospital_evora",
    "state": "degraded",
    "signal_strength": -85,
    "channel": "sms"
  }'

Checking Connectivity Status

curl https://api.wede.pt/v1/connectivity/status \
  -H "x-wede-api-key: wede_live_YOUR_KEY"

Response:

{
  "zones": [
    {
      "zone_code": "zone_hospital_evora",
      "connectivity_state": "online",
      "last_updated": "2026-05-19T10:00:00Z",
      "channels_available": ["rest_full", "rest_compressed", "sms"]
    }
  ]
}

Webhook Notifications

When a zone changes connectivity state, Wede notifies your configured webhooks immediately:

{
  "event": "zone.state_changed",
  "zone_code": "zone_hospital_evora",
  "previous_state": "online",
  "current_state": "sms_only",
  "timestamp": "2026-05-19T10:15:00Z"
}

Configure webhooks in the dashboard or via the API.

Dashboard Visibility

All zone connectivity states are visible in real-time on the dashboard map. Each zone is represented by a colour-coded marker:

🟢 Green - online
🟡 Amber - degraded or structured-protocol-only
🔴 Red - offline
⚪ Pulsing - incident active

Introduction

Core Concepts

Examples by Vertical

Real-Time Monitoring

Connectivity States

Channel Hierarchy

Reporting Connectivity

Checking Connectivity Status

Webhook Notifications

Dashboard Visibility

​Real-Time Monitoring

​Connectivity States

​Channel Hierarchy

​Reporting Connectivity

​Checking Connectivity Status

​Webhook Notifications

​Dashboard Visibility

Real-Time Monitoring

Connectivity States

Channel Hierarchy

Reporting Connectivity

Checking Connectivity Status

Webhook Notifications

Dashboard Visibility