Imports
Imports bring an old help center or docs site, and closed Intercom conversations, into a product, so the team can see which of its questions the product's help pages already cover. Each imported item is judged as covered, probably gone, or not covered yet. Conversations need Intercom connected first, and the team's plan must be active.
On this page
Start an import
In Settings › Imports, paste the address of your old help center or docs site into Docs site or old help center.
Select Import. It stays off until the field has an address.
The field starts with your product's help center address when one is saved.
Cactus reads the site from the address you give. It uses the site's llms.txt and sitemap.xml where they list pages, and otherwise follows the links under the address. It reads up to 1000 pages. A page that an earlier import already read is skipped.
Import conversations
Once Intercom is connected, its row in Imports shows Import conversations. Select it to import Intercom conversations.
The import reads closed Intercom conversations created in the last 365 days. A conversation already imported is not imported again.
Connecting Intercom
The Intercom row shows one of three states.
What you see | What it means |
|---|---|
Connect Intercom | What it means Intercom is not connected. Select it to connect. |
“Connected as {workspace}” | What it means Intercom is connected. The workspace is the name Intercom gave it when you connected, or else its id. |
“Intercom isn’t available yet.” | What it means You cannot connect Intercom. |
If Intercom refuses the saved token, the row reads “Intercom refused the token. Connect Intercom again.” and shows as not connected.
To disconnect, select Disconnect in the Intercom row. That deletes the Intercom import and the conversations Cactus read through it.
Import progress and results
Each import shows one row under Imports.
What you see | What it means |
|---|---|
Importing, with “Reading pages · 3 of 40” | What it means The import is running. The first number is how many new pages it has kept so far, and the second is how many it has read. |
“Reading conversations · 3 of 40” | What it means The same for a conversation import, counting conversations. |
“Imported 12 of 40 pages” | What it means The docs import finished: 12 new pages kept from 40 read. |
“12 new from 40 conversations” | What it means The conversation import finished. |
Failed, with a reason | What it means The import stopped. The reason is shown on the row. |
Select Show on a finished import to see its items.
What the import checks
Each imported item is given one question and a verdict, judged against your product's current help pages. The verdicts are:
- Covered: a help page answers the question, and the page it names is shown under the item.
- Probably gone: the help pages show the product no longer works the way the item says.
- Not covered yet: no help page answers it, and nothing shows it is out of date.
When Cactus is unsure between covered and not covered, it answers not covered. A covered item stays covered only while its help page is still among the product's help pages.
A docs import lists its pages in these three groups. A conversation import shows each conversation's verdict in place of a group. Under it, What the team answered shows the team's reply when there is one.
Remove an import
Select Remove on an import's row. That deletes the import and what it read. Removing a conversation import also deletes its conversations, so a later import reads them as new.
Select Remove beside a page marked Probably gone to remove that one page. Only that page goes. The next docs import reads it again.
If an import doesn't start or finish
What you see | What it means | What to do |
|---|---|---|
“Cactus couldn’t start that import. Try again.” | What it means The import was refused and nothing started. | What to do Select Import again. |
“Cactus couldn’t confirm the import started. Press again: it won’t start a second one.” | What it means Cactus cannot tell whether the import started. | What to do Select the same button again. It starts no second import. |
“Cactus is paused because the team has no plan. Pick one in Settings → Plan to turn it back on.” | What it means Imports do not run while the team has no plan. | What to do Pick a plan in Plans and billing. |
“That site publishes neither llms.txt nor sitemap.xml, and its pages link to nothing under {address}.” | What it means Cactus found no pages at the address, and the import Failed. | What to do Check the address, then import again. |
“Intercom refused the token. Connect Intercom again.” | What it means The Intercom connection was dropped, so no conversations were imported. | What to do Connect Intercom again in the Intercom row. |
To review what the import's answers rest on, open What Cactus takes as true.
The panel says the import is "once". Each import reads only pages it has not read before, so you can import again.