Ferndesk couldn't use the key, most often because it's missing thread:read or timeline:read. Create a machine-user key with both and try again.
Connect Plain
Connect Plain so Fern reads your completed Plain threads and finds the questions your docs don't answer.
Owners and admins can connect integrations.
What Fern reads
Threads marked Done, with their full message timeline. Threads that are Todo, Snoozed or Ignored are skipped.
Fern reads the last 90 days of completed threads first, then keeps reading new ones. They show up as questions in Reporting > Topics, where Fern can draft the article your docs are missing. More on what Fern does with them in Use your support tools as a source.
Connect it
Plain connects with a machine-user API key, not a personal one. Create it in your Plain workspace settings with two permissions: thread:read and timeline:read. No write permission is needed. Then connect it from Integrations > Help desks. Ferndesk checks that the key has both permissions before it saves the connection.
Good to know
You can connect more than one Plain workspace. Add each one as its own connection.
To hand widget chats to Plain, see Use the widget with another chat tool.
Disconnecting stops the import and deletes the conversations Fern imported from that connection, with the topics built from them.
Common questions
Connecting fails with "Plain Connection not valid"
The connection says Sync failed
Plain refused the API key. Check it in Plain, then replace it under Configuration on the connection's page.