CUSTOMER SUPPORT

Draft and review-route ReadMe articles from solved Zendesk tickets

When a Zendesk ticket is solved, identifies whether the question lacks a ReadMe doc, drafts one from the resolution.

CategoryCustomer Support
Enginesim
Difficultyadvanced
Triggerevent
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerZendesk ticket solvedZendeskZendesk
  • ActionExtract question + resolution with OpenAIOpenAI
  • ActionSearch ReadMe for existing articleReadMeReadMe
  • LogicBranch: no adequate article found?
  • ActionDraft ReadMe article and save as draftReadMeReadMe
  • OutputCreate Linear review task for docs ownerLinearLinear

What it does

Converts solved Zendesk tickets into reviewed ReadMe documentation. The workflow detects when a solved ticket covers a topic missing from ReadMe, drafts the article from the agent's resolution, and routes it through a human review gate in Linear so nothing reaches the public docs unchecked.

When to use it

Use it when your public developer or product docs live in ReadMe and support runs in Zendesk, and you want a controlled pipeline that produces drafts automatically but keeps a human approval step.

How it works

  1. 1A Zendesk ticket is set to solved, triggering the flow.
  2. 2OpenAI extracts the question and the verified resolution from the ticket thread.
  3. 3The workflow searches ReadMe for an existing article on the topic.
  4. 4A branch continues only when no adequate article exists.
  5. 5OpenAI drafts a ReadMe-formatted article from the resolution.
  6. 6The draft is saved to ReadMe and a Linear review task is created for the docs owner.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect ZendeskTickets, queues, knowledge base.
  2. 2
    Connect OpenAIModels, embeddings, files.
  3. 3
    Connect ReadMeAPI docs, changelog, auth.
  4. 4
    Connect LinearIssues, projects, cycles, triage.
  5. 5
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  6. 6
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  7. 7
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.