CUSTOMER SUPPORT

Detect an Intercom issue spike and flag the missing README troubleshooting section

Monitors Intercom conversation volume per issue topic, and when a topic spikes above baseline.

CategoryCustomer Support
Enginesim
Difficultyadvanced
Triggerschedule
Steps5
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerScheduled sampling of Intercom topic volume
  • LogicCompare current volume to rolling baseline
  • ActionSearch README for existing topic sectionReadMeReadMe
  • ActionDraft starter section if coverage missingOpenAI
  • OutputAlert docs owner in Slack with spike stats and draftSlack

What it does

It catches documentation gaps the moment they start hurting. The workflow tracks Intercom conversation volume by topic, detects when a topic spikes above its normal baseline, then searches README to see whether a troubleshooting section already exists. If it does not, it drafts a starter section and alerts the docs owner that coverage is missing.

When to use it

Use it when a sudden surge in tickets usually means a release broke something or a doc is stale, and you want an early warning rather than a weekly retrospective.

How it works

  1. 1A schedule samples Intercom conversation volume by topic at a regular interval.
  2. 2A logic step compares current volume against each topic's rolling baseline.
  3. 3Spiking topics pass; steady ones are dropped.
  4. 4README is searched for an existing troubleshooting section on the topic.
  5. 5If none exists, OpenAI drafts a starter section seeded from the spike's conversations.
  6. 6A Slack alert goes to the docs owner with the spike stats and the draft link.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect IntercomConversations, contacts, articles.
  2. 2
    Connect ReadMeAPI docs, changelog, auth.
  3. 3
    Connect OpenAIModels, embeddings, files.
  4. 4
    Connect SlackChannels, DMs, threads, mentions.
  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.