heycactus.ai

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

  1. In Settings › Imports, paste the address of your old help center or docs site into Docs site or old help center.

  2. 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.

Sources

Related pages