first commit

2026-10-20 09:41:46 -06:00
commit 2f9031492e
116 changed files with 3737 additions and 0 deletions
@@ -0,0 +1,91 @@
+---
+title: "FreeScout"
+category: "Business operations"
+tagline: "A shared help desk inbox so your team can answer customer email together."
+replaces: ["Zendesk", "Help Scout", "Freshdesk", "Front"]
+address: "freescout.example.com"
+website: "https://freescout.net/"
+upstreamDocs: "https://github.com/freescout-help-desk/freescout/wiki"
+links:
+  - name: "FreeScout wiki"
+    url: "https://github.com/freescout-help-desk/freescout/wiki"
+  - name: "FreeScout modules"
+    url: "https://freescout.net/modules/"
+  - name: "FreeScout FAQ"
+    url: "https://github.com/freescout-help-desk/freescout/wiki/FAQ"
+---
+
+## Overview
+
+FreeScout turns a support address like `support@example.com` into a shared inbox. Every incoming email becomes a **conversation** that can be assigned, discussed internally, and tracked until it's resolved, so nothing falls through the cracks and customers get one consistent reply.
+
+Main capabilities:
+
+- **Mailboxes** connected to your support addresses.
+- **Assignment**, **statuses** (Active, Pending, Closed, Spam), and **follow** to stay informed.
+- **Internal notes** visible only to your team, with @mentions.
+- **Saved replies** for common answers.
+- **Collision detection** so two people don't answer the same email.
+- **Customer profiles** with conversation history.
+- **Auto-replies**, signatures per mailbox, and notification settings per person.
+- **Modules** (some free, some paid) for knowledge bases, satisfaction ratings, live chat, reports, and more.
+
+### What it replaces
+
+FreeScout replaces email-based help desks such as Help Scout, Zendesk, Freshdesk, and Front for teams that support customers mainly over email.
+
+## Signing in
+
+Open your FreeScout address and sign in with the account your administrator created. FreeScout keeps its own user list; ask an administrator to add you to the right mailboxes.
+
+## Handle conversations
+
+1. Open a mailbox from the top menu. Folders on the left show **Unassigned**, **Mine**, **Assigned**, **Closed**, and **Spam**.
+
+   {{< screenshot src="freescout/conversations.png" alt="FreeScout mailbox showing the Assigned folder with a list of conversations" caption="A mailbox, with folders on the left and conversations on the right." demo="true" >}}
+
+2. Open a conversation and **assign** it to yourself (or a colleague) from the toolbar.
+3. Choose **Reply** to answer the customer, or **Note** to leave an internal comment.
+4. Set the status when you send:
+   - **Active** while you're working on it.
+   - **Pending** when you're waiting for the customer. It returns to Active when they reply.
+   - **Closed** when it's resolved.
+
+   {{< screenshot src="freescout/reply.png" alt="Replying to a conversation in FreeScout, with the Status and Assign to menus under the editor" caption="Replying to a customer. The **Status** and **Assign to** menus sit under the editor." demo="true" >}}
+
+Use **Saved replies** (the speech-bubble icon in the editor) for answers you send often, and **Merge** if a customer starts several conversations about the same thing.
+
+## Notifications
+
+Under your avatar, **Your profile**, **Notifications**, choose which events email you or show in the browser: new conversations, replies to your conversations, mentions, and more.
+
+## Set up a mailbox (administrators)
+
+1. Go to **Manage**, **Mailboxes**, **New mailbox**. Enter the name and support email address.
+2. Open **Connection settings**:
+   - **Sending emails**: choose SMTP and enter your outgoing mail server details.
+   - **Fetching emails**: enter the IMAP details for the mailbox so FreeScout can collect new messages.
+
+   {{< screenshot src="freescout/connection-incoming.png" alt="The Fetching Emails tab of a FreeScout mailbox's connection settings" caption="**Connection settings**, **Fetching emails**: the IMAP server, port, username, and password for the mailbox." demo="true" >}}
+
+3. Under **Permissions**, choose which users can access the mailbox.
+4. Set the mailbox **signature** and an **auto reply** acknowledging new requests.
+
+If your support address is hosted on Federated Core's mail server, get the IMAP and SMTP details from Superpanel. Create a dedicated mailbox for FreeScout rather than using a person's own mailbox.
+
+## Administer FreeScout
+
+Open **Manage**:
+
+- **Users**: invite agents and set their role (User or Administrator).
+- **Settings**: company name, logo, time format, and mail settings for system notifications.
+- **Modules**: install and activate modules. Paid modules require a licence key from FreeScout.
+
+## Superpanel settings
+
+{{< review "confirm Superpanel option names for FreeScout." >}}
+
+- **Access**: choose which groups are given the FreeScout address.
+- **Mailboxes**: create the shared support mailbox in Superpanel, then connect it in FreeScout.
+
+Fetching email depends on a scheduled task that Federated Computer runs. If new emails stop appearing, check **Manage**, **System**, **Status**, then contact support.