# 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](https://developer.getguru.com/docs/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.

   > **Warning:** Treat your Guru token like a password. Store it securely and never share it publicly.

### Step 2: Configure Integration in Risotto

1. **Open Guru's page**

   Go to [**Settings** → **Integrations** → **Guru**](https://dashboard.tryrisotto.com/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](https://www.tryrisotto.com/docs/dashboard/settings/credential-vault) 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](https://www.tryrisotto.com/docs/dashboard/knowledge/indexes).

   *Product example: The Index a collection dialog on the Guru integration page: a name, the collection slug, the user email, a user token from the vault, Department and Audience, and Index collection.*

   > **Info:** Risotto indexes every card in the collection, verified or not. It also reads the text of PDF files attached to a card. It ignores other attachments, such as images, videos, and zip files, and PDFs over 100 MB. A card with an empty body is not indexed.

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**](https://www.tryrisotto.com/docs/dashboard/knowledge/indexes#create-an-index) 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](https://www.tryrisotto.com/docs/dashboard/settings/integrations#knowledge).

## Export Articles to Guru

An Org Admin or Manager can copy a Risotto [Article](https://www.tryrisotto.com/docs/dashboard/knowledge/articles)
into a Guru collection as a new card. The export uses a Guru User Token stored in
the [Credential Vault](https://www.tryrisotto.com/docs/dashboard/settings/credential-vault) as an org-wide
credential. See [Exporting an Article to Guru](https://www.tryrisotto.com/docs/dashboard/knowledge/articles#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](https://www.tryrisotto.com/docs/dashboard/settings/credential-vault#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**](https://dashboard.tryrisotto.com/knowledge/playground) to test that questions are answered using your indexed Guru cards.

Source: https://www.tryrisotto.com/docs/integrations/knowledge/guru
