Simple hierarchy
Pipeline
A pipeline represents a specific flow in your funnel — the path a lead travels from start to finish. Common examples:
Keeping pipelines separate means each one tracks its own metrics and cadence. Outbound conversion rates should never be mixed with inbound.
Stages
Stages are the steps a lead moves through inside a pipeline. Sensible defaults for B2B outbound:”Closed” stages
Stages can be marked as closed-won or closed-lost. This:- Moves the lead to the “history” view automatically
- Counts toward conversion rate metrics
- Signals to agents that “no further action is needed on this lead”
Lead
A lead is a card that lives in a pipeline stage. Each lead carries:- Contact data (name, email, phone, website)
- Company data (name, location, industry)
- Owner — the person responsible (human or agent)
- Potential value — what closing this lead is worth (in cents of the configured currency)
- Tags — customizable labels
- Custom fields — fields defined by your org
Owner
The lead’s “owner” determines who the system notifies on events (reply received, time for a follow-up, etc.). The owner can be:- A human (org member)
- An agent (Marcus, Athena, or a custom agent)
Activities
Every meaningful lead event generates an activity in the history log. This is the CRM’s audit log — append-only, nothing is ever deleted. Automatic activity types:
Each activity records who did it (human X or agent Y), when, and the change payload. Full auditability — you can reconstruct any lead’s complete history in seconds.
Human vs. agent actions
When Marcus moves a lead between stages (e.g., “In conversation” → “Proposal sent” after firing off a proposal), the activity carriesactor_type = 'agent' + the agent’s ID.
When you move it manually, it’s actor_type = 'user' + your user ID.
This shows up in the lead’s timeline — instead of “Stage changed to X”, you see “Marcus moved to X” or “João Silva moved to X”. No ambiguity.
Filters and segmentation
Filters apply to the visible set of leads. You can combine:- Pipeline + stage
- Owner (specific human, any human, specific agent)
- Tags
- Custom field values
- Date (creation, last activity, next action)
- Potential value (range)
Next steps
CRM (feature)
How to work day-to-day: kanban, list view, custom fields, and import.
Outbound
How leads become campaigns managed by Marcus.
Agents
When an agent is a lead’s owner, it operates autonomously.