Implementation Plan · v1.0
July 2026
Geeks on Site logo
GeeksonSite × Maven AGI

Two workflows,
end to end.

A Maven AGI voice agent that reschedules and cancels Zoho FSM Service Appointments – across ~9,000 subscribers and 400–700 daily calls – without ever touching the parent Work Order.

~9,000
Active subscribers
400–700
Inbound calls / weekday
~130
Live agents
18 wks
To production
§ 01Executive Summary

The problem is repetitive. The solution is bounded.

A meaningful share of GeeksonSite's daily call volume is routine appointment reschedule and cancel requests. Today, each one pulls an agent into Zoho CRM, over to a linked FSM Work Order, and into a hand-edit on the Service Appointment.

Both flows are deflectable. The customer-facing steps – identify the account, offer a window of open times, move or cancel the appointment – are well-suited to AI. Dispatcher rate negotiation and retention rebooking stay with humans, exactly as they are today.

This plan delivers a Maven AGI integration that handles both workflows end to end across Zoho CRM, Zoho FSM, TextMagic, and email – inside GeeksonSite's existing Zoho Professional plan.

§ 02The Two Workflows

Reschedule and Cancel, both bounded to the Service Appointment.

Workflow A

Reschedule

READ + WRITE
01

Identify the caller

Zoho CRM

Phone search against Zoho CRM. Zero matches → human handoff. Multiple → confirm by name or address.

02

Find the appointment

Zoho FSM

Traverse from account to linked Work Orders and open Service Appointments. Disambiguate by ticket ID first, then next-upcoming.

03

Confirm before changing

Read the appointment (date, time, address, ticket ref) back to the caller before touching anything.

04

Offer a curated slot set

Zoho FSM

Query available slots across a 2–3 day window, filtered by service territory and skill. Present a bounded set – never a raw list.

05

Commit date and time only

Update the Service Appointment. No technician lock-in. FSM round-robin re-routes to a dispatcher for negotiation, exactly as today.

Workflow B

Cancel

BLUEPRINT + NOTIFY
01

Identify & confirm

Steps 1–3 mirror reschedule: phone → account → appointment → read-back confirmation.

02

Capture a reason

Prompt for cancellation reason. If declined, default to "Customer declined to specify" so the cancellation is still recorded.

03

Blueprint cancel – Service Appointment only

Zoho FSM

Dynamically resolve the current 'Cancel' transition and commit it with the reason written to the mandatory Notes field.

04

Preserve the Work Order

Guardrail

Enforced in code and validated by a monitored guardrail. Retention rebooks against the parent WO.

05

Fan-out notifications

TextMagic + Email

In parallel: SMS to the technician (TextMagic), email to the technician, email to Retention. Durable per-channel retry.

§ 03Systems in Scope

Four systems. One orchestrator. One guardrail.

Maven sits between the voice channel and GeeksonSite's stack. Every outgoing write is scoped – reschedule touches only the Service Appointment date/time, and cancel touches only the Service Appointment blueprint. The Work Order is never mutated.

Caller
Voice channel (Five9 or successor)
Maven AGI
Voice agent · orchestration · guardrails
Zoho CRM
Read · phone → account → WO
Zoho FSM
Read slots · reschedule · blueprint cancel
TextMagic
Write · SMS to technician
Email
Write · technician + retention
Reads: phone search, related-list, slot discovery, blueprint state Writes: SA reschedule (date/time), SA blueprint cancel, SMS, email
§ 04Phase Structure

Four phases. Three buffers. Eighteen weeks.

Each build phase is followed by a stabilization week. Nothing moves forward until the previous phase is proven in sandbox.

W1–3
PHASE 1

Foundation & Configuration

Access, credentials, sandbox validation, configuration discovery.

W4
BUFFER

Stabilization Buffer

Foundation items green before workflow work begins.

W5–8
PHASE 2

Reschedule Workflow

Caller ID, disambiguation, slot discovery, reschedule commit.

W9
BUFFER

Stabilization Buffer

Reschedule proven end to end in sandbox.

W10–13
PHASE 3

Cancel Workflow & Notifications

Blueprint transitions, Work Order guardrail, durable notification pipeline.

W14
BUFFER

Stabilization Buffer

Cancel and notifications proven before go-live prep.

W15–18
PHASE 4

Testing, UAT & Go-Live

End-to-end validation, GeeksonSite UAT, production cutover.

§ 05Business Outcomes

What "done" looks like.

≥ 99%
Notification delivery success (at least one channel per cancel)
0
Accidental Work Order mutations – any occurrence is Priority 0
> 90%
Slot-offer success (at least one in-window slot presented)
100%
Retention email fires on every cancellation
TBD
Reschedule/cancel containment rate – target set after two weeks live
Agent handle time on reschedule and cancel – measured vs. pre-integration baseline
§ 06RACI

Who owns what.

Workstream
GeeksonSite DRI
Maven DRI
Phase
Zoho API user & OAuth provisioning
Carlos Loyola
Maven Delivery Lead
1
Sandbox environment & seed data
Carlos Loyola
Maven Delivery Lead
1
Configuration discovery
Carlos Loyola
Maven Delivery Lead
1
Caller ID & appointment lookup
Jeremias Sanchez
Maven Delivery Lead
2
Slot discovery & reschedule commit
Freddy Lopez
Maven Delivery Lead
2
Blueprint cancel & WO guardrail
Freddy Lopez
Maven Delivery Lead
3
Technician & retention notifications
Freddy Lopez
Maven Delivery Lead
3
UAT & voice-script sign-off
Jeremias Sanchez, Freddy Lopez
Maven Delivery Lead
4
Production cutover
Carlos Loyola, Freddy Lopez
Maven Delivery Lead
4
Post-go-live operations & monitoring
Freddy Lopez
Maven Customer Experience
Ongoing
§ 07Risks & Mitigations

Every risk has a written mitigation.

Risk 01
Accidental cancellation or mutation of a Work Order
Impact · HighLikelihood · Low
Mitigation

Hard code-level guardrail restricting cancel to the Service Appointment. Monitored counter must remain zero; any occurrence is a Priority 0 alert. Explicit test coverage before go-live.

Risk 02
Missed technician notification → tech drives to a cancelled job
Impact · HighLikelihood · Low–Med
Mitigation

Multi-channel (email + SMS) with independent per-channel retry. Durable delivery survives process interruption. Terminal-failure alert if all retries exhaust.

Risk 03
Zoho FSM Professional appointment cap (2,000/mo, ~80% utilized)
Impact · LowLikelihood · Low
Mitigation

Reschedule edits an existing appointment; cancel removes one – neither workflow increases count. Monitor usage; revisit plan tier if retention rebooking shifts volume.

Risk 04
Slot discovery latency degrades voice interaction
Impact · MedLikelihood · Low
Mitigation

Parallelized within Zoho rate limits, presented slot set is capped, latency benchmarked before go-live.

Risk 05
Territory/skill resolution returns no slots (data gap)
Impact · MedLikelihood · Med
Mitigation

Multi-mode territory resolution with fixed-territory fallback. If no slots, offer widened window or graceful handoff.

Risk 06
Caller identity spoofing on cancel (ANI is weak)
Impact · MedLikelihood · Low
Mitigation

Appointment is always read back for explicit confirmation before commit. Optional name / service-zip confirmation added in Phase 1 if GeeksonSite requires.

Risk 07
Zoho rate-limit or credit exhaustion at peak
Impact · MedLikelihood · Low
Mitigation

All calls rate-limit-guarded. Daily and per-minute credit usage monitored; alert as ceiling approaches.

Risk 08
Ambiguous account/ticket disambiguation over voice
Impact · MedLikelihood · Med
Mitigation

Clear reference cues (ticket ID, date, address). Disambiguation rule defined jointly in Phase 1: ticket-ID-first, then next-upcoming.

Risk 09
Notification vendor outage (TextMagic or email)
Impact · MedLikelihood · Low
Mitigation

Independent per-channel retry; one failing channel doesn't affect the other. Terminal-failure alert surfaces affected appointments for manual outreach.

Risk 10
Sandbox not representative of production
Impact · MedLikelihood · Low
Mitigation

Phase 1 explicitly confirms blueprint, territory, and skill config mirror production. Gaps closed before Phase 2 begins.

§ 08Key Milestones

Nine checkpoints between kickoff and rollout.

W3

Foundation complete

OAuth verified in sandbox; all config inputs collected; connectivity green across Zoho CRM, FSM, TextMagic, and email.

W4

Foundation stabilization

Outstanding foundation blockers cleared before workflow development begins.

W8

Reschedule complete in sandbox

End-to-end reschedule succeeds with unmodified Work Order and unlocked technician; slot discovery within voice-latency target.

W9

Reschedule stabilization

Reschedule proven stable across representative scenarios.

W13

Cancel & notifications complete

Cancel leaves WO open, writes Notes, delivers all notifications, resumes across simulated interruption.

W14

Cancel stabilization

Cancel and notification pipeline stable across full edge-case matrix.

W17

GeeksonSite UAT sign-off

Operations, dispatch, and retention teams sign off; voice scripts and notification content approved.

W18

Production go-live

Cutover checklist signed; monitoring dashboards live; runbook handed off.

W19–20

Post-go-live monitoring

24-hour, 1-week, and 2-week check-ins; containment and delivery targets reviewed jointly.

§ 09Not Included in This Implementation

Already proven Maven workflows, and what will stay with Geeks on Site.

Some items below are proven Maven capabilities that GeeksonSite has already seen and could be added as follow-on phases. Others are business decisions that stay with GeeksonSite by design. Each is called out so the scope boundary is clear without implying a capability limit where none exists.

§ 9.1

Proven Maven capabilities available for future phases

Maven has already demonstrated or has a live reference customer for each of these. Not built into this implementation, but layerable as follow-on scopes once reschedule and cancel are stable in production.

Future phase

Monthly tune-up outbound reminder calls

Demonstrated live on the July 14 call using the Antidote Health reference customer's voice agent (subscriber authentication, in-call tune-up booking, SMS confirmation). Ready to adapt as a follow-on phase.

Future phase

New inbound appointment booking

Demonstrated in a prior session. A caller with no prior appointment can book a first-time visit end to end.

Future phase

Post-dispatch appointment confirmation calls

Raised by Freddy on the July 14 call. Same outbound pattern as tune-up, triggered by a Zoho FSM state change when the dispatcher confirms tech assignment.

Future phase

Test-and-done verification workflow

Slack-triggered outbound call to verify a remote fix, with Zoho Desk closure on a positive response and handoff to a live agent otherwise.

Future phase

Outbound phone-call notification to the technician on cancel

Email + SMS ship in Phase 3. The notification pipeline is designed so a phone-call channel can be added later without redesign.

§ 9.2

Business boundaries that stay with GeeksonSite

Handled by GeeksonSite by design. Not part of any Maven scope, current or future.

Stays with GoS

Dispatcher-to-technician negotiation call

After a reschedule, negotiation on rate and availability continues with a GeeksonSite dispatcher exactly as it is today. FSM round-robin re-routes the moved appointment for follow-up.

Stays with GoS

Refund issuance

All refund decisions are made by GeeksonSite's retention team. The voice agent makes no statement about refunds. The retention email hands the customer off for human follow-up.

Stays with GoS

Locking a specific technician into a reschedule slot

Consistent with today's process, the AI offers open windows without guaranteeing a specific technician. Assignment is finalized by the dispatcher.

§ 10Open Questions

Ten items to close in Phase 1.

None of these block engagement start. Each is tracked as a configuration or product-decision input for Foundation.

  1. 01Exact Zoho CRM related-list API name linking Account/Contact to the FSM Work Order.
  2. 02Territory resolution mode: appointment-inherited, address-derived, or single fixed territory.
  3. 03Zoho FSM skill IDs mapped to common job types for slot filtering.
  4. 04Exact label of the 'Cancel' transition on the Service Appointment blueprint.
  5. 05Whether ANI alone is sufficient for cancel, or a name / service-zip confirmation is required.
  6. 06Confirmation of the cancellation-reason policy (prompt but don't block; default when declined).
  7. 07Confirmation of the multi-appointment tiebreak: ticket ID first, then next-upcoming.
  8. 08TextMagic credentials & rate tier; email send path; retention distribution address.
  9. 09How commonly appointments lack an assigned technician; completeness of Service Resource contacts.
  10. 10Confirmation that FSM round-robin reassigns rescheduled appointments to a dispatcher when technician fields are omitted.