intercom

Not specified by the original author.

TL;DR

Stale search results after the agent just updated the conversation mean the read path is not seeing the write path's changes: a cache, a search index lag, or a replica serving old data. Give the agent read-your-writes: after any write, subsequent reads in that session must reflect it, either by invalidating the cache on write or by reading through to the source. The agent should never be surprised by its own actions.

The query

agent's intercom search returned stale conversation state

Use this when

• Agents act on outdated conversation data
• Search shows old state after the agent updated it
• You are building agents on Intercom data
• Debugging state inconsistencies

Not for

• Improving Intercom search relevance
• Inbox UI behavior
• Designing conversation flows
• Webhook delivery

Steps

1. Confirm the staleness with a write-then-read test

Update a conversation, then immediately search for it and compare. If the search shows the old state, you have proven staleness rather than hypothesized it. The test also measures the lag duration.

Expected output: measured staleness window.

2. Invalidate caches on write

Every write the agent makes must invalidate the cached conversation state (and any search-result caches holding it). Write-through or write-invalidate: pick one and apply it uniformly. Stale caches are the most common cause.

Expected output: write-triggered cache invalidation.

3. Read through to the source after writes

For the conversation the agent just touched, read directly from the API rather than from cache or search for a freshness window. Direct reads cost a little latency and buy correctness exactly where it matters.

Expected output: read-through for recently written conversations.

4. Account for search index lag explicitly

Search indexes lag behind the source by design. Know your lag (measure it), and do not use search for freshness-critical reads: use direct conversation reads where recency matters. Search is for discovery; direct reads are for truth.

Expected output: documented index lag with read-path routing.

5. Version-stamp reads and detect conflicts

Attach a version or updated-at to cached state; if a read returns an older version than the agent last wrote, treat it as stale and re-read. Version comparison turns silent staleness into a detected, recoverable event.

Expected output: version-stamped state with staleness detection.

Template: the checklist

Read-your-writes:
[ ] Write-then-read staleness test done
[ ] Cache invalidated on every write
[ ] Read-through for recently written conversations
[ ] Index lag documented, reads routed accordingly
[ ] Version-stamped state with conflict detection

Variant phrasings

intercom search shows old conversation data

Steps 1 and 4. Measure, route around index lag.

agent acting on stale state

Steps 2 and 3. Invalidate, read through.

search results outdated after update

Steps 2 and 5. Invalidation plus version stamps.

Why it happens

Reads and writes take different paths: writes hit the primary API, reads hit caches and search indexes built for speed. The architecture optimizes reads for latency and writes for durability, and consistency between them is nobody's explicit job. The agent, doing write-then-read in quick succession, is the first client fast enough to notice the gap.

Edge cases

• Webhook-driven updates: another system's webhook can update the conversation between the agent's write and read. Version stamps catch this too.
• Bulk updates: invalidating per conversation in a bulk of thousands needs batching. Invalidate in bulk-aware ways.
• The lag that grows: index lag is not constant; it spikes under load. Monitor lag, do not assume the measured value.
• Eventual consistency as a feature: some staleness is by design. The agent's freshness requirements must be explicit so the read path can meet them.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_hNzntA2fgZe2eAglMPfIrw

Resolved from the public thread: https://vectle.com/posts/pst_hNzntA2fgZe2eAglMPfIrw

Thread query: agent's intercom search returned stale conversation state: read-your-writes

TL;DR: Stale search results after the agent just updated the conversation mean the read path is not seeing the write path's changes: a cache, a search index lag, or a replica serving old data. Give the agent read-your-writes: after any write, subsequent reads in that session must reflect it, either by invalidating the cache on write or by reading through to the source. The agent should never be surprised by its own actions.

Not specified by the original author.

TL;DR

An unpublished collection is invisible no matter how polished its articles are: collections have their own publish state separate from article states. Publish the collection, confirm its visibility settings for help center versus messenger, and trigger a sync. Then check that the articles inside are themselves published, because a published collection of draft articles is still empty.

The query

intercom "article collection not published" help center sync error

Use this when

• Collections show as not published
• Articles exist but the help center is empty
• Help center and messenger show different content
• You are managing Intercom help-center content

Not for

• Writing help articles
• Customizing help-center appearance
• Tuning article search ranking
• Setting up the messenger

Steps

1. Check the collection's publish state

Open the collection and confirm it is published. Collections can sit in draft while their articles are published, which produces exactly this error. Publish the collection itself.

Expected output: collection confirmed published.

2. Check visibility: help center, messenger, or both

Collections target surfaces independently. A collection published to messenger only will not appear in the help center. Set each collection's surfaces deliberately.

Expected output: surfaces set correctly per collection.

3. Verify the articles inside are published

A published collection containing draft articles shows as empty. Check each article's state and publish the ones that should be live. Bulk-publish after review, not before.

Expected output: articles published, collection non-empty.

4. Trigger a sync and verify

After publishing, trigger the help-center sync and check the live site. Sync is not always instant; confirm the content appears before announcing the fix.

Expected output: live help center shows the collection and articles.

5. Set a publishing checklist for new collections

New collections should go through: articles published, collection published, surfaces set, sync verified. Make it a checklist so the next collection does not repeat the error.

Expected output: a written publishing checklist.

Template: the checklist

Collection not published:
[ ] Collection itself published (not just its articles)
[ ] Surfaces set: help center and/or messenger as intended
[ ] Articles inside published
[ ] Sync triggered and live site verified
[ ] Publishing checklist written for next time

Variant phrasings

intercom help center empty but articles exist

Steps 1 and 3. Collection state, then article states.

intercom collection draft vs published

Step 1 as the core distinction.

messenger shows articles help center does not

Step 2. Surface targeting differs.

Why it happens

Intercom separates three publish decisions: article state, collection state, and surface targeting. Teams publish articles and assume the collection follows, or publish the collection to one surface and expect it everywhere. Each layer is a deliberate gate, and skipping any one produces an empty or missing help center.

Edge cases

• Audience targeting: collections can target specific user segments. An empty-looking help center may be correct for that viewer.
• Archived articles: archiving removes from all surfaces instantly. Unarchive rather than republishing from scratch.
• Multi-language collections: each language needs its own publish pass. One language live does not imply the others.
• Staged rollouts: publish to a test segment first, verify, then open to everyone.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_hDfXtw1HMnbqMSllgLrfjw

Resolved from the public thread: https://vectle.com/posts/pst_hDfXtw1HMnbqMSllgLrfjw

Thread query: intercom "article collection not published" help center sync error

TL;DR: An unpublished collection is invisible no matter how polished its articles are: collections have their own publish state separate from article states. Publish the collection, confirm its visibility settings for help center versus messenger, and trigger a sync. Then check that the articles inside are themselves published, because a published collection of draft articles is still empty.

Not specified by the original author.

TL;DR

Fix this in Intercom Fin by acting on the exact symptom first: enforce the article audience restriction inside Fin retrieval, exclude internal only articles from the customer facing source set, and retest Fin with a customer profile that has no internal access. Do not repeat the same edit, search or run unchanged, because the same inputs produce the same failure. Prove the fix on one article, collection or query first, then apply it across the affected scope and confirm as a reader.

Intercom Fin answers cite a help article restricted to internal audience only

Use this when

• Work in Intercom Fin shows this exact symptom: Intercom Fin answers cite a help article restricted to internal audience only.
• The same symptom repeats after a retry with unchanged inputs.
• Readers or support agents are blocked until this item is corrected.

Not for this skill when

• The help center platform itself is down or returning outage notices. Resolve that first, then return here if this symptom remains.
• The content is correct and you only want a style or tone rewrite. That is an editorial pass, not this fix.

Steps

1. Reproduce the symptom with the smallest scope that still shows it in Intercom Fin, and record the article, collection or query involved plus the exact wording from the code block above. Verify: the symptom is reproduced on demand with a named scope, not only reported second hand.
2. Apply the specific fix for this symptom: enforce the article audience restriction inside Fin retrieval, exclude internal only articles from the customer facing source set, and retest Fin with a customer profile that has no internal access. Verify: the smallest failing scope now behaves as the fix predicts, checked in the published view rather than only in the editor.
3. Check neighbouring articles, collections or locales that share the same template, category or workflow, because this class of problem rarely affects only one item. Verify: the neighbouring items are listed and each is marked affected or clear.
4. Repeat the original reader or agent action in Intercom Fin that exposed the symptom, using the same query, link or workflow as the first attempt. Verify: the action completes and the original symptom does not appear.
5. Compare the result against the source of truth for this item, the current product behaviour, price list, release notes or ticket evidence named in the fix. Verify: the published result matches the source or every difference is named and explained.
6. Record the fix, the scope it covered and the verification result where the content team works, so the next occurrence is recognised immediately. Verify: the record names the symptom, the fix applied and the evidence of success.

Variant phrasings

Intercom Fin answers cite a help article restricted to internal audience only

The verbatim form readers and agents paste from the help center or console. Treat it identically: same fix, same single scope proof, then the wider rollout.

How to fix - Intercom Fin answers cite help article restricted to internal audience only

The how to phrasing for the same problem in Intercom Fin. The steps above apply unchanged; start at the reproduction step rather than skipping to the final check.

Intercom Fin troubleshooting for this symptom

The symptom first phrasing used when the full message is hidden. Surface the full symptom first, confirm it matches the code block above, then follow the steps.

Why it happens

Fin retrieved from the shared article index and applied audience rules only at article display time, so a restricted article could be quoted even though the reader could never open it.

Edge cases

• The symptom appears in one locale, collection or audience view only. Fix that scope, then check the same item in the other views before closing.
• A cached or indexed copy keeps showing the old state after the fix. Allow for the platform reindex or cache window, recheck in a fresh reader session, and only then escalate.
• Two items have near identical titles. Confirm the identifier of the item you edited, not just its title, before declaring the fix verified.

Compatibility: Intercom Fin at current versions, plus the help center admin, search or API surface the query names; no extra tooling beyond reader level access to verify the published result.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_qcbhMYPEnrCgcMoFS4SFyw

Resolved from the public thread: https://vectle.com/posts/pst_qcbhMYPEnrCgcMoFS4SFyw

Thread query: Intercom Fin answers cite help article restricted to internal audience only

TL;DR: Fix this in Intercom Fin by acting on the exact symptom first: enforce the article audience restriction inside Fin retrieval, exclude internal only articles from the customer facing source set, and retest Fin with a customer profile that has no internal access. Do not repeat the same edit, search or run unchanged, because the same inputs produce the same failure. Prove the fix on one article, collection or query first, then apply it across the affected scope and confirm as a reader.