CUSTOMER SUPPORT

Append an FAQ answer to README when an agent tags an Intercom conversation

When a support agent closes an Intercom conversation with a 'doc-this' tag, it summarizes the question and resolution and appends a Q&A block to a chosen README FAQ page.

CategoryCustomer Support
Enginesim
Difficultybeginner
Triggerevent
Steps6
Setup~5 min

How it runs

The automated pipeline, trigger to output.

  • TriggerIntercom conversation tagged 'doc-this'IntercomIntercom
  • LogicConfirm conversation is closed and tag matches
  • ActionFetch full conversation threadIntercomIntercom
  • ActionDistill into PII-stripped Q&A blockOpenAI
  • ActionAppend Q&A to target README FAQ pageReadMeReadMe
  • OutputPost confirmation note back to IntercomIntercomIntercom

What it does

It lets agents promote a single great answer into the docs with one tag. The moment a conversation is tagged for documentation, the workflow extracts the customer's question and the agent's resolution, formats it as a clean Q&A, and appends it to your README FAQ page.

When to use it

Use it when individual agents already know which answers deserve to live in the docs and you want zero-friction capture at close time, rather than a batch review later.

How it works

  1. 1An Intercom event fires when a conversation is tagged 'doc-this'.
  2. 2A logic check confirms the conversation is closed and the tag matches.
  3. 3The full thread is pulled from Intercom.
  4. 4OpenAI distills it into a concise question and a step-by-step answer, stripping any customer PII.
  5. 5The new Q&A block is appended to the target README FAQ page.
  6. 6A confirmation note is posted back to the Intercom conversation so the agent knows it landed.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect IntercomConversations, contacts, articles.
  2. 2
    Connect OpenAIModels, embeddings, files.
  3. 3
    Connect ReadMeAPI docs, changelog, auth.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    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.