← Back to Grahm AI
📘 Complete User Guide

How to Use Grahm AI

Everything you need to know — from signing up to converting your first ticket into a published SOP. This guide covers every feature across the entire platform.

Table of Contents

  1. Getting Started
  2. The SOP Knowledge Base
  3. Grahm Tickets — Service Desk
  4. Ticket → SOP Pipeline
  5. AI-Powered Features
  6. Community Fix Patterns
  7. Integrations & Connectors
  8. Analytics & Reporting
  9. Team Collaboration & RBAC
  10. Plans & Pricing

Getting Started

Getting up and running on Grahm AI takes about two minutes. Here's how to go from zero to your first SOP.

1

Create Your Account

Visit grahmai.com and click Start Free — No Credit Card. Sign up with your email and password. You'll land on the main dashboard immediately — no email verification required to start exploring.

2

Meet the Product Walkthrough

On your first visit to Grahm Tickets, a 5-step guided tour walks you through the key concepts: demo tickets are pre-loaded, AI triage is demonstrated, multiple views (Dashboard, Table, Kanban, My Queue) are introduced, and the Ticket-to-SOP conversion loop is explained. You can skip anytime or click through at your own pace.

3

Explore the Demo Data

New accounts come with a demo data seeder — pre-populated tickets across different categories and statuses so you can immediately see how dashboards, boards, and AI features work without entering anything yourself.

4

Navigate the Platform

The sidebar is your home base. It gives you access to the SOP Knowledge Base (guides, templates, library) and Grahm Tickets (service desk, dashboard, boards). Settings, billing, and integrations are accessible from the sidebar as well.

💡 Pro Tip: The Free plan gives you unlimited manual guides, 10 AI generations per month, screen recording, and basic templates — enough to evaluate the platform thoroughly before upgrading.

The SOP Knowledge Base

At its core, Grahm AI is a knowledge management system. Every resolved issue, every documented process, every team insight gets captured as a standard operating procedure (SOP) that your organization can reference forever.

Creating SOPs

There are four ways to create a new SOP in Grahm AI:

✍️

Manual Editor

Write SOPs from scratch using the built-in rich editor. Add steps, notes, categories, and tags. Great for documenting processes you already know by heart.

All Plans
🤖

AI Generation

Describe the problem and Grahm AI generates a complete SOP with structured steps, risk scoring, and suggested edits. Uses OpenAI via the secure ai-proxy edge function.

10/mo Free Unlimited Pro+
🔴

Screen Recording

Record any process on your screen and Grahm AI transforms it into a step-by-step guide with screenshots automatically. Perfect for capturing workflows that are hard to describe in writing.

All Plans
🎫

Ticket → SOP Conversion

The flagship feature. Resolve a support ticket and convert it directly into a polished SOP with one click. The AI extracts the problem, solution, and context automatically.

Pro+

Templates

Pre-built SOP templates give you a head start for common IT scenarios — password resets, onboarding checklists, incident response, and more. Free users get access to basic templates; Pro and above can create and save custom templates.

Organizing Your Library

SOPs live in a searchable, sortable Team Library. You can organize them into folders, mark favorites for quick access, and use full-text search to find any guide instantly. Team-specific or organization-wide sharing is controlled per SOP.

Sharing & Publishing

Every SOP can be shared via three visibility modes:

Exporting

SOPs can be exported as DOCX or PDF files for offline use, client delivery, or compliance archives. Export is available on Pro plans and above.


Grahm Tickets — Full Service Desk

Grahm Tickets is a built-in help desk and ticketing system designed for IT operations. It's where support requests come in and where knowledge gets created as a natural byproduct of resolving issues.

Views

Switch between views depending on how you prefer to work:

📊

Dashboard

High-level metrics at a glance — open tickets, resolution times, SLA status, tickets by category, priority distribution. Your operational command center.

📋

Table View

Spreadsheet-style listing of all tickets with sortable columns, inline filters, and bulk actions. Power users love this for triaging large queues.

📌

Kanban Board

Drag-and-drop cards across status columns (Open → In Progress → Resolved → Closed). Visual and intuitive for managing ticket flow.

👤

My Queue

Filtered view showing only tickets assigned to you. Focus on your workload without distraction.

Ticket Detail Drawer

Click any ticket to open a full detail drawer. Here you can see the complete ticket info, add comments, view the activity log (every status change, assignment, and action is recorded), run AI triage, find similar tickets, set SLA deadlines, and convert the ticket into an SOP.

Public Intake Forms

Create customizable public forms that anyone can use to submit a ticket — no login required. Share the form URL with your end users, embed it on an internal portal, or link it from your website. Submissions automatically create tickets in your Grahm Tickets queue.

Form fields, branding, categories, and required fields are all configurable per workspace.

SLA Engine Business+

Set service level agreements per priority level. Define response time and resolution time targets. The SLA engine tracks deadlines in real time and triggers notifications (including webhook alerts) when an SLA is about to breach or has breached.

ℹ️ How SLAs work: Configure your SLA rules in the Settings modal (the gear icon next to the SLA indicator). Set targets like "Critical = 1 hour response, 4 hour resolution." The countdown begins when the ticket is created and pauses when the status changes to a non-active state.

Automation Recipes Business+

Create if-this-then-that style automations. Examples: auto-assign tickets with "network" in the title to the network team, auto-escalate tickets that have been open for 48 hours, auto-close tickets that have been resolved for 7 days.

Customer Portal Pro+

Give your end users a portal where they can check the status of their submitted tickets, add comments, and see resolution updates — without needing access to the full Grahm Tickets interface.

Email Notifications Pro+

Automatic email notifications for ticket creation, assignment changes, status updates, comments, and SLA breaches. Powered by nodemailer and Gmail SMTP — configured once in your environment and it just works.


The Ticket → SOP Pipeline

This is Grahm AI's core value proposition: every resolved support ticket is a knowledge asset waiting to be captured. Here's how the pipeline works end to end.

1

Ticket Arrives

A ticket comes in through a public intake form, email, CSV import, Zendesk sync, universal webhook, or manual creation. It lands in your Grahm Tickets queue.

2

AI Normalizes & Triages

AI triage analyzes the ticket — extracting category, priority, suggested assignee, and a summary. The ticket content is normalized into a consistent format regardless of how it arrived.

3

Semantic Embedding

Each ticket is embedded as a vector using OpenAI's text-embedding-3-small model and stored in pgvector. This enables semantic search, duplicate detection, and clustering.

4

Resolve & Convert

When you resolve a ticket, the Convert to SOP button appears. One click sends the ticket content (problem, resolution steps, context) to the AI, which generates a complete, structured SOP.

5

AI Quality Review

Before publishing, the generated SOP goes through an AI quality review that checks for completeness, clarity, accuracy, and risk. Each SOP gets a risk score and suggested edits.

6

Publish & Share

Approve the SOP and publish it to your library. Optionally share it with the community (anonymized) so other IT teams can benefit from your solution.

💡 Smart Merge Detection: If the AI detects that a newly generated SOP overlaps significantly with an existing one (using pgvector similarity at a 0.65 threshold), it suggests merging them instead of creating a duplicate. The AI combines the best parts of both into a single comprehensive SOP and archives the originals.

AI-Powered Features

AI runs through the entire Grahm AI platform. Here's every feature powered by artificial intelligence.

🧠

AI Triage

Automatically categorizes, prioritizes, and suggests an assignee for incoming tickets based on content analysis.

🔍

Duplicate Detection

Uses pgvector embeddings to find semantically similar tickets — even when the wording is completely different. Surfaces duplicates before your team wastes time on the same issue twice.

📐

Semantic Clustering

Groups related tickets into clusters using vector similarity. Reveals patterns like "we're getting a lot of VPN issues this week" before anyone notices manually.

SOP Generation

Converts resolved tickets or manual prompts into complete, structured SOPs with steps, warnings, prerequisites, and troubleshooting sections.

🛡️

Quality Review

Reviews generated SOPs for completeness, clarity, and risk. Outputs a risk score and actionable edit suggestions before you publish.

🔀

Smart Merge

Detects overlapping SOPs and offers to intelligently merge them — combining the best steps from each into one comprehensive guide.

ℹ️ How AI calls work: All AI features route through the ai-proxy Supabase Edge Function, which securely calls OpenAI on the backend. Your API keys are never exposed to the browser.

Community Fix Patterns

One of Grahm AI's most unique features: a shared, anonymized library of how IT teams around the world solve common problems.

How It Works

When you publish an SOP, you have the option to toggle Share with Community. If enabled, a sanitized version of your SOP is contributed to the global community library. The sanitization engine automatically strips all personally identifiable information — emails, IP addresses, hostnames, domain names, ticket IDs, names, UNC paths, serial numbers, and Active Directory references — before anything goes public.

Browsing Patterns

The 🌐 Community Fixes section lets you browse patterns contributed by other teams. Filter by category, sort by popularity (most helpful votes), environments (most commonly seen), or contributions. When you're working on a ticket, the Find Similar button shows how other teams solved the same issue.

Voting

Every community pattern has 👍 and 👎 buttons. Votes feed into a success rate calculation that surfaces the most reliable solutions first. Each user gets one vote per pattern — no duplicate voting.

Deduplication

If you contribute a fix that matches an existing community pattern (above 80% vector similarity), it enhances the existing pattern instead of creating a duplicate — increasing its environment count and contribution tally.

💡 Think of it as: "See how other IT teams solved this issue" — a crowdsourced knowledge base that grows more valuable with every team that uses Grahm AI.

Integrations & Connectors

Grahm AI connects to the tools you already use so tickets flow in and notifications flow out automatically.

Inbound: Getting Tickets Into Grahm AI

🟢

Zendesk Native Sync

Go to Settings → Add Zendesk → enter your subdomain, email, and API token → Test → Sync. Resolved tickets from Zendesk are pulled and normalized automatically.

🔗

Universal Webhook

Generate an API key in Settings, then give any external system your webhook endpoint URL. Works with Freshdesk, Jira, ServiceNow, or any system that can send HTTP POST requests. Also compatible with Zapier, Make, and n8n.

📄

CSV Import

Upload a CSV file of tickets for bulk import. Map your columns to Grahm AI fields and import everything in one go.

📝

Public Intake Forms

Share a customizable web form URL with end users. No login required — submissions auto-create tickets.

Outbound: Webhook Notifications

Configure webhook notifications in the Settings modal to push events to Slack, Microsoft Teams, Discord, or any custom endpoint.

Supported Events

EventTriggers When
New Ticket CreatedA ticket is created from any source
Status ChangedAny ticket status transition
Ticket AssignedAssignee is changed or set
SLA BreachAn SLA deadline is exceeded
Comment AddedA new comment is posted on a ticket
Ticket ResolvedStatus is set to Resolved

Setting Up Webhooks

In Grahm Tickets, click the Webhooks button in the topbar. Add a webhook by providing a name, selecting the platform (Slack, Teams, Discord, or Custom), pasting the webhook URL, and toggling which events to listen for. Use the Test button to send a sample message and verify your setup.

ℹ️ CORS handled: All outbound webhook calls route through a Vercel proxy function (/api/webhook-proxy) so there are no browser CORS issues. Only HTTPS URLs are allowed.

Analytics & Reporting

Grahm AI gives you visibility into your operations at every level.

Ticket Dashboard

The Grahm Tickets dashboard shows real-time metrics: open ticket count, average resolution time, SLA compliance rate, tickets by priority, tickets by category, and trend charts over time.

Knowledge Gap Analytics Pro+

Identifies categories where tickets keep coming in but no SOPs exist yet. These are your knowledge gaps — the areas where creating documentation would have the biggest impact on reducing repeat tickets.

Recurring Issue Analytics Pro+

Uses semantic clustering to detect recurring patterns. Surfaces insights like "VPN connectivity issues spiked 300% this week" or "password reset tickets account for 40% of all volume."

Weekly AI Insights Enterprise Gold

AI-generated weekly summary of your operational health — top issues, resolution efficiency, knowledge coverage, and actionable recommendations.

Executive Reports Enterprise Gold

Polished, presentation-ready reports covering SLA performance, team productivity, knowledge base growth, and operational trends. Designed to be shared with leadership.


Team Collaboration & Access Control

Team Members

Invite team members to your workspace. Pro plans support up to 5 team members; Business plans offer unlimited seats. Team members can be assigned tickets, collaborate on SOPs, and share knowledge.

Role-Based Access Control Business+

RBAC lets you define who can do what. Assign roles like Admin, Agent, and Viewer with granular permissions over ticket management, SOP publishing, settings access, and team management.

Custom Branding Business+

White-label your workspace with custom branding — logo, colors, and portal appearance. Great for MSPs and agencies that manage IT for multiple clients.

Audit Logs Business+

Every action is logged: ticket changes, SOP edits, user logins, settings modifications. Exportable for compliance and review purposes.


Plans & Pricing

Grahm AI offers four tiers. Start free, upgrade when you need more power.

Feature Free $0 Pro $29/mo Business $79/mo Enterprise Gold
Manual SOP guides UnlimitedUnlimitedUnlimitedUnlimited
AI generations 10/monthUnlimitedUnlimitedUnlimited
Screen recording
Templates BasicCustomCustomCustom
Public sharing
DOCX/PDF export
Grahm Tickets BasicFullFull + AI Ops
Ticket → SOP conversion
AI triage & duplicate detection
SLA engine
Automation recipes
Team members 15UnlimitedUnlimited
RBAC
Webhook integrations
Zendesk sync
Custom branding
Executive reports
Weekly AI insights
Customer portal
Community fix patterns View onlyContributeContributeContribute
Support CommunityEmailPriorityDedicated
Pricing Free $29/mo $79/mo Custom
🏅 Enterprise Gold is designed for organizations that want the full AI-powered service desk experience — including AI triage, duplicate detection, executive reports, weekly insights, advanced automations, and dedicated support. Contact us for custom pricing.

Keyboard Shortcuts & Tips

  • Kanban drag-and-drop — Drag tickets between columns to change status instantly
  • Table sorting — Click any column header to sort ascending/descending
  • Quick search — Use the search bar in the Team Library to find SOPs by title, content, or tags
  • Test webhooks — Always use the Test button after adding a new webhook to verify formatting
  • Demo data — Reset demo data anytime from Settings to get a fresh set of sample tickets
  • Similarity threshold — The platform uses a 0.65 cosine similarity threshold for clustering — tuned for IT ticket language
  • Public form URL — Share your intake form URL directly; submitters don't need a Grahm AI account