Docs

Set up FluxChat

Four steps from sign-up to a live chat on your store.

Set up in four steps

Each step is a short form on your dashboard home.

  1. 1

    Add your store

    Its domain, its name and its platform: Shopify, WooCommerce or Other.

  2. 2

    Set up your server

    Run one command on a fresh Ubuntu or Debian server, or deploy to your own n8n.

  3. 3

    Add your OpenAI key

    It powers the answers and is saved on your own server only.

  4. 4

    Go live

    Paste the snippet from Install on your store, then run a test chat.

Before you start

For a new server. Deploying to your own n8n needs its https address and an n8n API key instead of the first two.

  • A subdomain

    Its A record points at your server, like chat.yourstore.com. It can't be your store's own domain.

  • A server

    Ubuntu 22.04+ or Debian 12, 2 GB RAM, root access, ports 80 and 443 open.

  • An OpenAI API key

    Create one at platform.openai.com.

  • A license

    Free Starter covers one site. Pro is a one-time purchase for 1, 3 or 10 sites.

Paste it on your platform

Copy the snippet from Install in your dashboard, then follow the steps for your platform.

WordPress
  1. Go to Appearance → Theme File Editor → footer.php (or use a header/footer plugin's Footer field).
  2. Paste both <script> tags right before the closing </body> tag.
  3. Save the file.
Shopify
  1. Go to Online Store → Themes → Edit code → layout/theme.liquid.
  2. Paste both <script> tags just above the closing </body> tag.
  3. Save the file.
Wix
  1. Go to Settings → Advanced → Custom Code.
  2. Add a new code snippet, paste both <script> tags, and set it to load on all pages, in the Body - end position.
Squarespace
  1. Go to Settings → Advanced → Code Injection.
  2. Paste both <script> tags into the Footer field and save.
Webflow
  1. Go to Project Settings → Custom Code → Footer Code.
  2. Paste both <script> tags and publish your site.
Plain HTML
  1. Paste both <script> tags directly into your .html file, right before </body>.
  • Flutter app: the Flutter SDK is included with Pro. Request it by email.
  • WordPress plugin: coming soon. The snippet works on WordPress today.

Customize your widget

Set colors, the welcome message and starter suggestions on Widget. Your snippet updates as you go.

Keep it running

  • Update the server

    After a FluxChat release, run curl -fsSL https://fluxchat.ai/install.sh | sudo bash -s -- update from Backend. It keeps your keys and chat history.

  • Connect the add-ons

    On Pro, add the keys the add-on workflows need under Connections on Backend.

  • Remove a site

    Remove it on License to free its slot for another domain.

Guides

Longer walkthroughs from the blog. Browse the workflows.