# CRM

Add leads and contacts, move deals through the sales stages, log calls and tasks, and convert a lead to a customer account.

Deals slip when the last call lives in one person's head. At Harbor Point Logistics, salespeople log every call and next step in the CRM, so the sales manager sees the whole pipeline.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

The CRM keeps five kinds of record. A **lead** is someone you might sell to. An **account** is a customer. **Contacts** are the people at a lead or account. An **opportunity** is a deal with an amount and a stage. **Activities** are calls, emails, meetings, notes and tasks.

The page has five tabs:

- **Dashboard**: quick actions, totals, **Pipeline by stage** and **Tasks and follow-ups**.
- **Leads**: every lead, with **New lead**.
- **Opportunities**: your deals as a **Pipeline** board or a **Table**, with **New opportunity**.
- **Accounts**: every customer, with **New account**.
- **Activities**: everything logged, under **To do** or **Done**, with **Log activity**.

## Set it up

1. Open **Module Settings** from the ⋮ on the module's sidebar row to set the default currency for new deals. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
2. Decide who can do what (see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f)). Out of the box, Viewers look, Operators work records day to day, and Admins also archive, convert leads and delete activities.
3. Give **Use the CRM assistant** to the roles that should use the CRM Assistant.
4. On a new CRM, the **Dashboard** shows **Get started**. Click **Add your first lead**, or **I already have customers** to add accounts directly.

## Add a lead and its people

1. Open **Leads** and click **New lead**.
2. Type the **Name**, and the **Industry**, **Source** and **Notes** if you have them.
3. Click **Create lead**.
4. Open the lead. Click **Add** on its **Contacts** card, fill in the **First name** and **Last name**, and click **Add contact**.

A customer you already work with goes straight in: open **Accounts**, click **New account**, and click **Create account**.

## Work a deal

1. Open **Opportunities** and click **New opportunity**, or **Add** on a lead's **Opportunities** card.
2. Type the **Deal name**, pick the **Customer**, and set the **Stage**, **Amount** and **Expected close**.
3. Click **Create opportunity**.
4. To move it on, drag its card to another column on the **Pipeline** board. Or open it, click a stage in its **Stage** card, and click **Save**.

Each stage fills in a usual probability, from 10% at Discovery to 75% at Negotiation. Type your own number and it is kept. Moving a deal to **Closed Won** or **Closed Lost** asks you first.

## Log calls and follow-ups

1. Click **Log activity** on the **Activities** tab, the **Dashboard**, or a record's **Timeline**.
2. Pick the **Type**: **Call**, **Email**, **Meeting**, **Note** or **Task**.
3. If you didn't start from a record, pick what it is **Related to**.
4. Type a **Subject** or **Details**, and set **When**. A future date schedules it.
5. To plan the next step, tick **Add a task for the next step** and set **Follow-up due**.
6. Click **Save**.

When a task is finished, click **Mark done**. It moves from **To do** to **Done**.

## Convert a lead to an account

1. Open the lead.
2. Click **Convert to account** and confirm.

An account is created with the lead's name, and its contacts, deals and activities move to it. The lead is marked **Converted**.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **View contacts** | Look up contacts. | Admin, Operator, Viewer |
| **Add contacts** | Add new contacts to leads and accounts. | Admin, Operator |
| **Edit contacts** | Change contact details. | Admin, Operator |
| **Archive contacts** | Archive and restore contacts. | Admin |
| **View opportunities** | See deals and the pipeline. | Admin, Operator, Viewer |
| **Add opportunities** | Start new deals. | Admin, Operator |
| **Edit opportunities** | Change deals and move them between stages, including closing them won or lost. | Admin, Operator |
| **Archive opportunities** | Archive and restore deals. | Admin |
| **View leads** | Look up leads. | Admin, Operator, Viewer |
| **Add leads** | Add new prospects. | Admin, Operator |
| **Edit leads** | Change lead details. | Admin, Operator |
| **Archive leads** | Archive and restore leads. | Admin |
| **Convert leads to accounts** | Turn a lead into a customer account, moving its contacts, deals and history over. There is no undo button. **Give with care.** | Admin |
| **Website: send in leads** | Lets the workspace website's API key send contact form requests in as leads. Never give it to a person or role. **Give with care.** | Nobody |
| **View accounts** | Look up customer accounts; also unlocks the Pocket CRM download. | Admin, Operator, Viewer |
| **Add accounts** | Add customers directly. | Admin, Operator |
| **Edit accounts** | Change account details. | Admin, Operator |
| **Archive accounts** | Archive and restore accounts. | Admin |
| **View activity history** | See notes, calls, emails, meetings and tasks on customers. | Admin, Operator, Viewer |
| **Log activities** | Record calls, emails, meetings, notes and tasks. | Admin, Operator |
| **Edit activities** | Correct logged activities and mark tasks done. | Admin, Operator |
| **Delete activities** | Permanently delete activities; they cannot be brought back. **Give with care.** | Admin |
| **Use the CRM assistant** | Ask the AI assistant to look up and change CRM records. | Admin, Operator |
| **View recorded meetings** | Read meeting transcripts and AI write-ups. | Admin, Operator, Viewer |
| **Record meetings** | Capture meetings and have AI write them up (uses AI). | Admin, Operator |
| **Edit recorded meetings** | Correct or archive recorded meetings. | Admin, Operator |
| **View products** | Look up the product catalog and prices. | Admin, Operator, Viewer |
| **Manage products** | Add, change and deactivate products and their prices. | Admin |
| **View proposals** | See proposals and proposal templates. | Admin, Operator, Viewer |
| **Create proposals** | Create proposals and their line items. | Admin, Operator |
| **Edit proposals** | Revise proposals and mark them sent, won or lost; accepting one closes the deal and converts the lead. | Admin, Operator |
| **Generate proposal documents with AI** | Have AI write narrative sections (scope, terms) for a proposal. Each use costs AI. | Admin |
| **Manage proposal templates** | Upload and manage the templates that shape proposal documents. | Admin |

## Ask its agent

The **CRM Assistant** works with your access and no more. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48). Try:

- "Add a lead for Granite Peak Outdoors, industry retail."
- "I called Dana at Acme Precision about the expansion." It logs the call.
- "Move the Phase 2 expansion deal to Negotiation."

It won't add a company you already have, and it asks before closing a deal or converting a lead.

## Good to know

- **The buttons show for everyone.** If your role doesn't allow an action, the page says it could not do it.
- **Every deal needs a customer.** Add the lead or account first, then the opportunity.
- **Records are archived, not deleted.** Pick **Archived** in the status switch, open the record and click **Restore** to bring it back.
- **A scheduled meeting isn't on your calendar.** It's recorded in the CRM with its date, under **To do**.
- **Recorded meetings and proposals** don't show on the web page. Ask the CRM Assistant about them.

## More help

Open the module's **Help** (top right) for the full reference, and its runbooks where your workspace has them (see [Find and follow a runbook](article:4b62ad1f-577a-4998-8bce-f00226376522)). CRM datasets such as leads, opportunities and activities can be charted; see [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).


Source: https://datavisions.ai/docs/module-guides/crm
