Docs / Scheduling & dispatch / Weather-aware scheduling

Weather-aware scheduling

How the weather overlay works, what counts as "risky," and how to handle inclement weather days.

The dispatcher shows weather context for the selected day. It is not automatic rescheduling — it is a heads-up so you can make the call.

How it works

The system queries api.weather.gov twice: once to resolve your tenant's primary address to a grid, and again to get the 24-hour forecast for that grid. Results are cached 3 hours per lat/lng. The forecast surfaces:

  • Temperature (high/low for the day)
  • Short forecast ("partly cloudy", "rain likely", "windy")
  • Wind speed
  • Rain probability

What counts as "risky"

Current thresholds (configurable in settings roadmap):

  • Rain probability >= 50%
  • Sustained wind >= 25 mph
  • Temperature below 28°F or above 100°F (for outdoor work safety)

When any threshold is crossed, the weather chip on the dispatcher turns amber, and every scheduled visit chip for that day gets an amber outline with a ⚠ prefix.

How to handle a risky weather day

  1. Check the dispatcher the evening before. If tomorrow is flagged, review affected visits.
  2. For each visit, decide: reschedule, push to end-of-day, or proceed.
  3. To reschedule, open the visit and change scheduled_for. This fires a "visit.rescheduled" notification to the client in their preferred language.
  4. To push to end-of-day, drag the chip on the dispatcher (this reassigns time but fires the same reschedule notification).
💡
Homeowners strongly prefer to hear "we're moving your visit to Thursday because of the rain" 24 hours in advance vs. "we didn't come today." Use the amber flag as your "text the client now" signal.
US-only. api.weather.gov is a US federal service. If your shop is in Canada, the UK, or elsewhere, the weather chip will stay blank. International weather support is on the roadmap (Q3 2026, via Open-Meteo).

Was this article helpful?

Contact support