Skip to main content

Documentation Index

Fetch the complete documentation index at: https://user-docs.seaticket.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Discourse connection lets you integrate an external Discourse forum with SeaTicket. Once connected, SeaTicket automatically syncs topics, posts, and related metadata. It also uses AI to generate concise summaries for each topic. This makes it easier to manage your community, build a knowledge base, and analyze user feedback.

​
Before You Start

Make sure you have the following before creating a connection:
  • Admin access to your Discourse forum
  • Your Discourse forum URL
  • The username associated with the API key
  • An API key generated from the Discourse admin panel

​
API Key Requirements

SeaTicket supports two types of API keys: Option 1: Global API Key (Recommended)
  • A standard API key with read access is sufficient.
Option 2: Granular Scopes API Key
If using granular scopes, make sure the following permissions are enabled:
  • topics: read_lists— Used to fetch the latest topic list
  • topics: read— Used to retrieve topic details
Optional (for future features):
  • topics: write — Create posts under a topic
  • uploads: create — Upload images or files in posts
  • solved: answer— Mark a reply as a solution
Note: If these optional permissions are not enabled, related features will not be available.

​
Creating a Discourse Forums Connection

  1. Go to Connections → + New Connection
  2. Select Discourse Forums as the connection type.
  3. Click Next
  4. Enter the required information:
FieldDescription
Connection nameA descriptive name to identify this connection in SeaTicket
URLYour Discourse forum URL
API keyThe API key generated in the Discourse admin panel
See Discourse’s guide on creating and configuring API keys.)
API usernameThe username associated with the API key
Only sync topics updated within the
following number of years		Limits how far back SeaTicket will sync topics
  1. Click Submit to complete the setup
Image

​
After Connection is Created

Once connected, SeaTicket automatically syncs topics from your Discourse forum. Topics appear in a list view under the connection in the left sidebar, and updates sync every hour. For each topic, SeaTicket records:
  • Title
  • View count
  • Created time and Last modified time
  • AI Summary and AI Processed time — automatically generated for each topic
Image

​
Viewing Topic Details

Click any topic title to open the full discussion thread inside SeaTicket, including all replies and images from the original forum post. Image You can also click the external link icon next to the topic title to open it directly on your Discourse forum.
Image