# FloatMessage

> FloatMessage is the all-in-one engagement layer for any website. One drop-in script tag adds live chat with AI auto-reply, AI-generated landing pages, popups (18 templates), contact forms, surveys, exit-intent offers, push notifications, self-service appointment booking, and built-in ticketing. Smart targeting (URL, geo, device, schedule, exit intent) on every message. Install as a PWA with push notifications.

## What FloatMessage Does

FloatMessage is a complete engagement layer: live chat with optional AI auto-reply trained on your own knowledge base, an AI-driven landing-page builder hosted on a branded subdomain, plus floating messages (popups, banners, modals, notification cards, contact forms, cookie consent bars, story carousels). Everything renders inside Shadow DOM so it never conflicts with your site's styles. One drop-in script tag, works on any platform.

## Features

### AI Landing Pages
- **Prompt -> published in minutes**: Describe your business in 2-4 sentences, FloatMessage generates a polished landing page (hero, features, FAQ, contact form, footer) in under 10 seconds. Edit any section, hit publish.
- **Branded subdomain**: Claim `<your-name>.floatmessage.com` with wildcard SSL automatic; also reachable at `lps.floatmessage.com/<slug>` and `floatmessage.com/p/<slug>`. Same HTML across all three URLs.
- **8 starter templates**: SaaS, Local Business, Coming Soon, Event, Portfolio, Restaurant, Online Course, Lead Magnet.
- **Engagement preinstalled**: Every page ships with the chat widget, popups, contact form, appointment booking, and surveys baked in - no extra setup.
- **Lighthouse 95+ out of the box**: Inline critical CSS, zero client JS for the page itself, hero preload, WebP images, edge-cached worldwide.
- **SEO baked in**: Canonical tag auto-points at the branded subdomain, JSON-LD per template (LocalBusiness / Event / Person / Course / Product), OpenGraph, sitemap inclusion.

### Book Appointments
- **Self-serve slot picker**: Visitors see a month grid of free slots, pick one, fill name + email, walk away with a confirmation email and an .ics calendar invite.
- **Race-resolved booking**: Server validates the slot is still free at submit time; the losing visitor of a race gets a 409 and the calendar refreshes.
- **Provider deep links**: Confirmation email attaches a universal .ics file plus one-click Google Calendar / Outlook / Office 365 buttons.
- **Owner controls**: Per-weekday open/close, slot length (15-120 min), buffer between meetings, lead time, max booking horizon, custom intake fields.
- **Webhooks on every booking**: Forward to your CRM, Slack, Zapier, Make, n8n, or your own endpoint as JSON.

### Floating Messages
- **18 Templates**: Welcome banners, social proof notifications, newsletter CTAs, square cards, image messages, center modals, blur overlays, sticky footers, sticky top banners, image backgrounds, modals with images, image-only, story carousels, cookie banners, chat CTA, contact forms, surveys, and book-appointment cards
- **Contact Form Template**: Collect visitor info (name, email, custom fields), store submissions in DB, forward via webhook to Slack/Zapier/etc.
- **Survey Template**: All-in-one feedback builder supporting NPS, star ratings, single/multi choice, and short/long text. Multi-step support with progress dots. Responses aggregated in dashboard (NPS score, rating average, choice distribution).
- **Cookie Banner Template**: GDPR consent bar with CTA events to load GTM after approval
- **Chat CTA Template**: Opens live chat on click via FloatMessage.openChat()
- **One-Line Embed**: Single `<script>` tag works on any platform (WordPress, Shopify, React, plain HTML)
- **Shadow DOM Encapsulation**: Zero CSS conflicts with the host website
- **Smart Triggers**: Show on page load, after a delay, on scroll percentage, or on exit intent
- **Scheduling**: Restrict by days of week, time windows, and date ranges (uses visitor's local time)
- **Geo Targeting**: Show messages only to visitors from specific countries (via Cloudflare CF-IPCountry header)
- **Device Targeting**: Show messages only to visitors on desktop, tablet, or mobile (UA + viewport detection, no flicker, no extra request)
- **URL Targeting & Blocking**: Show messages only on specific pages, or block specific pages
- **Background Overlay**: Blur, dark, or light overlay behind messages
- **Dismiss Behaviors**: Always show, session-based, permanent, or show again after a duration
- **Analytics**: Track impressions, CTA clicks, dismissals, chat opens via analytics_event table (batched with sendBeacon)
- **Custom HTML & CSS**: Full control over message design with live preview and color themes
- **Archive**: Soft delete messages to archive, restore or permanently delete from archive
- **CTA Events**: FloatMessage.on("cta:click") fires when visitors click fm-cta class elements

### Live Chat
- **Real-Time Messaging**: Chat with website visitors in real time
- **Pre-Chat Form**: Optionally collect name and/or email before the conversation starts. Auto-translates into 19 languages based on the visitor's browser language (en, es, fr, de, it, pt, nl, pl, ru, tr, ar, he, ja, zh, ko, hi, id, vi, th) via `/api/chat/form/translation` - RTL-aware for Arabic and Hebrew.
- **Multi-Model AI**: Choose from Gemini 2.5 Flash / Pro, GPT-4o, GPT-4o mini, Claude Sonnet 4.5, or Claude Haiku 4.5 - bring your own API key
- **AI Knowledge Base**: Per-domain library of URLs, free-text notes, and uploaded files (PDF, DOCX, TXT, MD up to 5 MB). The AI uses all enabled items as context for every reply. URLs auto-refresh daily.
- **Auto-Generated Knowledge**: New domains get 3-5 starter notes auto-generated from your front page so the AI starts smart on day one. Manually re-trigger anytime.
- **Agent Instruction Wizard**: Pick one of 15 agent presets (Customer Support, Lead Gen, Promotion, Bookings, etc.) and FloatMessage customizes the template using your site's content.
- **Webhook Context**: Send visitor data to your server for dynamic, personalized AI instructions
- **Proactive Messaging**: See online visitors, send direct messages, broadcast to all online visitors
- **Visitors Panel**: View all visitors with online status, current page, country, city
- **Message Preview Bubble**: Proactive messages show as a preview bubble near the chat icon
- **Push Notifications**: Desktop and mobile push with PWA badge
- **Notification Rules**: Get alerted when visitors match conditions (page, country, visit count, new visitor)
- **URL & Country Targeting**: Allow/block URLs and countries for chat visibility
- **Admin Takeover**: AI stops when you reply manually
- **JavaScript API**: FloatMessage.on(), off(), showChat(), hideChat(), openChat(), closeChat(), toggleChat(), setCustomData()
- **Custom Positioning**: Exact pixel coordinates or preset positions

### Ticketing
- **Create Tickets**: From chat conversations or form submissions
- **Status Workflow**: New → In Progress → Closed
- **Internal Notes**: Add notes to any ticket
- **Media Attachments**: Upload images, PDFs, TXT, CSV, DOC (up to 5MB via R2)

### Contact Form Submissions
- **Dashboard View**: All submissions with field data, page URL, country, date
- **CSV Export**: Download all submissions as spreadsheet
- **Webhook Forwarding**: POST submission data to Slack, Zapier, or any URL

### Enterprise Features
- **Team Management**: Invite members with roles (owner, admin, editor, viewer)
- **Domain Management**: Manage multiple websites as separate workspaces
- **Domain Selector**: Switch between domains in dashboard - all data filters by selected domain
- **Organization**: Create org, manage members, domain allowlist

### Progressive Web App (PWA)
- **Installable**: Add FloatMessage to your home screen on any device
- **Push Notifications**: Browser/OS push for new chat messages with app icon badge
- **Works Offline**: Service worker with push event handling

## How It Works

1. **Sign up** - Google login or email/password, no credit card required
2. **Design** - Pick a template and customize it visually, or write custom HTML/CSS
3. **Embed** - Copy a single script tag and paste it before your closing `</body>` tag

## Embed Integration

Load all active messages and the live chat widget for a user:

```html
<script src="https://floatmessage.com/embed/floatmessage.js" data-user="YOUR_USER_ID"></script>
```

Enterprise domain-specific:

```html
<script src="https://floatmessage.com/embed/floatmessage.js" data-user="YOUR_USER_ID" data-domain="site-a.com"></script>
```

### Embed API

- `GET /api/embed?id={messageId}` - Returns message configuration
- `GET /api/embed/user?userId={userId}&domain={domain}` - Returns all active messages for a user (filtered by domain for Enterprise)
- `POST /api/embed/events` - Batch analytics events (impressions, clicks, dismissals, chat_open, chat_message)
- `POST /api/forms/submit` - Contact form submission
- `GET /api/chat/config?userId={userId}&domain={domain}` - Returns chat widget configuration
- `GET /api/chat/form/translation?lang={langCode}&country={ISO}` - Returns Pre-Chat Form translated strings (19 languages, country fallback when lang is en-default)
- CORS enabled for all origins

## Audience Pages

Two top-of-funnel pages frame the product for the two main audiences:

- **For Website Owners** (`/for/website-owners`): Visitors who already have a site. Pitches the engagement layer (live chat, popups, surveys, contact forms, exit-intent, push) added with one drop-in script tag.
- **For Small Business** (`/for/small-business`): Visitors without a site. Pitches the AI-generated landing page hosted on a branded subdomain in 60 seconds.

## Plan Selection in Signup

The signup wizard ends with a plan-selection step at `/signup/plan` showing three cards in this order: Pro (highlighted as Most Popular), Enterprise, Free Trial. Pro / Enterprise call `/api/checkout` with `source: "signup"` and redirect to Stripe's hosted checkout; on success Stripe redirects to `/signup/done?checkout=success&plan=&cycle=` which shows a personalized "Welcome to Pro" / "Welcome to Enterprise" message. Free Trial skips Stripe and goes straight to `/signup/done`. Existing users can upgrade from `/dashboard/account` (inline two-card picker with monthly + yearly buttons each) or `/pricing` (toggle plus per-card upgrade button).

## Pricing

- **Free Trial**: 30 days, full access, no credit card required
- **Pro**: $10/month or $100/year (save 17% on yearly) - unlimited messages, live chat with AI auto-reply, AI landing pages, all 18 templates, scheduling, triggers, geo + device targeting, push notifications, PWA, analytics, priority support, 1 domain
- **Enterprise**: $99/month or $999/year (save 17% on yearly) - everything in Pro plus team management with role-based access (admin, editor, viewer), up to 20 domain workspaces, shared workspace for messages and chat, dedicated support

## Guides

### Platform Setup
- [Add FloatMessage to Shopify](https://floatmessage.com/guides/add-floatmessage-to-shopify)
- [Add FloatMessage to WordPress](https://floatmessage.com/guides/add-floatmessage-to-wordpress)
- [Add FloatMessage to Wix](https://floatmessage.com/guides/add-floatmessage-to-wix)
- [Add FloatMessage to Webflow](https://floatmessage.com/guides/add-floatmessage-to-webflow)
- [Add FloatMessage to a Custom HTML Site](https://floatmessage.com/guides/add-floatmessage-to-custom-site)
- [Add FloatMessage via Google Tag Manager](https://floatmessage.com/guides/add-floatmessage-via-google-tag-manager)

### Live Chat
- [Setting Up Live Chat](https://floatmessage.com/guides/setup-live-chat)
- [Configuring AI Auto-Reply](https://floatmessage.com/guides/configure-ai-auto-reply)
- [Build an AI Knowledge Base for Your Chat Agent](https://floatmessage.com/guides/build-ai-knowledge-base)
- [Setting Up Push Notifications](https://floatmessage.com/guides/setup-push-notifications)
- [Chat Conditions & Page Targeting](https://floatmessage.com/guides/chat-conditions-targeting)
- [Proactive Chat - Engage Visitors Before They Message](https://floatmessage.com/guides/proactive-chat)
- [How to Contact Your Site Visitors Live](https://floatmessage.com/guides/contact-site-visitors-live)

### Engagement
- [Welcome Message for First-Time Visitors](https://floatmessage.com/guides/welcome-message-first-time-visitors)
- [Exit-Intent Messages to Reduce Bounce](https://floatmessage.com/guides/exit-intent-reduce-bounce)
- [Schedule Messages for Sales & Promotions](https://floatmessage.com/guides/schedule-messages-for-sales)
- [Geo-Targeting for Localized Messages](https://floatmessage.com/guides/geo-targeting-localized-messages)

### Best Practices
- [Choosing the Right Template](https://floatmessage.com/guides/choose-the-right-template)
- [Optimizing Message Timing & Triggers](https://floatmessage.com/guides/optimize-message-timing)
- [Writing Effective Floating Messages](https://floatmessage.com/guides/write-effective-messages)
- [Cookie Consent with FloatMessage](https://floatmessage.com/guides/cookie-consent-gtm)
- [Add a Contact Form to Your Website](https://floatmessage.com/guides/contact-form-floating-message)

## Links

- Website: https://floatmessage.com
- Dashboard: https://floatmessage.com/dashboard
- Pricing: https://floatmessage.com/pricing
- All features overview: https://floatmessage.com/features
- For website owners: https://floatmessage.com/for/website-owners
- For small business (no site yet): https://floatmessage.com/for/small-business
- Documentation: https://floatmessage.com/docs
- Guides: https://floatmessage.com/guides
- Contact / support: https://floatmessage.com/contact (form + info@floatmessage.com)
- Terms: https://floatmessage.com/terms
- Privacy: https://floatmessage.com/privacy
- Sitemap: https://floatmessage.com/sitemap.xml
- Full LLM docs: https://floatmessage.com/llms-full.txt

### Feature deep-dives

- Live Chat: https://floatmessage.com/features/live-chat
- AI Auto-Reply: https://floatmessage.com/features/ai-auto-reply
- AI Landing Pages: https://floatmessage.com/features/ai-landing-pages
- Popup Builder + 18 Templates: https://floatmessage.com/features/popups-templates
- Exit-Intent Popups: https://floatmessage.com/features/exit-intent
- Surveys & NPS: https://floatmessage.com/features/surveys
- Contact Forms: https://floatmessage.com/features/contact-forms
- Book Appointments: https://floatmessage.com/features/book-appointments
- Push Notifications: https://floatmessage.com/features/push-notifications
- Cookie Consent: https://floatmessage.com/features/cookie-consent
- Geo Targeting: https://floatmessage.com/features/geo-targeting
- Device Targeting: https://floatmessage.com/features/device-targeting
- Scheduling: https://floatmessage.com/features/scheduling
- Built-In Ticketing: https://floatmessage.com/features/tickets

## Developer API & MCP (for agents)

FloatMessage has a full REST API and a hosted MCP server so agents can manage an account programmatically - everything the dashboard can do.

- API getting started: https://floatmessage.com/docs/api/getting-started
- Authentication (API keys): https://floatmessage.com/docs/api/authentication
- REST resource reference: https://floatmessage.com/docs/api/rest
- MCP server (for agents): https://floatmessage.com/docs/api/mcp
- Interactive API explorer: https://floatmessage.com/docs/api/reference
- OpenAPI 3.1 spec (machine-readable): https://floatmessage.com/api/v1/openapi.json
- Agent guide (concise): https://floatmessage.com/llms-api.txt
- AGENTS.md: https://floatmessage.com/AGENTS.md
- SKILL.md: https://floatmessage.com/SKILL.md

Base URL: https://floatmessage.com/api/v1
Auth: Bearer token (personal API key, created at https://floatmessage.com/dashboard/account). All plans including Free can use the API.
MCP endpoint: https://floatmessage.com/api/mcp (Streamable HTTP / JSON-RPC, same Bearer token).