Docs

Integrations / Knowledge

Guru

Index and search Guru knowledge cards in Risotto

Connect your Guru collections to Risotto to make your Guru cards searchable through the AI assistant, kept current automatically via webhooks.

Prerequisites

Before setting up the Guru integration, ensure you have:

  1. A Guru User Token with read access to the collection you want to index. Risotto does not accept a Collection Token. See User tokens vs. collection tokens.
  2. The collection slug of the collection you want to index. It is the part after /collections/ in the collection's URL, for example SLUG in https://app.getguru.com/collections/SLUG/PAGE_TITLE.

Setup Process

Step 1: Get Your Guru Token

  1. Generate the token

    In Guru, generate a User Token from your account settings. The token sees what that user can see.

Step 2: Configure Integration in Risotto

  1. Open Guru's page

    Go to Settings → Integrations → Guru and open the Knowledge tab. Click Add collection. If you have no index yet, click Index a collection on the Collections row. The Index a collection dialog opens.

  2. Configure the Index

    Enter the following required information:

    • Name: A name for this index (e.g. People Policies)
    • Collection slug: The Guru collection to index, from the collection's URL
    • User email: The email of the Guru user who owns the token
    • User token: A vault credential that holds your Guru User Token. Choose it, or click Add a vault credential to create one.
    • Department and Audience: Choose who gets answers from this index. See Indexes.
  3. Create and Monitor Index

    Click Index collection. The collection's card on the Knowledge tab shows the progress, and so does the Indexing Jobs panel on Knowledge > Indexes.

Create index on Knowledge > Indexes still adds a Guru index with the same details. It is the only place to set Profile filters.

How Content Stays Up to Date

When you connect Guru on the Card updates card under Settings > Integrations > Guru with a User Token, Guru sends Risotto a webhook when a card is created, updated, deleted, or restored. Indexed content then stays current without a manual reindex. See Integrations.

Export Articles to Guru

An Org Admin or Manager can copy a Risotto Article into a Guru collection as a new card. The export uses a Guru User Token stored in the Credential Vault as an org-wide credential. See Exporting an Article to Guru.

Troubleshooting

Credential errors (401/403) from Guru

Risotto detects authentication failures against the Guru API and notifies your org admins directly with a link to update credentials, rather than letting the index silently go stale. If you see this notification, your token has likely expired or been revoked. Generate a new one, then put it in the vault credential that the index uses: go to Settings → Credential Vault, open the credential's row menu, and choose Rotate Value. See Rotate a value. The Configure dialog of an index shows only Audience and Department. Then reindex.

Cards not appearing in search results
  • Confirm the Collection slug is correct
  • Verify the token still has read access to the collection
  • Allow time for large collections to finish indexing

Content Verification

After indexing, use Knowledge → Playground to test that questions are answered using your indexed Guru cards.

Something wrong or missing? Report an issue · View as Markdown