Documentation

Getting Started

Creating Your Account

1. Visit the registration page and enter your email
2. Complete payment via Stripe (secure checkout)
3. You'll be redirected to your dashboard automatically
4. Your account is now active with your selected plan

First-Time Setup Checklist

After registration, follow these steps to start collecting feedback:

Dashboard Overview

The main dashboard provides a quick overview of your feedback status and guides you through setup.

What You'll See

• Onboarding Progress - Track your setup completion
• Quick Stats - Total mentions, new items, sentiment overview
• Recent Activity - Latest mentions across all sources
• Action Items - Critical issues requiring attention

Navigation

Brand Management

A Brand represents the product or company you want to track feedback for.

Creating a Brand

1. Go to Brands in the navigation
2. Click Create Brand
3. Enter your Brand Name and Website URL
4. Click Save

Adding Keywords

Keywords are used to find mentions on Reddit, Hacker News, Quora, Bluesky, GitHub, DEV Community, Stack Overflow, YouTube, and Google News.

1. Go to your brand's detail page
2. Click Add Keywords
3. Enter keywords (one per line): your brand name, product names, common misspellings
4. Click Save Keywords

Connecting Review Sources

Connect your existing review platforms to automatically import reviews:

Data Sources & Integrations

Noisely collects feedback from 21 different sources automatically.

Review Platforms

Community Platforms

Support Platforms

CSV Import

Import historical data or data from unsupported sources via CSV.

Mentions

Mentions are individual pieces of feedback collected from all your connected sources.

Viewing Mentions

Go to Mentions to see all collected feedback. Each mention shows:

• Source - Where it came from (Reddit, Trustpilot, etc.)
• Content - The actual feedback text
• Sentiment - Positive, Negative, Neutral, or Question
• Status - New, Reviewed, Action Item, Won't Fix
• Date - When it was originally posted
• Score - Rating or upvotes (if applicable)

Filtering Mentions

Muting Sources

If a source is too noisy, you can mute it to hide its mentions and action items from your default view without disconnecting the integration.

How to mute a source:

1. On the Mentions page, click the Mute button next to the Platform filter
2. Click any source to toggle it. Muted sources show an eye-off icon and a strikethrough name
3. The page reloads with muted sources hidden

What happens when you mute a source:

• Mentions from that source are hidden on the Mentions page
• Action items that are only backed by mentions from muted sources are hidden on the Action Items page
• Action items that have mentions from both muted and non-muted sources remain visible
• A banner shows how many items are hidden, with a Show all link to temporarily reveal them
• Data collection continues in the background - you can unmute at any time to see everything again

Mention Statuses

Bulk Actions

Select multiple mentions to perform bulk operations:

1. Check the boxes next to mentions (or use "Select All")
2. Use the toolbar that appears:
   • Mark as... - Change status for all selected
   • Add Tag - Apply a tag to all selected
   • Export - Download selected as CSV
   • Delete - Remove selected mentions

AI Analysis

Noisely uses AI to automatically analyze your feedback and surface actionable analysis.

Analysis Dashboard

The Analysis dashboard provides a comprehensive view of your feedback data:

Key Metrics

Charts & Visualizations

• Sentiment Trend (8 weeks) - Line chart showing sentiment changes over time
• Mention Volume - Bar chart showing mention count per day (7/30/90 day views)
• Source Breakdown - Pie chart showing where mentions come from
• Category Distribution - Horizontal bar chart of feedback categories

Chart Export

Each chart (Sentiment Trend, Mention Volume, and Source Breakdown) has a download button in the top-right corner. Click it to export the chart as a PNG image file. The downloaded file is named with the chart type and current date, e.g. noisely-sentiment-trend-2026-02-12.png.

Dashboard Sections

• Critical Issues - High-priority problems requiring immediate attention
• Top Complaints - Most common negative feedback themes
• What Customers Love - Positive feedback patterns
• Feature Requests - Most requested new features

AI Analysis Details

Click on any mention to see its AI analysis:

Action Items

Action items are where you track product improvements derived from customer feedback.

Action Item Statuses

Action Items Filtering

Filter action items by:

• Brand - If you have multiple brands
• Priority - Critical, High, Medium, Low
• Category - Bug, Feature Request, etc.
• Status - Open, Triaged, In Progress, Done, Won't Do
• Search - Search titles and descriptions
• Date Range - When items were created
• Muted sources - Action items from muted sources are automatically hidden

Bulk Action Item Operations

Push Channels (Output Integrations)

Push channels let you send action items to your existing tools. Connect up to 10 different channels and enable auto-push to automatically send new items.

Supported Destinations

Auto-Push & Categories

Each push channel supports:

• Auto-Push - Automatically send new action items when they're created
• Category Filters - Only push items matching specific categories (e.g., bugs only to Jira, feature requests to Linear)
• Manual Push - Select individual items and push them on demand

Slack Setup

1. Create a Slack Incoming Webhook (Slack API > Create app > Incoming Webhooks)
2. Add to a channel and copy the webhook URL
3. In Noisely, paste the webhook URL
4. Give it a name and enable the channel

Linear Setup

1. Get your Linear API key (Settings > API)
2. Enter the API key in Noisely
3. Select your team
4. Enable the channel

Jira Setup

1. Enter your Atlassian domain (e.g., yourcompany for yourcompany.atlassian.net)
2. Enter your Atlassian account email
3. Create an API token at Atlassian Account > Security > API Tokens
4. Noisely will verify the connection and show your projects
5. Select the target project for new issues

Microsoft Teams Setup

1. In Microsoft Teams, go to the target channel
2. Click the ... menu > Connectors (or Workflows)
3. Add an Incoming Webhook connector
4. Copy the webhook URL
5. Paste the URL in Noisely and optionally name the channel

Webhook Setup

1. Enter your HTTPS endpoint URL
2. Optionally add a signing secret for HMAC-SHA256 verification (sent in the X-Noisely-Signature header)
3. Optionally add custom headers (JSON format)

Notion Setup

1. Go to notion.so/my-integrations and create a new integration
2. Give it a name like "Noisely" and select your workspace
3. Copy the Internal Integration Secret (starts with ntn_)
4. In Notion, open your target database and add the integration via ... > Connections
5. Paste the token in Noisely and select your database

Asana Setup

1. In Asana, go to your profile > Settings > Apps > Developer apps
2. Click Create new token and name it "Noisely"
3. Copy the Personal Access Token
4. Paste the token in Noisely. It will verify and show your workspaces
5. Select a workspace, then select the target project for new tasks

Discord Setup

1. In Discord, go to the target channel's settings
2. Click Integrations > Webhooks > New Webhook
3. Name it "Noisely" and copy the webhook URL
4. Paste the URL in Noisely and optionally name the channel

Notifications

Noisely keeps you informed about important activity through in-app notifications, email alerts, and push channel messages.

In-App Notification Center

The notification bell in the top navigation bar shows your unread notifications. Click it to see recent activity:

• Red badge - Shows the number of unread notifications
• Mark as read - Click any notification to mark it as read
• Mark all read - Clear all unread notifications at once
• View all - Open the full notifications page for history

Notification Types

Notification Preferences

Configure which notifications you receive in Settings > Profile > Notifications:

Advanced Search

Both Mentions and Action Items support powerful search capabilities.

Basic Search

Just type words to search:

Finds mentions containing "login" OR "error".

Boolean Operators

Phrase Search

Use quotes for exact phrases:

Regex Search

Use /pattern/ for regex:

Saving Searches

Save complex searches for quick access:

1. Set up your filters and search query
2. Click Save button
3. Enter a name (e.g., "Critical bugs last 30 days")
4. Click Save

To load a saved search, click Saved dropdown and select your search.

REST API

Access your Noisely data programmatically via the read-only REST API. All endpoints return JSON and require authentication.

Authentication

Include your API key in the Authorization header:

Create API keys in Settings > API Keys.

Base URL

Endpoints

Mention Filters

The /mentions/ endpoint supports the following query parameters:

Example Request

Pagination

All list endpoints return paginated results with 20 items per page. The response includes:

Rate Limiting

API requests are rate-limited. If you exceed the limit, you'll receive a 429 Too Many Requests response. Wait and retry after the indicated time.

MCP Server (AI Assistant Integration)

Noisely includes a Model Context Protocol (MCP) server that lets AI assistants like Claude Desktop access your feedback data directly.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external data sources. With the Noisely MCP server, you can ask Claude or other AI assistants to search your mentions, analyze sentiment trends, and review action items using natural language.

Setup

1. Ensure the Noisely project is installed and configured on your machine
2. Open your Claude Desktop configuration file
3. Add the Noisely MCP server configuration (see below)
4. Restart Claude Desktop

Claude Desktop Configuration

Available Tools

Example Prompts

Once connected, you can ask your AI assistant things like:

• "Show me the most negative Reddit mentions from the last 7 days"
• "What are the top complaints about our product this month?"
• "Summarize the sentiment trend for the past 30 days"
• "List all critical action items that are still open"

Account & Settings

Profile Settings

Go to Settings > Profile to manage:

• Personal Information - Full name, email address
• Company Details - Company name, job title, phone
• Address - Street, city, state, postal code, country
• Preferences - Timezone selection

Notification Settings

Control how and when you receive notifications. See the Notifications section for full details.

API Keys

Manage API keys for programmatic access to the REST API and MCP Server. Go to Settings > API Keys.

• Create Key - Give it a name, and your key will be shown once (copy it immediately)
• Key Format - Keys start with nsk_ followed by a random token
• Key Limit - Maximum 10 API keys per account
• Revoke - Disable a key immediately (cannot be undone)
• Last Used - See when each key was last used for auditing

Password Management

1. Log out
2. Click "Forgot Password" on login page
3. Enter your email
4. Check email for reset link (valid for 1 hour)
5. Click link and set new password

Billing & Subscriptions

Managing Your Subscription

1. Go to Settings > Billing
2. Click Manage Subscription
3. You'll be redirected to Stripe Customer Portal

In Stripe Portal you can:

• Update payment method
• Change plan
• View invoices
• Cancel subscription

AI Analysis Quota

Your plan includes a monthly AI analysis quota:

• Quota resets on your billing date each month
• View usage in the Analysis dashboard (AI Quota card)
• When quota is reached, new mentions are collected but not analyzed until reset

Subscription Statuses

FAQ & Troubleshooting

Data Collection

AI Analysis

Integrations

Account

Glossary