Enable CRM for users
Overview
An administrator enables Eos CRM for a user by assigning an active functional role with Sales access. The standard Sales & Marketing role is the quickest option. The user also needs an active organization membership, a current base license, and the appropriate sales territories.
The role controls which CRM workspaces, objects, Skills, Agents, reports, and dashboards the user may use. Territory assignments control which CRM records the user may see. These controls work together: a user may see the Sales menu but see no records when no matching territory has been assigned.
Before you begin
You must be an organization Owner or Admin with access to Configuration. Confirm that:
- The organization subscription is active.
- The user is an active member of the organization.
- The user has a current base license.
- Your organization has defined any territories it intends to use.
Assign the standard Sales & Marketing role
- Open Configuration from the main menu.
- Select Roles & access.
- Select Sales & Marketing from the role list.
- Confirm that the role is active and review its grants.
- Find the user under User assignments.
- Add Sales & Marketing to the user's Roles selection.
- Select one or more Territories for the user.
- Select Save for that user.
Select Restore standard roles if the Sales & Marketing role is unavailable. Restoring standard roles recreates or refreshes the supplied role definitions; it does not remove your custom roles.
What the standard role provides
The standard Sales & Marketing role provides access to:
- The Sales workspace, including Leads, Opportunities, Companies, Contacts, Activities, Campaigns, Campaign Members, and the Sales dashboard.
- The Companies, Contacts workspace.
- Create and update access for Companies, Contacts, Leads, Opportunities, Activities, Campaigns, and Campaign Members.
- Read access to Territories.
- Standard CRM Skills for finding, creating, and updating CRM records.
- Published Agents and sales reports granted to the role.
It also provides access to the top-level Outbound workspace. Outbound connects CRM Campaigns and Portfolios to Apollo sourcing, current intent evidence, immutable personalized email revisions, customer-owned Gmail, Outlook, or SMTP and IMAP mailboxes, reply classification, and promised-deliverable tracking. An administrator must connect the required integrations before a campaign can be activated.
Delete permission is disabled for the standard role. An administrator can change the role's object permissions when the organization wants sales users to delete records.
Assign territories
CRM records are territory-scoped. Assign at least one relevant territory to each sales user when your organization uses territories.
Territories are hierarchical. Assigning a parent territory also grants access to its descendant territories. A user may have several territory assignments, which is useful for regional managers, shared account teams, or temporary coverage.
To create or change the hierarchy:
- Open Configuration.
- Select Territories.
- Create a territory or select an existing territory.
- Choose its parent territory when applicable.
- Save the territory.
- Return to Roles & access and update the user's territory assignments.
Use a custom role instead
You can give CRM access through a custom functional role. Configure all of the following areas on the role:
| Area | Typical CRM grant |
|---|---|
| Menu and workspace access | sales and, when required, companies_contacts |
| Object permissions | Read, create, update, or delete for Companies, Contacts, Leads, Opportunities, Activities, Campaigns, and Campaign Members |
| Skills available directly | The CRM Skills the user may invoke through chat or another direct interaction |
| Agents available | The published Agents the user may run |
| Reports and dashboards | The sales reports the user may open |
A menu grant only makes the workspace available. Object permissions and territory access still determine what the user can do inside it.
Managers, Admins, and Owners
The Manager role does not automatically include Sales access. Assign Sales & Marketing as an additional role, or add the required CRM grants to the organization's Manager role.
Owners and Admins normally have full configuration and CRM access. They still need an active membership, an appropriate current base license, and an active organization subscription.
Skills and Agents
Role Skill grants control which Skills a user may invoke directly, including through Eos Chat. An Agent may use the Skills included in its published process, but the Agent still runs within the current user's record-access boundaries.
For an Agent to appear on a CRM record, the Agent must also be active and published for that object. For example, an Agent published for Companies can appear under Agents on a Company record when the user's role permits that Agent.
Confirm the result
Ask the user to refresh Eos after you save the assignment. The user should see Sales in the main menu and the CRM workspaces granted by the role.
Confirm that the user can:
- Open the Sales workspace.
- See records from an assigned territory.
- Create or edit a permitted CRM record.
- Open a granted report.
- See and run an eligible published Agent from a CRM record.
Campaigns organize coordinated marketing work. Add Leads and Contacts as Campaign Members, update each member's response status, associate originating Leads and influenced Opportunities with the Campaign, and use the supplied Campaign reports to review activity, cost, responses, and pipeline influence.
Troubleshooting
The Sales menu is missing
- Confirm that the user is an active organization member.
- Confirm that the user has a current base license.
- Confirm that Sales & Marketing, or a custom role containing
sales, is assigned and active. - Refresh the application. Sign out and back in if the access state does not refresh.
The Sales workspace opens but records are missing
- Confirm that the user has at least one applicable territory.
- Confirm that the records have the correct Territory value.
- Confirm that the role has read permission for the relevant CRM object.
A user cannot create, edit, or delete a record
- Review the role's object permissions for that operation.
- Remember that the standard Sales & Marketing role does not include delete permission.
- Check for required fields and dependent records when an operation still fails.
An Agent is missing from a record
- Confirm that the Agent is active.
- Confirm that it is published for the current object.
- Confirm that the user's role grants access to the Agent.
- Confirm that the user can read the current record and its related records.
Related areas
- Configuration
- Roles & access
- Territories
- Sales
- Companies, Contacts
- Agents
- Reports
- Member capabilities