Support Team Guidelines
Table of Contents
Core Principles
Answer Quality Standards:
- Link to relevant documentation AND explain specific steps for their scenario
- Include screenshots/Loom for complex issues or when no doc exists
- Provide direct links to relevant pages in the client's account
- Screenshot anything in the account that might change
One-Touch Solve:
- Aim to resolve in one response
- Educate clients so they can self-serve next time
- Delete unnecessary information that causes confusion
- If you write the same answer 3 times without a doc, we need documentation
Documentation Rule: After 3 duplicate answers without a support doc reference, bring to CS leadership with examples so that we can see about creating a new Support Doc
Team Structure
| Tier | Scope | Time Limit |
|---|---|---|
| Triage | Read every new ticket, assign appropriately | Immediate |
| T1 | Straightforward doc-based answers | <5 min research + <5 min answer |
| T2 | Research required, system interactions | <15 min research + <15 min answer |
| T3 | Dev research: changelog, logs, code debugging | <20 min; escalate if stuck |
| T4 | Complex dev research, deeper system knowledge | Varies; monitor queues |
| T5 | Roadmap/strategic decisions | As needed |
| On-Call | System-wide emergencies, database updates | 1-hour response required |
Escalation Triggers:
- Juniors: Skip if outside time limits [DEFINE JUNIOR/SENIOR?]
- Seniors: Escalate if outside time limits
- T3: Escalate after 20 minutes without progress
Workflows
Triage Process
Actions:
- Handle trivial/urgent issues immediately (macros, 2FA, locked accounts)
- Escalate system outages to On-Call
- Escalate research needs to T2 with transition comment
- Assign to T1 if no backlog exists
T1-T2 Workflow
- Answer if possible, otherwise escalate
- Always add transition comment before escalating
- Provide relevant information in Internal Notes
T3 Workflow
Daily checks:
- Aim to start all tickets within 24 business hours of escalation
- Send status update if unanswered for 2 business days
Bug handling:
- Create GitHub issue and DPAF entry
- Create PR if fix is straightforward
- Escalate to T4 for verification
- Leave the GH unassigned (if not hotfixing), or assigned to yourself (if hotfixing). Escalate the Zoho Ticket or Forum Topic to T4.
- If submitting a PR for the GH as well, add the "possible-hotfix" label and assign the GH to T4 after submitting the PR.
Additional duties:
- Monitor Dev Phone a Friend forum
- Debug GVR price accuracy issues
T4/On-Call Workflow
Responsibilities:
- Own overall issue flow and proactively monitor
- Skim T2/T3 buckets multiple times daily
- Check error feeds 1-2 times daily
- Monitor new issues email feed
- On release day: hourly checks immediately after release
Escalation paths:
- New T4 technical questions → Architecture group
- Business questions → T5 with explanation
Documentation:
- Maintain Changing of the Guard agenda
- Record all hotfixes, known issue changes, SQL scripts, open loops
Cross-Tier Rules
Process violations: [SOFTEN LANGUAGE TO MISS? THOUGH I THOUGHT THIS WAS A KEN THING AND WE STOPPED DOING PROCESS MISSES]
- Tag with "Process Tweak"
- Add internal comment explaining the issue
- Kick back to appropriate tier
- For missing transition comments: answer anyway but still tag
Unrelated questions on same ticket:
- Use Split Ticket button
- Reset to Team:Helpdesk with no agent
- Add internal note explaining the split
Escalation Guidelines
Escalating Up from T2
- Check Known Issue tracker first
- Add transition comment if user hasn't heard from us in 1 day
- Request more info from user while escalating if needed
- Write clear ESCALATED QUESTION 1, 2, etc. headers
- Include debugging details and where you got stuck
- Re-escalating for incomplete answers = Process Tweak [TAG THIS? OR IS RE-ESCALATION ENOUGH?]
Escalating Down
- Check Known Issue tracker, add/mark resolved
- If answer was in docs → internal comment + "Missed Doc Review" tag
- If no doc exists:
- Assign yourself
- Answer user directly
- Create "Proposed User Doc" or "Proposed Internal Doc" issue if helpful [THIS MEANS SUGGESTED NEW DOCUMENTATION?]
- Provide detailed "why" not just "what" to lower tiers
Ticket Management
Ticket Statuses
- Open - Awaiting OR staff action
- Pending - Answered, waiting for client (3-day reminder, then auto-resolve)
- Resolved - Complete, no response expected
- Closed - Completed (client replies create new ticket)
- Waiting on Customer - No reminder, returns to Open after 10 days
- Hold for X days - Returns to Open after specified time with auto-note
- Review (then Resolve) - Client thinks it's resolved, staff needs to review
Known Issues
When issue exists:
- Tag ticket with format:
<issue#>-<brief-description> - Add to index ticket
Creating new issues:
- Enter via Google Form
- T3/T4 create GitHub issue if applicable
- Format title per changelog guidelines
Thresholds:
- Create tag: 3+ tickets (general guide)
- Create Sorry page: 6+ tickets (based on severity)
Routing to Other Teams
Send to Engagement if ANY of these apply:
- Client doesn't understand after 2 explanations
- Delivering unusually bad news (call preferred)
- Complex question requiring detailed client info
- Sales opportunity (ProService, new account, etc.)
- Potential new client who hasn't signed up (send macro + notify Engagement)
- Client mentions closing account
- Invoice pushback not resolved in one email
- Level 3 security issue
How: Set Ticket Owner to Teams: Engagement (removes agent assignment; add yourself as Follower to get updates; remove escalations)
Send to Product
- General Product feedback → Internal comment starting with "Product" + check "Notify Product" box (don't CC Product team)Don't send to product:
- Feature requests → Internal Requests forum
- Bugs (not ticket-related) → Dev Phone a Friend forum
- Bugs from tickets → Escalate through T2+
Send to Marketing (Paul Hall)
Notify for:
- Potential new partner inquiries
- Systemic partner problems
- Partner non-responsiveness
- Merch/T-shirt requests
How: Internal comment + @Paul Hall or assign to Marketing/Paul Hall if ticket is otherwise complete
Support Article Issues
Follow reporting guidelines
Forum Feature Requests
- If already possible → Educate user, close ticket
- If legitimate → Internal comment starting "Product" + check "Notify Product" box
- If unnecessary/low votes → Close ticket
- Don't escalate to T3/4
Opportunities for Improvement (OFI)
For "not quite right" issues not clear enough for Forum:
- Resolve actual client issue first
- Document OFI clearly
- Internal comment starting "Product" + check "Notify Product" box
Partner Questions
- Channel partners → See channel doc
- Other partners → Use Partner Contacts (YELLOW only)
- CC dev@ownerrez.com and tier2@ownerrez.com on all partner communications
- Enter partner ticket number in Known Issues if multi-user issue
SLA Response Times
| Tier | Green | Yellow | Red |
|---|---|---|---|
| Triage/T1 | <2 business hours | <1 business day | >1 business day |
| T2 | <1 business day | <2 business days | >2 business days |
| T3 | <1 business day | <2 business days | >2 business days |
| T4 | <2 business days | <3 business days | >3 business days |
| T5 | <2 business days | <3 business days | >3 business days |
On-Call Response: Within 1 hour (note seen + handling)
- No response in 1 hour → Use wake-up email (Rex, Adria)
- No response after 30 min → Call using Emergency Contacts
Additional Processes
Changing of the Guard
When: Monday after release planning
Who: Current/previous week T3 and On-Call, T2+ support
Cover: Last week recap, this week changes, open issues, Known Issue tracker updates
Cross-Week Tickets
- T3 unfinished tickets: Leave open with research notes for next T3
- T3 tickets you responded to: Handle follow-ups yourself
- T4: Covered by On-Call doc and Changing of the Guard
Sorry Status Page
Who can post: Sysops Team, Chris, PW, Shawn, Rex
When to post:
- Investigating: Anything triggering On-Call (not blasted)
- Known Issue: If affecting thousands or many hundreds of clients (blasted)
Process:
- Work hours: Helpdesk and T4 consult in Support ↔ Dev T4 chat
- After hours: Authorized person's judgment for On-Call level issues