# How to Create Your First Project in Kommon Poll

> Create a first Kommon Poll project by connecting sources, building a quick search query, applying it, and beginning analysis.

This guide walks you through the current onboarding flow for creating your first Kommon Poll listening project.

Use **Start a new project** in the top bar to open onboarding.

Your first project usually follows four steps:

1. Connect sources.
2. Build your query with the AI Boolean Builder or the manual builder.
3. Review and save the project details.
4. Automate alerts by adding recipients and notification channels.

## Step 1 - Connect Sources

Before saving a project, connect the sources Kommon Poll should monitor.

Use:

**Sidebar -> Settings -> Monitoring -> Social Tracking**

and, when account authorization is needed:

**Sidebar -> Settings -> Monitoring -> Social Linking**

In Social Tracking you can add:

- Social media pages, profiles, groups, hashtags, and location feeds
- App review pages
- Hotel or business review listings
- Platform-specific IDs or URLs, where required

Manual Tracking and integration requests are inside Social Tracking. Open **Manual Tracking** or **Requests** from that screen when you need to add a manual mention or request a source setup.

## Finding Tracking Details

For any platform:

1. Open the page, profile, group, hashtag, or review listing you want to track.
2. Copy the URL, username, user ID, hashtag, or listing URL required by that platform.
3. Paste it into Kommon Poll.
4. Choose the tracking start mode, if shown.
5. Click **Track** or **Add**.

When the start mode is available:

- **Backfill 30 Days** attempts to collect recent history up to 30 days where supported. It may consume social tracking credits or cooldown quota.
- **From Now Only** starts collection from the time the source is added and excludes historical mentions.

Backfill is not unlimited historical collection. Availability still depends on platform rules, API access, and your plan.

## Example Tracking Details By Platform

### Facebook

Track:

- Page URLs
- Group URLs
- Hashtags

Examples:

- `https://www.facebook.com/Nike/`
- `https://www.facebook.com/groups/iphoneuserslk/`
- `TravelSriLanka`

### Instagram

Track:

- Profile user IDs
- Hashtags
- Location URLs

Examples:

- User ID: `17841405793187218`
- Hashtag: `#adidasoriginals`
- Location: `https://www.instagram.com/explore/locations/213456789/cafe-colombo/`

Kommon Poll tracks Instagram user IDs where the UI requests IDs, not display usernames.

### TikTok

Track:

- User profile URLs
- Hashtags

Examples:

- `https://www.tiktok.com/@samsung`
- `fashiontips`

### Telegram

Track public channels.

Example:

- `https://t.me/ColomboUpdates`

### Review Platforms

Track public review listing URLs.

Examples:

- Google Reviews: `https://www.google.com/maps/place/ABC+Hotel/reviews/`
- Tripadvisor: `https://www.tripadvisor.com/Hotel_Review-g293962-d2031234-Reviews-Ocean_View_Hotel-Colombo.html`
- Booking.com: `https://www.booking.com/hotel/lk/cinnamon-red.html#tab-reviews`
- Agoda: `https://www.agoda.com/the-kingsbury-colombo/reviews.html`
- Trustpilot: `https://www.trustpilot.com/review/www.apple.com`
- Google Play: `https://play.google.com/store/apps/details?id=com.whatsapp`
- App Store: `https://apps.apple.com/us/app/ebay-buy-sell/id282614216`

## Step 2 - Build Your Query

Your query tells Kommon Poll which brand terms, keywords, competitors, topics, and exclusions to match.

You can build it in onboarding with:

- **AI Boolean Builder**
- **Manual query builder**

### AI Boolean Builder

1. Enter the brand or topic.
2. Choose the query length, such as short, medium, or long.
3. Generate the Boolean query.
4. Review the output before continuing.

AI-generated queries may include brand variations, related words, product names, misspellings, or exclusions. Always check that the query matches your listening goal.

### Manual Query Builder

1. Choose manual query generation.
2. Add your own keywords, phrases, and exclusions.
3. Use Boolean operators such as `AND`, `OR`, and `NOT`.
4. Apply the final query.

For reliable first-project queries:

- Put exact multi-word names in quotes.
- Use `OR` for spelling variations, abbreviations, handles, and hashtags.
- Use `AND` only when every concept must be present.
- Add `NOT` exclusions for known irrelevant meanings.
- Prefer platform, country, language, sentiment, and demographic filters when those filters are available.

If your project needs field targeting, fuzzy matching, wildcards, proximity matching, or boosting, review [Advanced Query Building](/advanced-query-building).

## Step 3 - Review And Save

After the query returns useful results, review the save screen and add:

- **Project title**
- **Project type**
- **Description**
- **Topics**
- **Team**
- **Owner**

Use a clear title and description so teammates can understand the project later. Topics help structure dashboards, filters, and reports around the themes that matter to the project.

## Step 4 - Automate Alerts

After saving, configure notification recipients and channels.

Use:

**Sidebar -> Settings -> Notifications -> Notifications Center**

Notification setup can include:

- Email recipients
- Linked WhatsApp numbers
- Microsoft Teams channel email
- Slack notifications
- Daily, weekly, or sentiment-triggered alerts, depending on the channel

After alerts are saved, Kommon Poll can notify the right people when key activity, spikes, or sentiment movements occur.

## Begin Analysis

Once the project is saved, use the result tabs to analyse:

- Overview metrics
- Sentiment analysis
- Mention analysis
- Topic analysis
- Demographics
- Image analysis
- Mentions
- Competitors
- Kommon Poll AI

You now have a saved project that can monitor the sources, query, topics, and notification setup you selected.