Skip to main content

Social Listening

Social listening lets you connect your brand's social accounts (Instagram, TikTok, etc.) and pull mentions, posts, and comments into a tenant-scoped feed. Use it to feed your multi-platform raffle with social-engagement entries, surface user-generated content on landing pages, or just keep a passive log of what people are saying about your brand.

When to use it​

  • You run a campaign where users earn entries by commenting on a specific Instagram or TikTok post.
  • You want a UGC gallery on your landing page sourced from members' posts.
  • You want a long-term feed of brand mentions for marketing analysis.

How it works​

There are two model concepts:

  • Source — a connected social-platform account. One source per (platform, account handle). Holds the OAuth tokens (encrypted at rest) and the keyword/post filter that controls what's ingested.
  • Mention — a post or comment pulled by a source. Stored with author handle, content, publish date, and an optional sentiment classification.

The platform polls each source on a schedule, fetches new mentions, deduplicates against existing rows by (SourceId, ExternalId), and writes the mention into the feed.

Step-by-step​

Add a source​

  1. Go to Integrations → Social listening and click Add source.
  2. Pick a platform (Instagram, TikTok, etc.).
  3. Enter the account handle (e.g. @your_brand).
  4. Enter a keywords filter — hashtags or terms that scope the ingestion (e.g. #mybrand2026,#mybrandgiveaway).
  5. Complete the OAuth flow to connect the account. The platform stores the access token (and refresh token if available) encrypted; the row is saved even if the OAuth flow is pending so you can come back to finish it later.
  6. Save.

Watch mentions arrive​

The mention feed under the source lists each row with author, content, published-at, and sentiment. Sort by recency or filter by hashtag.

Wire mentions into a campaign​

For raffles, point your raffle draw's source filter at this listening source so the eligible pool includes social mentions. See Multi-platform raffle.

For UGC display, point a UGC gallery or Social wall block in the landing builder at the source.

Limits and gotchas​

  • OAuth setup varies by platform. Instagram requires a Business or Creator account; TikTok requires a developer app. Follow the platform-specific connect wizard.
  • Sentiment is best-effort. The default classifier marks every new mention as Unknown until a downstream sentiment model tags it. Treat the value as a hint, not a fact.
  • Tenant-scoped. Sources and mentions belong to the tenant that owns them; one tenant cannot read another's feed.
  • Polling frequency is platform-dependent. Instagram caps how often you can pull; expect a 5–15 minute lag between a real-world comment and it appearing in the feed.
  • Tokens expire. When the access token expires, the source goes idle until you reconnect. The admin shows a warning on idle sources.
  • Permission: Pages.SocialListening.