Pikud HaOref Alerts

A real-time alert service that brings Home Front Command warnings to Telegram and WhatsApp.

The Premise· Technical Constraint & Friction

Pikud Haoref's own alert channels aren't easy to wire into a Telegram or WhatsApp channel, so communities and individuals lack a simple way to get real-time alerts where they already are.

Architecture & Event Flow

Realtime Event Pipeline

01 // INGESTIONFEED INTAKE
Home Front Command Official Feed

Direct Official Channel

02 // PROCESSINGTRANSFORM
Polygon Geocoding & Area Filtering

Deduplication & Polygons

03 // EGRESSBROADCAST
Telegram & WhatsApp Broadcast Channels

Target Channels & Groups

Field Notes & Process·4 min read

Overview

A real-time alert service built around two connected parts: the alert bot and its public landing page. It polls the Home Front Command feed, formats alerts with affected areas and shelter countdowns, and delivers them to Telegram and WhatsApp.

The landing page is the best place to understand the service and join an existing channel. The bot is relevant for people who want to self-host their own instance.

The need

The official alert source exists, but isn’t something a community Telegram channel or WhatsApp group can consume directly — someone has to bridge it.

Product goals

  • Get real-time alerts into channels people already watch, with minimal delay.
  • Keep the wrapper library reusable on its own, independent of the Telegram/WhatsApp layer.

Constraints

  • Depends on an unofficial, undocumented API — subject to change without notice.
  • Solo-maintained open-source project.

The solution

A published library (Apache 2.0) with a versioned release process, Docker support, and CI/CD via GitHub Actions, plus a companion static landing page describing setup and linking to the live Telegram channel and WhatsApp group.

Product experience

Delivered as alert messages in Telegram/WhatsApp rather than a visual app; the landing page is the public-facing surface.

The process

Actively maintained since March 2026, currently at v0.5.3, with a public changelog and CI pipeline.

AI-assisted workflow

Built with AI-assisted coding for the wrapper logic and bot integration, with manual review given the real-time, public-safety nature of the alerts.

Current state

Active — running, versioned, with a live Telegram channel and WhatsApp group.

What is next

Ongoing maintenance as the underlying unofficial API changes.

Lessons learned

Wrapping an unofficial, undocumented API for a real-time public-safety use case means the integration layer needs to be defensive and versioned from day one.

Maturity & Scope

Current Reality

Verified tool boundaries and unsupported runtime edge cases

What works today
  • Broadcast service on standby; open-source codebase available for self-hosting and contributions.
  • Open-source self-hostable service with configurable notification filters.
Open questions and next challenges
  • ?Direct push notification channel without intermediary chat platform dependency.

Follow on Google Search

Add Bersaglio as a preferred source to prioritize our notes, research, and product insights in Search and AI Overviews.

Accessibility options

Customize display preferences. These controls do not replace accessible site markup or assistive technology testing.