Directory
The people and groups your workspace owns — identities, addresses, and the customer each belongs to
The Directory is the roster of everyone your agents talk to or about — the people and groups your workspace owns, and the environments (end-customers) they belong to. It's the tenant-level source of identity: who someone is, which addresses reach them, and how agents should treat them.
Elsewhere in the docs and the API these records are called participants — the umbrella term for a person or a group. The Directory is where you manage them; Agent Network wires them to triggers and channels, and Applications grant them roles.
Mental model
| Tab | What it holds |
|---|---|
| People | Individual identities — a customer, a teammate, or anyone an agent messages or consults. |
| Groups | Shared threads that act as a single addressable identity — a Telegram group, a Slack channel. |
| Environments | The end-customers people belong to. See Environments. |
People
Each person is one identity, described by:
- Type — the audience axis: Customer (someone you support) or Team member (internal staff, eligible to act as an escalation operator). Unclassified until you set it.
- Environment — the end-customer this person belongs to, or Unaffiliated. See Environments.
- Addresses — the provider handles that reach them: a Telegram chat, a Slack user, a phone number. One person can carry several.
- Linked accounts — external profiles (GitHub, Jira, …) used only to correlate a person's activity across products. Reference links only — never used to route messages.
The person detail
Open a person to manage four tabs:
- Profile — Expertise tags (topics other agents consult this person about; an agent routes a consult by matching them), Profile details (a bio and contact preferences agents use when they describe or hand off to this person), and Linked accounts.
- Addresses — the channels this person sends and receives on, with health.
- Applications — which Applications this person has a role in.
- Activity — conversations observed through this person's addresses.
You can Test send a message to verify an address, and Pause a person to ignore their inbound and suppress outbound dispatch.
Adding people
| Action | What it does |
|---|---|
| Add person | Create a new identity by hand — a name and one or more addresses. |
| Add collaborator | Add an existing Fruxon user (a teammate with a login) to the Directory. |
| Import | Bulk-add identities from a CSV file. |
| Sync customers | Bulk-import an integration's contacts into the Directory. Appears only when an integration declares the directory-source capability, and runs a dry-run first. |
"Add collaborator" adds a teammate who signs in to Fruxon. Workspace access — who can view or administer an Application — is a separate concept, configured under an Application's Collaborators. See Applications.
Groups
A group is a shared thread treated as one addressable identity — a Telegram group or a Slack channel that many people post in, but that an agent reaches as a single participant. Groups carry addresses and can be granted roles in an Application exactly like a person.
Environments
Environments live on their own tab and are documented in full on the Environments page. In short: an environment is the end-customer a person belongs to — the unit you enroll an agent to serve, and the tag that splits cost and analytics per customer.