Customer relationships — from a first name to a won deal
This guide follows one customer the whole way: a name written down at a trade show becomes a
lead, the lead becomes an account and a contact, a deal comes out of it, and the deal moves
across a board until it closes. Every step is shown with a screenshot from the running system.
You will also see what the platform refuses to do, and why those refusals are the design
rather than a fault.
1 — The problem this module exists to solve
Before there is a CRM, customer information lives in three places: a spreadsheet on the rep's
machine, a mail thread in their personal inbox, and their memory. The consequences are familiar.
A rep travels and half the follow-ups stop. A manager cannot know the real state of the pipeline
without asking. Two colleagues talk to the same customer without knowing about each other.
And the finding that shapes everything here: CRM projects do not usually fail because the
software lacks features. They fail because nobody enters the data. So this module is built
so the platform captures what it already knows — mail sent through
DWMail, meetings that took place, approvals that travelled through a
workflow — and attaches it to the customer without anyone
retyping it.
2 — The big idea: four stations, and everything else hangs off them
Understand these four and you understand the module. Every screen you open stands on one of them.
LeadA name you are not yet sure about. It came from an event or a form on your website. It may come to nothing, and that is fine.
→
Account + contactOnce it is serious: the company becomes an account, and the person you deal with becomes a contact under it.
→
DealAn opportunity with an amount, a stage and an expected close date. This is what moves across the board.
→
QuoteThe formal document with prices and line items. Past a discount threshold it goes for approval before it can be sent.
One distinction matters more than it looks. A lead can be thrown away without regret;
an account persists. That is why names you are unsure about stay in the lead list rather
than the account list — so the account list stays clean enough to be trusted.
What you see inside the module divides into three:
Who you deal with
Accounts, contacts and leads. The customer record itself.
Work in flight
Deals, quotes and support cases. Where each relationship currently stands.
What happens by itself
Mail, meetings, approvals and tasks, attached to the customer without manual entry.
The running example: Salem, a sales rep, is working Nile Trading Co., dealing with
Ahmed Mansour, their purchasing manager, on a deal called "Storage racking supply —
phase one" worth EGP 250,000. Every screenshot below is from that same story.
3 — My Day: the screen you open first
The module opens on My Day. It is not a report — it is a work list: deals that need
moving, tasks due today, and leads nobody has touched. The point is that a rep should not have
to work out what to do next; the screen tells them.
My Day. The task list comes from the platform's collaboration hub, which is the
single source of tasks for every module — so a CRM follow-up and an HR request sit in one
inbox rather than two.
4 — Leads: the name you are still checking
Open Leads. Each row is a person, a company and some way to reach them. They arrive three
ways: typed in, submitted through a form on your website, or imported from a file after
an event.
The leads list. The status column says how far the conversation has got: new,
working, qualified, or disqualified.
When you are satisfied the lead is real, open the row's actions menu and choose Convert.
It is the most consequential click on this screen.
The row actions menu. These three are everything that can happen to a lead: it
converts, it moves to another rep, or it is disqualified.
Conversion does three things in one action: it creates the account, the contact,
and — if you want — the deal. The lead itself is not deleted; it stays linked to what came
out of it, so you can always answer where a deal originally came from.
The conversion dialog. If the company already exists it offers to attach the lead to
it rather than creating a duplicate account.
Conversion does not reverse. There is no button that turns the account, contact and deal
back into a lead. Convert when there is real work to do, not to tidy the list.
5 — Accounts and contacts: who you sell to
The account is the company; the contact is the person. One company usually has
several — the purchasing manager who negotiates, the finance director who signs, an engineer who
checks the specification. They are kept separate because people leave and companies remain.
The accounts list.
Open Nile Trading Co. and you get the account page: its details, the contacts under it, the open
deals, and a timeline of everything that has happened — mail, meetings, calls, notes — in one
place, in date order.
The account page. The timeline is what lets a colleague pick up the relationship in
a minute without having to ask anyone.The contacts list — the same people, organised as individuals rather than as
companies.
One thing the system refuses firmly: a mail domain can only belong to one account. That is
not bureaucracy — the domain is the key the platform matches incoming mail on. If two accounts
claimed it, every message that arrived would be ambiguous.
6 — Deals: the board everything moves across
A deal is an opportunity with an amount and a stage. Stages are ordered into a
pipeline, and a deal travels along it. The screen shows them as a board — one
column per stage — and you move a deal by dragging it.
The deals board. Each column is a stage and each card a deal — and the total above
each column tells you how much is sitting in it.
Open a deal and everything about it is there: the customer, the person, the amount and currency,
the expected close date, the next step, and the deal team — the colleagues working it with
you — with the deal's own timeline underneath.
The deal page. "Next step" looks like a small field and is the most important one on
the screen: a deal with no next step is a deal quietly dying.
If a deal sits in its stage longer than that stage allows, the system marks it stalled and
puts a task in its owner's work list. Not a month-end report — a prompt at the time.
7 — Quotes and approvals: where "not on your own" applies
From a deal you build a quote: line items with prices, quantities, discount and tax. What
matters is what comes next — if the discount exceeds the permitted threshold, the quote
cannot simply be sent. It enters an approval workflow
and goes to whoever approves that.
The quotes list. The status column separates draft from awaiting approval, sent and
accepted.
And the person who requested the discount deliberately cannot approve it. Even if they
hold both permissions, the system refuses and says why. This rule is called separation of
duties and it applies across the whole platform, not just here — the detail is in
the permissions course. If you are a small company and that
person really is alone, the answer is for the tenant owner to approve, not for the rule to be
switched off.
8 — Service: after you have sold
Selling is not the end of the relationship. When a customer complains or asks for something, a
case is opened — a ticket with a priority, a queue, an assignee and promised times for a
first response and a resolution. Those promises are counted in real working hours: a
Sunday-to-Thursday week, with public holidays excluded. A complaint arriving on Thursday
afternoon stops the clock and resumes it on Sunday morning.
The cases list. The "at risk" tile counts cases whose promise is close to expiring
on the page shown — and the caption underneath says so, rather than implying a
tenant-wide figure.
A case has two separate panes: the conversation with the customer, which really is sent to
them, and internal notes between colleagues. The separation is deliberate and visible, so it is
not possible to write an internal note and discover it went to the customer.
9 — Campaigns and reports: the wider picture
Campaigns group the people who received a message or attended an event, and connect them
to the leads that came out of it — so you can tell which sources produce real work and which
produce names.
The campaigns list.Reports: the funnel (how many deals pass each stage), win rate, and cycle
velocity.Forecast — it keeps "in the pipeline", "best case" and "committed" apart, because
those are three different promises.
10 — Settings: your own sales process
Sales stages are not the same at every company. Under Settings → Pipelines you edit them:
add, remove, reorder, and give each stage a probability and a number of days after
which a deal sitting there counts as stalled. You can have more than one pipeline if you sell in
more than one way.
Pipeline settings. That probability is what the forecast is calculated from, so keep
it honest.
10a — Where are your public addresses?
This is the question that wastes the most time at the start. Every address your customers and
your staff reach you on is in one place: Settings → Public links.
The public links page. At the top is your tenant key — the name that appears
in every public URL, and the single hardest thing to find before this screen existed.
What is on it divides into three, and the page says which is which:
Your staff sign-in page — a link carrying ?tenant= that opens the login
screen with your own logo and colours. Send it to your team or bookmark it; without that part
they get the default look.
The customer portal and your web forms — these are the ones you publish.
Quote, survey and unsubscribe links — shown as patterns so you can recognise them.
Each real one is minted for a single customer when you send it, and must never be published.
If the page warns that the addresses are not configured: no public origin has been set for
the platform and what you see is a guess. Talk to whoever runs the deployment before publishing
any of them — the alternative is discovering it is broken from the customer's side.
11 — Who sees what: the most-asked question
A rep does not see their colleagues' deals. That is not a setting somebody got wrong — it
is the design. Each person sees what they own, a manager sees what their reports own, and the
tenant owner sees everything. If a colleague is added to a deal team, they can see that
deal in order to help — without consuming an extra paid seat.
The same board under Salem's account — smaller than the one above, because it shows
only his deals.
There is a finer level too: someone can see a deal without seeing its amount. The amount
has its own permission, because a colleague brought in to help deliver does not need to know what
the company sells at. When it is withheld it is shown as withheld — not as zero. That
difference matters: zero is a number, and people act on numbers.
And if you open a screen you have no permission for, the platform says so plainly, names the
permission you are missing, and shows you nothing else — rather than an empty table that reads as
"there is no data".
The refusal on screen. Note that there are no figures or empty cards above it — the
page does not invent "0 cases" for somebody who may not see cases at all.
12 — On a phone
The module works on a phone exactly as it does on a computer — same account, same permissions,
with the screens stacked vertically. A rep standing at a customer's site can open the deal and
write the next step where they are.
Deals on a phone.
13 — Recipes: "I want to…"
I got a name at a trade show
Leads → Add. Enter the name, the company and at least one way to reach
them. Leave it as a lead until you have spoken to them.
They are serious and I want to start working
Open the lead's row menu → Convert. It produces an account, a contact and
a deal. If their company is already on file, attach to it rather than creating a new
account.
Move a deal to the next stage
On the board, drag the card to the next column — or change the stage on
the deal page. Both are recorded in the deal's history with the date and who did it.
Bring a colleague onto a deal
Deal page → Deal team → Add. They can see that deal and its history
without gaining access to any other deal, and without a paid seat.
Issue a quote with a large discount
Build it and submit it. If the discount is over the threshold it goes for
approval on its own — track it from the approvals inbox. Do not try to approve it yourself; the
system will refuse.
A rep has left and their deals are stranded
From the deals list, select their deals → Reassign. That permission
belongs to the manager, not the rep, and who moved them is recorded.
Change our sales stages
Settings → Pipelines: add or reorder stages, and set each one's
probability and stall days. Change carefully — existing deals are attached to these
stages.
14 — Frequently asked
What exactly is the difference between a lead and a contact?
A lead is a name you are still checking and may discard. A contact is a real person at a company
you are actually working with. In practice: the lead list is allowed to contain rubbish; the
account list has to stay clean.
Why can't I see my colleague's deals?
Because that is how the system works, not because something is broken. Each person sees what they
own and a manager sees their reports. If you need a particular deal, ask to be added to its
team.
I can see the deal but the amount says it is hidden — why?
The amount carries its own permission, separate from the deal. Being entitled to see the deal
does not imply being entitled to see what it sells for. Ask whoever administers permissions for
crm.deal.read_amount if your job needs it.
I mailed the customer from DWMail — will it be logged here automatically?
Yes, as long as that address is on a contact, or their company's domain is registered on the
account. The mail is linked to the account and the deal, and only the subject and a short
snippet are stored — the message itself stays in mail, and you open it there under your own
mailbox rights.
Can I import a customer file in Arabic?
Yes. One thing to watch: the file must be UTF-8. If you open and save it from Excel
without choosing that encoding, the Arabic names turn into question marks before they ever reach
the system.
Does this issue tax invoices to the authority?
Invoices exist as documents. The e-invoicing connection is planned as its own phase with an
accounting sign-off before it is enabled for any real tenant. Do not build on it yet.
What about WhatsApp?
Not present and not planned for this module. The supported channels are mail, web forms and the
service desk. Phone calls are logged manually.
In three sentences. The whole module is four stations — lead, account and contact, deal,
quote — and every screen you open stands on one of them. What makes it work is that the platform
attaches mail, meetings and approvals to the customer by itself, so reps sell instead of typing.
What makes it safe is that each person sees only what is theirs, and when the system withholds
something it says so on screen rather than showing a zero or an empty page.