GhostChat

GhostChat on Webflow: help

Everything the GhostChat app does on your Webflow site, and how to undo it.

Set it up

  1. Install GhostChat from the Webflow Marketplace and choose the site to connect.
  2. Click Continue with GhostChat. Sign in to GhostChat, or create a free account, then click Add chat to this site. GhostChat takes your site’s name and address from Webflow, so there’s nothing to type or paste, and you come straight back here.
  3. Click Publish now, or publish from Webflow as usual. Webflow applies code changes only when a site is published.

To open the app again later, open your site in the Webflow Designer, press E for the Apps panel, and choose GhostChat → Open App.

Colors, greeting, position and your inbox live in the GhostChat dashboard.

What it adds to your site

  • What: the GhostChat chat widget, as one script file, added through Webflow’s custom code feature. GhostChat hosts the file at a fixed, versioned address, and it is registered with Webflow with an integrity hash, so your visitors’ browsers run exactly the reviewed file. It loads no other code and adds no iframes; it only exchanges chat messages and the widget’s settings with GhostChat’s API.
  • Where: every page of the site, placed just before </body>.
  • Why: to show the chat bubble so visitors can message you.
  • Nothing else: it doesn’t change your pages, styles, forms or other scripts.

What the chat widget collects

  • No cookies. Nothing is stored in a visitor’s browser until they open the chat; then a session ID and its key, plus the name or email a visitor types, are kept in its local storage.
  • The messages visitors send, and a name or email if they choose to give one.
  • The pages a visitor views before and after opening the chat, so you can see where they were.
  • Approximate country and network, derived from the IP address, which is used only transiently for security.

The full detail is in GhostChat’s privacy policy.

What the app stores

Your Webflow site’s ID and the access Webflow grants the app (encrypted). It’s used only to add, change or remove the script and to publish when you click Publish now.

For signing in by email, a one-way hash of the email address of the Webflow account that connected the site, made with a secret key. The address itself isn’t stored. An address you type to get a sign-in link is used only to send that email.

Which GhostChat site your Webflow site is linked to. GhostChat, on its side, notes the Webflow site’s ID against that GhostChat site.

Disconnect clears the link and keeps the app’s access, so you can connect again without approving it in Webflow again. Everything is deleted within a day of uninstalling the app in Webflow.

Sign in from another browser

The browser you connected the site from stays signed in. On another browser or computer, open the app and choose Sign in with email. Enter the email of the Webflow account that connected the site, and you’ll get a sign-in link that works once, within 15 minutes. You don’t need to connect the site again.

Sign out, at the bottom of the site screen, signs out only that browser. GhostChat stays on your site, and the app keeps its access.

Widget updates

The widget file for a version never changes. When a newer widget is approved by Webflow as a new version of the app, the app shows an Update widget button; your site gets it when you click it and publish. Nothing changes on your site on its own. Settings such as color and greeting are data, not code, so changing them in GhostChat needs no publish.

Disconnect, or uninstall

  1. Open the app and click Disconnect GhostChat.
  2. Choose Disconnect and publish now, or disconnect and publish later from Webflow. The chat stays on your live pages until the site is published.

Disconnect takes the script off your site and unlinks it from your GhostChat account. Your GhostChat account and conversations stay. To link the site again, to the same or another GhostChat account, click Continue with GhostChat.

To remove the app completely, uninstall it in Webflow (Site settings → Apps & Integrations). Webflow takes the script off when you next publish, and the app deletes what it stored within a day.

Requirements

  • Webflow allows custom code only on a site with a paid site plan, or in a paid workspace.
  • A GhostChat account. GhostChat has a free plan and paid plans; see ghostchat.dev/pricing.

Common questions

I pasted the GhostChat snippet into my site settings before. Delete it from Site settings → Custom code once the app is set up, and publish. Don’t paste GhostChat code into a Webflow site: the app adds and removes the widget for you.

The chat doesn’t show. Publish the site, then open the published site (not the Designer canvas).

Support

Email jacob@ghostchat.dev.