Macha

Drafting Ticket Replies Using Google Docs Context

Abbas, Customer Support & AI, Macha

Written by

Ankeet Guha, Co-founder & CTO, Macha

Reviewed by

Published July 24, 2026

Updated July 24, 2026

Most support teams keep their real answers in Google Docs. Not the polished help-center articles customers can already find — the internal stuff: the API reference engineering maintains, the SLA matrix sales negotiated, the "how we actually handle international returns" doc someone wrote after a bad week. When a detailed ticket lands, a good agent doesn't guess. They go find the doc, read the relevant section, and write a reply grounded in what the company actually said.

Drafting Ticket Replies Using Google Docs Context

That hunt is where the minutes go. The doc is three folders deep, the section you need is halfway down, and you copy-paste-and-rephrase under a clock. Multiply that by a queue and you've lost an afternoon to retrieval — not to thinking.

This is a clean job for a Macha agent. Macha is an AI agent layer that sits on top of the helpdesk you already use (Zendesk, Freshdesk, Gorgias, Front) and connects the tools your answers live in — including Google Workspace. The agent reads the incoming ticket, pulls the right Google Doc (and, if you want, cross-checks Notion or Confluence), and drafts an accurate reply — posted as an internal note your agent edits and approves before anything goes to the customer. You keep the judgment; the agent kills the retrieval.

This post walks the exact workflow end to end: how Macha connects to Google Docs, the two ways it can read them, how to build the drafting agent, and an honest take on when to use the draft-for-review pattern versus letting an agent reply on its own.

The workflow at a glance

The shape of this use case is simple and it maps directly to one of Macha's prebuilt use-case templates:

StepWhat happensTool
TriggerA ticket is created (or tagged for help)Zendesk / Freshdesk
ReadAgent reads the full ticket and conversationGet Ticket
RetrieveAgent finds and reads the relevant Google DocRead Google Doc
Cross-check(Optional) searches Notion/Confluence for related contextSearch Pages
DraftWrites a grounded reply as an internal note for reviewAdd Internal Note

The customer-facing send stays with a human. The agent does everything up to that line — reads, retrieves, reasons, and drafts — so the agent's job shrinks to read the draft, tweak a sentence, hit send.

Two ways Macha reads your Google Docs

Connecting Google Workspace is an OAuth flow — you authorize once from the connectors screen, no API keys to manage. Once it's live, your agents get three Google tools: Read Google Doc, Read Google Sheet, and Sync Docs to Knowledge. For reply drafting, the first and third matter most, and they represent two genuinely different patterns.

The Macha connectors screen, where Google Workspace is authorized via OAuth alongside Zendesk and other tools.
The Macha connectors screen, where Google Workspace is authorized via OAuth alongside Zendesk and other tools.

Pattern 1 — Read a specific doc on demand

The Read Google Doc tool fetches the full content of a document by its ID or URL, live, at the moment the agent needs it. This is the right pattern when you have a small set of canonical documents and you want the latest text every time — the API reference that engineering edits weekly, a pricing doc that changes mid-quarter. The agent reasons over the real, current document rather than a cached copy.

You can hand the agent specific docs (selected through the Google Picker) or let it choose from the ones you've made available. Either way, the content is read at request time, so an edit someone made this morning is already reflected in this afternoon's drafts.

Macha's tool picker, where you add capabilities to an agent — helpdesk actions like Add Public Reply sit alongside the document and knowledge tools you enable.
Macha's tool picker, where you add capabilities to an agent — helpdesk actions like Add Public Reply sit alongside the document and knowledge tools you enable.

Pattern 2 — Sync Docs as a live knowledge source

The second pattern is knowledge sync. Instead of pointing the agent at a single doc, you sync a set of Google Docs into Macha as a live knowledge source — they're indexed and kept in sync, so the agent can search across all of them semantically and pull the most relevant passage without you naming the file.

This is the better fit when the answer could live in any of dozens of docs and you don't know in advance which one. The agent searches, finds the relevant section across your synced docs, and grounds the draft on it. Because it's live sync, updates to the source docs flow through — you're not re-uploading PDFs every time policy changes.

Rule of thumb: a handful of canonical, frequently-edited docs → Read Google Doc on demand. A large, sprawling, "it's in there somewhere" library → sync to knowledge and let search do the work. Plenty of teams use both: one or two pinned docs read live, plus a synced knowledge base for everything else.

Why bother with a dedicated agent at all, when Google Docs has Gemini built in? Because native Google Docs AI can only read the single document you have open — it can't span your other docs, your Notion wiki, or your helpdesk's own articles, and it can't see the ticket. The whole value here is connecting the ticket to the right doc to a draft, in your helpdesk, with your company's actual knowledge — which is exactly what a layer on top of the helpdesk does and a single-doc assistant can't.

Building the drafting agent

You don't script this workflow step by step — you describe the job and give the agent the tools and knowledge to do it. A practical configuration:

  1. Connect Google Workspace and your helpdesk (Zendesk shown here). Optionally connect Notion or Confluence if your context is spread across them.
  2. Knowledge — sync the Google Docs the agent should draw on, or pin specific docs for the Read Google Doc tool.
  3. Tools — give the agent Get Ticket, Read Google Doc (and/or knowledge search), and Add Internal Note. Crucially, don't grant a public-reply tool if you want every answer reviewed — capability gating is your safety rail.
  4. Instructions — tell it to read the full thread, find the supporting doc, draft a reply in your brand voice, and cite which doc it used so the reviewing agent can verify in one click.
  5. Model — pick a model per the speed/quality trade-off you want. Macha bills credits per AI action, ranging roughly 0.5–9 credits by model, with the default GPT-5.4 Mini at 1 credit. A drafting agent doing reasoning over long docs is a fine place to spend up on a stronger model; a high-volume triage agent is where you save.
Choosing the model for an agent in Macha — credit cost scales with the model, so you match horsepower to the job.
Choosing the model for an agent in Macha — credit cost scales with the model, so you match horsepower to the job.

That instruction to cite the source doc is the highest-leverage line in the whole config. A draft that ends with "(based on: API Reference v4, 'Rate Limits' section)" turns review from "do I trust this?" into "does that section say what the draft claims?" — a five-second check instead of a fresh investigation.

Using Macha's Edit with AI to refine a support agent's instructions — here adding a rule to escalate large refunds before the agent replies.
Using Macha's Edit with AI to refine a support agent's instructions — here adding a rule to escalate large refunds before the agent replies.

A worked example: API rate limits

Here's the template's own scenario, which is a good one because it's exactly the kind of ticket that can't be answered from a help-center FAQ — it needs the real internal reference.

The ticket: "A customer is asking about our API rate limits and pricing tiers for Enterprise. Can you help me draft a reply?"

What the agent does:

  1. Reads the ticket — pulls the full conversation and the customer's actual question.
  2. Reads the Google Doc — fetches "API Documentation" from Google Docs and locates the Enterprise rate-limit section.
  3. Cross-checks Notion — searches the wiki and finds the "Pricing Tiers" page to confirm the Enterprise tier details.
  4. Drafts an internal note:
"Hi Mark, thanks for reaching out about our API. Here are the details for the Enterprise tier: • Rate limit: 10,000 requests/minute • Monthly quota: 5M requests • Priority support and a dedicated endpoint available • Pricing: custom — happy to set up a call to scope your specific needs. Would Thursday at 2pm work for a quick chat?" — Drafted from: API Documentation (Google Docs) + Pricing Tiers (Notion). Post as the reply?

The reviewing agent sees a complete, sourced draft. They confirm the numbers match the doc (they came from the doc, so they will), maybe soften a line, and send. The retrieval — the part that actually ate the time — is already done, and it's done against the live document, not a half-remembered version of it.

Draft-for-review vs. auto-reply: pick deliberately

This use case deliberately stops at a draft in an internal note. That's a design choice, not a limitation, and it's the right default for context-heavy replies. Macha can absolutely auto-reply to customers — that's the bread and butter of its Zendesk deflection agents — but the two modes suit different tickets:

  • Auto-reply shines on high-volume, well-bounded questions where the answer is unambiguous and lives in a clean help-center article ("how do I reset my password?"). The risk of a wrong send is low and the volume payoff is high.
  • Draft-for-review shines exactly where this workflow lives: detailed, account-specific, or commercially-sensitive answers pulled from internal docs, where a wrong number (an SLA, a rate limit, a price) is expensive and a human glance is cheap insurance.

The mechanism that enforces the choice is simply which tools you grant. Give the agent Add Internal Note and not a public-reply tool, and it physically cannot send to the customer. That's a stronger guarantee than a setting you hope nobody flips.

Watch-outs — when this isn't the right tool

Honest caveats, because the pattern has edges:

  • Garbage doc in, garbage draft out. The agent is only as accurate as the Google Docs you point it at. If your internal docs are stale or contradictory, the draft inherits that. This workflow rewards teams who keep at least a few docs genuinely current — and punishes teams hoping AI will paper over a messy wiki.
  • Permissions matter. The OAuth connection reads whatever the authorizing account can access. Scope it to the right docs; don't connect an account that can see HR or finance folders you'd never want quoted into a ticket.
  • Review fatigue is real. "Draft for review" only saves time if review stays fast. Keep the source-citation instruction on, keep drafts short, and audit a sample weekly — if agents are rewriting from scratch every time, your instructions or knowledge need tuning, not your patience.
  • Not for simple deflection. If a question is answered by a public help-center article, route it to a deflection agent that auto-replies. Reserve the Google-Docs drafting agent for the tickets that genuinely need internal context — that's where it earns its credits.
  • Long docs cost more. Reasoning over a 40-page reference consumes more than a one-paragraph lookup. Sync to a knowledge source (which retrieves just the relevant passage) rather than reading whole giant docs end to end when you can.

Where it fits in your stack

This is one node in a broader knowledge-grounded support pattern. The same agent can lean on Notion and Confluence for context that isn't in Google Docs, and you can pair it with a retrieval agent that searches internal docs to help an agent mid-conversation. Google Sheets is in scope too — the Read Google Sheet tool means an agent can pull a value from a live pricing or inventory sheet and fold it into the same draft. The throughline: your answers already exist, scattered across the tools your team writes in. Macha's job is to connect them to the ticket — not to make you migrate everything into one more system.

See the full Google Workspace integration for the complete tool list, or the docs for setup.

FAQ

Does Macha replace Google Docs or my helpdesk? No. Macha is a layer on top of both. Your docs stay in Google, your tickets stay in Zendesk/Freshdesk/Gorgias/Front. Macha reads from one and drafts into the other.

Will the agent send replies to customers automatically? Only if you let it. This workflow drafts into an internal note for agent review. If you don't grant a public-reply tool, the agent cannot send to the customer — it can only draft.

Read a specific doc or sync to knowledge — which should I use? Use Read Google Doc for a small set of canonical, frequently-edited docs you want read live each time. Use knowledge sync when the answer could be in any of many docs and you want the agent to search. Many teams use both.

Does it always use the latest version of the doc? Yes. Read Google Doc fetches content live at request time, and knowledge sync keeps synced Docs up to date — so edits flow through to future drafts without re-uploading anything.

What does it cost to run? Macha bills credits per AI action (roughly 0.5–9 by model; default GPT-5.4 Mini = 1 credit). A drafting agent reasoning over long docs sits at the higher end, which is why citing-and-stopping-at-a-draft is efficient. See the pricing page for plan details.

Can it cross-check Notion or Confluence too? Yes. Connect them and add their search tools, and the same agent will pull supporting context from Notion or Confluence alongside Google Docs in a single draft.

Try it

If your best answers live in Google Docs and your agents spend their day fetching them, this is a one-afternoon setup that pays back immediately. Start a 7-day free trial, no credit card required, connect Google Workspace and your helpdesk, point an agent at your docs, and let it draft the next hard ticket for review.


Written by Abbas (Customer Support & AI, Macha) · Reviewed by Ankeet Guha (Co-founder & CTO) · Published 2026-06-24 · Last updated 2026-06-24.

Macha

About Macha

Macha is an AI agent platform that works on top of the help desk you already use — Zendesk, Freshdesk, Gorgias, or Front — and connects to the rest of your stack, even your own internal systems. Its AI agents resolve tickets and automate entire workflows end to end, all set up in plain English, no code. Learn more about Macha →

Zendesk
5.0 on Zendesk Marketplace

Loved by support teams worldwide

See what support teams are saying about Macha AI.

The application seems excellent to me! We are still testing, and we need support for some details and they were extremely efficient too!

Daniela Costa

Daniela Costa

Head of Support, Seabra

Macha has been a great addition to our support toolkit. It generates clear, well-organized responses that fit naturally into our workflow. One feature we particularly appreciate is its ability to automatically reply in the same language as the ticket.

Marius F

Marius F

Support Head, Zentana

We've been using Macha for a little while now and it's been really great addition so far! It's powerful, convenient, and makes getting work done a lot easier for our agents.

Alexander Wedén

Alexander Wedén

Head of Support

Support team is very helpful and responsive. Really enjoy how lightweight this is within Zendesk itself vs other more intrusive tools.

Cathleen Wright

Cathleen Wright

Zendesk Admin, Cortex IO

So far it's pretty good! Our queries are a little nuanced, so we can't always use it, but it's got enough utility for us. It can even incorporate our bilingual country with greetings in a second language.

Jae Oliver

Jae Oliver

Head of Support, Wise

Really enjoying using Macha, it has made a noticeable difference to our support team in a short amount of time. I really like the ticket summary feature, saves us a lot of time.

Harry Jackson

Harry Jackson

Head of Support, Crumb

Macha AI is a great addition to my workspace! It's powerful, convenient, and it really makes productivity so much easier for our agents!

Dave G

Dave G

Head of Support, Cyber Power Systems

Very impressed! AI integration for Zendesk has certainly come a long way and Macha seems to set the standard for now. This will for sure save lot of time in our support team.

Pauli Juel

Pauli Juel

Head of CS, Dokument24

Macha has been working great for us so far! The auto-responses are accurate and our resolution time has dropped significantly.

Lana T

Lana T

Zendesk Admin, Swotzy

Macha AI is a great addition. The knowledge base feature means our agents always have the right answers at their fingertips.

Mischa Wolf

Mischa Wolf

Head of Support, Topi

We're enjoying this integration so far. It's made our support team more efficient and our customers get faster responses.

Paula G

Paula G

Head of Customer Support, Xly Studio

The team enjoys using it. It saves considerable time on common questions and the integration options are excellent.

Kilian Leister

Kilian Leister

Support Head, Didriksons

Ready to supercharge your team with AI?

Get started in minutes. Connect your tools, configure your agents, and let AI handle the rest.

500 free credits · no time limit, no credit card