Quickstart
Getting started

Quickstart in 10 minutes

Sign up → project → widget on your site → your team and the first conversation. Each step takes a minute or two.

5 steps

  1. 1
    Sign up
    Open the sign-up page and fill in Full name, Email and Password (at least 8 characters). You'll get an email with a confirmation link. Confirm your address: if the platform only allows sign-in with a confirmed email, you won't be able to sign in with your password again without it.
  2. 2
    Create a project
    A project is your team, your customers and your settings in one place. Right after you sign up, a four-step wizard opens: Create Project, Bot Setup, Team, Done. The first step has two fields:
    • Project Name: for example, ForestsNet or AcmeBank
    • Slug: a short Latin-letter address for the project; the wizard checks right away whether it's free
    You can skip connecting a Telegram bot and inviting the team and come back to them later. A new project starts on the free Starter plan, with no card required.
  3. 3
    Open the Widget Builder and set up the look
    Open SettingsWidget Builder. Three sections are enough to start:
    • Brand: accent color, logo, header title
    • Welcome: the title and subtitle of the Home tab
    • Tabs: Help and News show up for visitors only once you have published public articles or announcements for customers, so you can leave them as they are for now
    Your changes are saved to a draft automatically. When you're done, press Publish: visitors only see the changes after that.
  4. 4
    Add the widget code to your site
    At the bottom of the builder's left panel there's an Embed snippet button. It opens a window with a ready-made <script> and a Copy button. The same code is also in SettingsChannels, on the Web Widget card. It already contains your project ID. Paste it before </body> on every page where the chat should appear:
    html
    <script>
    (function(w, d){
      function loadWidget(token){
        var s = d.createElement('script');
        s.async = 1;
        s.src = 'https://support.forestsnet.com/widget-bundle?ws=00000000-0000-0000-0000-000000000000';
        if (token) s.setAttribute('data-visitor-token', token);
        d.head.appendChild(s);
      }
      // ── Optional: cross-device HMAC visitor token ─────────────────
      // Uncomment + implement /api/supporthub/token on your backend to
      // bind the same visitor across devices. Recipes per stack:
      //   https://support.forestsnet.com/docs/widget/hmac-examples
      //
      // fetch('/api/supporthub/token', { credentials: 'include' })
      //   .then(function(r){ return r.ok ? r.json() : null; })
      //   .then(function(data){ loadWidget(data && data.token); })
      //   .catch(function(){ loadWidget(); });
      //
      // Default — anonymous (no token):
      loadWidget();
    })(window, document);
    </script>
    More about the code and its parameters is in the installation section.
  5. 5
    Invite your team and get your first conversation
    Open OperatorsInvite and switch to the Invite Email tab: enter your colleague's email and role, then press Send Invitation. They get an email with an Accept Invitation button (the link is valid for 7 days) and become an operator once they accept.

    Meanwhile, open your site in an incognito window. You'll see the chat button in the corner: click it, then Send us a message, and send “hi”. A new conversation shows up in the Inbox right away, and an operator can reply.

    Done. Your site now has working support.

What's next

The rest of the setup is iterative: you add to it as questions come in. Here's a suggested order:

  1. Home and greeting: the Home tab texts, the pinned banner and auto-open.
  2. Working hours: what visitors see outside working hours.
  3. Conversation: the operator's name, reactions and system messages.
  4. Limits: rate limits and the list of domains messages are accepted from.
  5. For admins: departments, SLA and billing.
Was this page helpful?