Docs

Integrations / Other tools / Tettra

Search

Searches Tettra knowledge base for information

Searches your Tettra knowledge base and returns relevant articles and pages to answer user questions.

Setup

Get API Credentials

  1. Sign into Tettra
  2. Go to User Settings > My Integrations
  3. Scroll to My API Keys section
  4. Note your Team ID (displayed on the page)
  5. Click Generate API Key
  6. Copy the API key

Configure in Risotto

In the Risotto dashboard, select Tools in the sidebar. Select Tettra in the Tool groups list. Find Tettra Search and click Set up. Fill in these fields, then click Save:

FieldDescriptionExample
Tettra API KeyYour Tettra API keyabc123def456...
Team IdYour Tettra team ID (number)12345

Usage

Search Tettra:

"Search Tettra for our vacation policy"

Ask question:

"What's our remote work policy?" (automatically searches Tettra)

How It Works

  1. Sends search query to Tettra API
  2. Returns relevant pages that match the query
  3. Results respect user's Tettra permissions (private categories included if user has access)
  4. AI uses search results to form a response

Response

Returns formatted results from Tettra pages including:

  • Page titles
  • Page content/excerpts
  • Links to full pages
  • Citations to sources

Permissions

  • API key inherits your user account's page viewing permissions
  • Private categories are searchable if you have access
  • Results limited to what your Tettra account can view

Troubleshooting

No API key option:

  • Verify you're on Scaling or Professional plan
  • Contact Tettra support to enable API access

No results found:

  • Check search query spelling
  • Verify content exists in Tettra
  • Ensure you have permission to view relevant pages

API errors:

  • Verify API key and Team ID are correct
  • Check API key hasn't been revoked
  • Generate new API key if needed

Security Notes

  • API keys are user-specific and tied to permissions
  • Store API keys securely
  • Revoke unused keys in User Settings
  • API key has same access as your user account

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