1. Missed-collection report → verified, approval-gated route fix
A resident or commercial client reports a missed bin. Today it's a call the office logs by hand, someone checks whether the truck actually skipped it, and a make-good pickup or route tweak is arranged informally — slow, inconsistent, and easy to lose.
Trigger: WhatsApp / SMS (resident report) or Webhook (portal ticket)
How the workflow runs
- Trigger
Missed pickup reported. A WhatsApp/SMS trigger (or a Webhook from the client portal) captures the report with the address/account and bin type.
- Agent
Log + answer the routine part. An Agent node identifies the account, answers bin/route status questions ('when is my next collection?') from the schedule, and drafts a structured missed-collection case for anything needing action.
- Tool (MCP)
Check the collection record. A Tool (MCP) node queries the route/fleet system for that stop — was the bin served, was the truck on-route — so a make-good is only arranged when the miss is real. Route/fleet software has no first-party connector; MCP calls yours.
- Condition
Real miss vs. already served. A Condition node closes cases where the record shows the stop was served (with an explanation to the reporter), and continues only genuine misses to the fix path.
- Approval
Dispatcher approves the route change. An Approval node holds any make-good pickup or route change for a dispatcher — a truck re-route is an operational + cost decision, so it never auto-schedules. This is the core control.
- Output
Confirm the make-good. On approval, a Tool (MCP) node adds the make-good to the route and an Output node tells the reporter the day/window on WhatsApp/SMS.
Channels & connectors
- SMS
- Webhook
- Tool (MCP → route/fleet)
- Approval / HITL
Outcome
Every missed-collection report is logged, verified against the actual collection record, and turned into an approved make-good — with the reporter kept informed automatically, day or night.
Why it helps
Verifying against the fleet record before acting stops needless truck re-rolls on stops that were actually served, and the approval gate keeps a human owning the route decision — the value is a consistent, checked process and a trail, not an autonomous scheduler.
Build spec
1 agent — 1 intake/triage agent; the collection-record check, real-miss split and dispatcher sign-off are workflow nodes.
System prompt (paste-ready)
You are a waste-collection support agent for {{company}}. Residents and commercial clients message about missed pickups and collection schedules. Identify the account from the address/account id. For a schedule question, answer the next collection day/window from the route schedule only. For a missed-collection report, produce a structured case {account, address, bin_type, reported_date, scheduled_date}. Do NOT confirm a make-good pickup or any new collection date yourself — only propose the case; a dispatcher approves the route change. Never invent a collection date, and never promise a service the schedule doesn't show.MCP connectors
- Route / fleet-management system — via a Tool (MCP) node (no first-party connector)
- Client portal tickets — inbound via Webhook trigger
- WhatsApp / SMS — report + confirmation channel
Built-in tools
- knowledge_search (collection calendar, service areas, bin-type rules)
- http_request (collection-record / GPS-served lookup)
Guardrails
- Every make-good pickup or route change passes the Approval node — the agent proposes, a dispatcher authorises the operational + cost decision
- A make-good is only proposed when the fleet record shows a genuine miss — stops the record confirms were served are closed with an explanation, never re-rolled
- Collection dates and windows are read from the route schedule/record — the agent never invents a date or promises unscheduled service; each report is idempotent per account+date so a re-send never double-books
Cost strategy
An economy/standard-tier agent handles this — account matching, schedule lookup and case-drafting are lightweight, so no premium model is needed. Pure schedule questions (the highest-volume, lowest-value traffic) resolve on the first turn without a human, and the fleet-record check filters non-misses at the Condition node before any costly re-route reaches the dispatcher; run simple turns on the economy model via cost routing.
Output & delivery
The agent logs the report and answers schedule questions directly; a Tool node checks the collection record, the Condition node closes already-served stops, and genuine misses go to the dispatcher Approval node; on approval a Tool node adds the make-good to the route and an Output node confirms the day/window to the reporter on WhatsApp/SMS.