Skip to content

Sites

Sites are product workspaces. Each site keeps its customer engagement, product growth, automation, public surfaces, themes, knowledge, and integrations isolated from other sites.

Creating a Site

  1. Click the + button in the site sidebar
  2. Enter a name and color
  3. Click Create

The new site appears in the sidebar.

Site Sections

  • Chat — Manage visitor and customer conversations
  • Feedback — Review, moderate, assign, reply to, and bulk update requests
  • Roadmap — Organize feedback into public roadmap lists
  • Changelog — Draft, publish, and notify subscribers about release notes
  • Surveys — Create targeted basic, NPS, and CSAT surveys
  • Tours — Configure multi-step in-app guidance
  • Highlights — Configure targeted in-app callouts
  • Web messages — Publish targeted announcements and chat prompts
  • Tracking — Review product events and interaction analytics
  • Social — Monitor demand signals across supported public sources
  • Content Strategy — Review growth opportunities and generated content
  • AI Automation — Configure chat and lifecycle agents
  • Customers — Review signed users, activity, feedback, and conversations
  • Settings — Configure general site details, knowledge sources, theme, widget wording, portal, AI, and email templates

Each section has a dedicated page in this guide. Start with Widget and Portal when adding Managani to a product.

Public Portal Shortcuts

Use short public links for Roadmap and Changelog. These links redirect to the canonical section URL, so the browser address changes to /roadmap or /changelog. Query parameters are preserved.

On the Managani domain:

SectionShortcutDestination
Roadmaphttps://app.managani.com/s/SITE_SLUG/rhttps://app.managani.com/s/SITE_SLUG/roadmap
Changeloghttps://app.managani.com/s/SITE_SLUG/chttps://app.managani.com/s/SITE_SLUG/changelog

With an active White-Label custom domain:

SectionShortcutDestination
Roadmaphttps://portal.example.com/rhttps://portal.example.com/roadmap
Changeloghttps://portal.example.com/chttps://portal.example.com/changelog

If a site has an active custom domain, its Managani-domain shortcut redirects directly to the custom-domain destination.

Knowledge Sources

Site settings include a Knowledge sources tab. Public sources are URLs, Roadmap, and Changelog. Each source can be included in project search and enabled for the public widget.

Streamient project URLs, notes, and unscoped memories can ground Chat AI replies. Emails and customer-tagged records are restricted to the matching customer and remain background context. Widget search and the Widget Assistant use public sources only and never use Streamient.

Streamient writeback can save new Managani feedback as issue memory, then update that record when statuses or admin replies change.

Install an Experience

In Settings > Website > Experiences, edit the Experience you want to install, open Embed, and copy its script into your website. Each snippet includes the Experience ID, including the Default Experience. Use the generated hostname, which includes your active white-label domain when configured.

Anonymous chat and Web messages need only this embed. No JWT, backend integration, or specific technology stack is required. Configure the Experience's trigger to show a Managani button or open it from your own page button. Existing generic embeds remain supported and select Default.

Signed Widget Users

Signed identity is optional for chat. Feedback submission, voting, comments, and customer-specific history require a signed user token. Generate the JWT on your server with the site secret, then add data-user-token to the chosen Experience's script while keeping its data-widget-id:

html
<script async src="https://your-instance.com/managani.js" data-site-key="PROJECT_KEY" data-widget-id="EXPERIENCE_ID" data-user-token="JWT_FROM_YOUR_SERVER"></script>

Do not put the site secret in browser code. Public roadmap, changelog, and knowledge content can load without a signed user token.

Widget Interaction Tracking

The widget can track signed-user interactions when installed with managani.js. It records clicks, form submits, search terms, input focus, and input changes as /api/widget/track events.

Disable automatic browser interaction tracking:

html
<script async src="https://your-instance.com/managani.js" data-site-key="PROJECT_KEY" data-widget-id="EXPERIENCE_ID" data-auto-track-interactions="false"></script>

Use window.ManaganiWidgetConfig for richer control:

html
<script>
window.ManaganiWidgetConfig = {
	siteKey: 'PROJECT_KEY',
	autoTrackInteractions: true,
	captureValueSelectors: ['[data-track-value]'],
	ignoreSelectors: ['[data-no-track]']
};
</script>

Sensitive fields such as password, file, token, API key, card, CVC, and SSN fields are never value-captured.