Integrations

Document360 integration

Connect Document360, choose a project version, and read and publish articles through Pageloop.

Document360 integration

Connect Document360 so Pageloop can read your published help-center articles and prepare updates for review. You choose one project version to sync and decide when to publish changes back to Document360.

For an overview of help-center connections and integration roles, see Connect your knowledge base.

Before you begin

  • Sign in to Pageloop as an Admin.
  • Have your Help Center URL, the public address of your Document360 site containing <your subdomain>.
  • Have a Document360 API Token (<your API key>) allowed to read project versions. The connection dialog's Find your API Token link opens Document360's API token guide.
  • Know which project version contains the articles you want to sync. API documentation versions are not offered.

Connect and configure Document360

  1. Open Integrations, search for Document360, and select Connect.
  1. In Connect Document360, enter Help Center URL and API Token, then select Connect. The Integration Connected toast with Successfully connected to Document360 confirms the connection.

The card reads Connected before you choose a project version. Nothing syncs until you save a version, so complete the configuration right away.

  1. Select the gear (Configure) on the Document360 card. In Configure Document360, under Select a project version to sync, choose one version. The main version is marked Main. Select Save Configuration and check for Configuration saved. You can reopen Configure to change the version at any time.
  1. Confirm that the card reads Connected and has a gear button. Check the Knowledge base role under Integration roles before relying on the connection to sync articles.

Assign the Knowledge base role

Document360 can hold the Knowledge base role only. The role identifies where Pageloop reads your articles and publishes updates.

Connecting Document360 assigns it to Knowledge base only when no service holds that role. If another service, such as Pageloop Docs, already holds the role, Document360 connects but is not synced until you change the assignment:

  1. Scroll to Integration roles at the bottom of Integrations.
  2. Select Change on Knowledge base.
  3. In Change Knowledge Base, which says Pick a connected service to read from and write to., select Document360.
  4. Select Save and confirm that Knowledge base names Document360.

What Pageloop reads and writes

Read articles from Document360

With a saved project version and the Knowledge base role assigned to Document360, Pageloop syncs published articles, categories, and sections from that version every hour. Pageloop does not offer API documentation versions for sync.

Publish reviewed changes to Document360

Pageloop's proposals arrive in the Inbox. Nothing reaches Document360 until a person publishes an article.

When you publish an article, choose where it goes, select a category, and choose an author. The author defaults to you. Select Publish to publish the article, or Save as draft in Document360 to create a draft in Document360 rather than publish it.

See Review an Inbox item and Finish an Inbox item for the review and publishing workflow.

Disconnect Document360

  1. On the Document360 card, point at Connected. The button changes to Disconnect.
  2. Select Disconnect to open Disconnect Document360?. The dialog explains: Pageloop stops reading from and writing to it. If Document360 holds the Knowledge base role, the dialog also says: Document360 is your knowledge base integration. That role is left unassigned until you pick another.
  3. Select Disconnect to confirm, or Keep connected to cancel. The Document360 disconnected toast confirms disconnection.

Disconnecting leaves the API token valid in Document360. Delete the token in Document360 if you no longer want Pageloop to have access. The saved project version choice is lost; choose a version again after reconnecting.

Restore a connection that needs reconnecting

If Pageloop loses access, for example because the key was deleted or syncing failed several times in a row, the card shows Needs reconnecting. The page says: Document360 needs to be reconnected. Pageloop lost access, so it is paused until you reconnect it.

Open the ... menu on the card and select Disconnect. Then select Connect and repeat the connection and configuration steps, including saving a project version and checking the Knowledge base role.

Troubleshooting

Message or symptomWhat to do
Connection Failed with Invalid Document360 API token or insufficient permissionsCheck the API token and confirm that it is allowed to read project versions, then try connecting again.
The Knowledge base page keeps showing Reading your Document360 help center with no articles.No project version is saved. Open the card's gear, choose a version, and select Save Configuration.
Error loading project versionsThe version list did not load. Try again, or disconnect and connect again.
Please select a project versionChoose a version before saving.
Document360 is Connected, but articles are not syncing after you saved a version.Check Integration roles. If another service holds Knowledge base, change the role to Document360.
Needs reconnectingOpen the card's ... menu, select Disconnect, then connect and configure Document360 again.
Pageloop can’t sign in to your Document360 help center, so it isn’t syncing.Disconnect, then connect and configure Document360 again.
Pageloop stopped syncing your Document360 help center after it failed several times in a row.Disconnect, then connect and configure Document360 again.
The last sync of your Document360 help center didn’t finish. Pageloop keeps trying on its own.Pageloop retries automatically.
Pageloop paused syncing: most of your Document360 articles were missing from the last read, so it kept them rather than delete them. If you didn’t remove them, contact support.If you did not remove the articles, contact support. Pageloop kept the articles rather than deleting them.