Integrate ThinkBroadband webhook notifications #140
Description
Background
ThinkBroadband is exploring HTTP webhook support for their BQM service. This would allow DOCSight to receive push notifications for events like latency spikes, packet loss alerts, and ISP-wide pattern detection — instead of relying solely on polling.
Proposed Solution
Add a webhook receiver endpoint in DOCSight that ThinkBroadband can call with notification data.
Potential Use Cases
- Individual alerts: Latency spike or packet loss detected on the user's monitor
- ISP pattern alerts: Widespread issues detected across multiple monitors in a region
- Surface alerts as DOCSight notifications alongside DOCSIS signal alerts
- Long-term: Feed ISP-wide patterns into community segment analysis (Opt-in community segment heatmap #61)
Status
Blocked — waiting for ThinkBroadband to define and ship their webhook format. This issue tracks the DOCSight side of the integration.
When Ready
- Define webhook receiver endpoint (
/api/bqm/webhookor similar) - Parse and validate incoming webhook payloads
- Store events and surface them in the DOCSight notification system
- Allow users to configure which alerts they want to receive
- Documentation for users on how to set up the webhook URL in their BQM account