skip to main content
[ /DOCS · QUICKSTART ]WAVE 15 R2-C

Quickstart

Go from signup to first AI resolution with an inbox, persona, test ticket, and automation guardrail.

Before you start

Beamdesk works best when three pieces are connected: a conversation source, a persona that defines how the AI should answer, and a small knowledge base or tool catalog that lets the persona ground replies in your business data.

For the first run, pick one support mailbox or one website widget. Do not connect every channel yet. A narrow first test makes it easier to inspect routing, confidence, escalation, and auto-resolution behavior before you invite the full team.

Setup flow

01

Create your workspace

Open /signup, create your account, and name the workspace after the team that owns the queue. Beamdesk uses the workspace name in internal routing labels, audit exports, and default notification copy.

[ Screenshot — coming soon ]
Quickstart signup screenshot
Screenshot placeholder: signup form with workspace name, owner email, and region selector visible.
02

Connect an inbox

Choose forwarding or widget. Forwarding is fastest for email teams: create a forwarding rule from your support mailbox to the Beamdesk inbound address shown during onboarding. The widget is better when your first test should happen from a website session.

For forwarding, send one test email from an address outside your company domain and wait for it to appear in the queue. For the widget, install the script snippet on a staging page and send a short message as a visitor.

[ Screenshot — coming soon ]
Inbox connection screenshot
Screenshot placeholder: inbox connection screen showing forwarding address, widget install snippet, and last test event.
03

Set the first persona

Open AI Personas after onboarding and configure the default support persona. Start with a short role, a tone rule, two refusal rules, and the knowledge sources it may use.

A practical first persona says what the agent can answer, how it should sound, and when it must hand off. Add tool access only after the first knowledge-only answer looks correct.

[ Screenshot — coming soon ]
Persona setup screenshot
Screenshot placeholder: persona editor with system prompt, tone, tools, escalation owner, and test prompt panel.
04

Create the first ticket

Send a realistic customer question: a pricing question, order status question, refund question, or setup blocker. Avoid a synthetic "hello" test because it does not exercise knowledge retrieval, confidence scoring, or escalation rules.

In the inbox, inspect the ticket timeline. You should see the inbound message, classification, retrieved knowledge, drafted reply, confidence score, and any automation actions.

[ Screenshot — coming soon ]
Ticket timeline screenshot
Screenshot placeholder: ticket timeline with classification, retrieved sources, draft answer, and confidence badge.
05

Enable first auto-resolve

Create a narrow rule in Automations: when the default support persona answers with high confidence, no restricted topic is detected, and the customer does not ask for a human, send the reply and resolve after a short delay.

Run the rule in dry-run mode first. If the preview shows the correct reply, tag, and audit event, enable it for the test queue. Your first auto-resolved ticket should include a full audit trail and the exact knowledge sources used.

[ Screenshot — coming soon ]
Automation dry-run screenshot
Screenshot placeholder: automation dry-run panel showing matched conditions, planned reply, resolve delay, and audit output.

What to do next

Add more source material in Knowledge Base, connect operational tools in Integrations, then split the default persona into support, sales, billing, or technical specialists.

Keep the first production rollout limited to one queue and one auto-resolution policy. Once the resolution rate and escalation quality look stable, clone the setup to the next channel.