Objectives

Objectives are journey goals your agent works toward and tracks — for example booking a demo, starting a trial, or completing onboarding.

When an agent has active objectives, the agent can update their status during conversations. Your product can also sync status through the SDK, and teammates can set account-level progress on the account page.

How objectives work

Objectives are configured per agent on the Objectives tab. Like other agent settings, edits save to the draft and apply to live sessions when you publish the agent. There is no separate feature toggle — publishing active objectives enables the behavior.

Each objective has:

• A name and immutable key (used by the SDK and integrations)
• A description that tells the agent what “done” means
• A level: account (once per company) or person (per contact)
• Optional lifecycle stage and gating
• Optional completion source restrictions

Create an objective

1. Open the agent and select Edit Agent.
2. Open the Objectives tab.
3. Select Add objective.
4. Enter a name. Aimdoc derives the key from the name; after the first save the key cannot change.
5. Write a description that defines completion. Type @ to reference form fields, visitor data, tools, or team members.
6. Choose level, optional stage settings, and completion restrictions.
7. Save the objective, then publish the agent.

Level, stage, and completion

Level

• Account — progress is tracked once for the company or tenant
• Person — progress is tracked separately for each contact

Lifecycle stage

Optionally tie an objective to a lifecycle stage:

• Advisory — guides the agent's focus when the account is in that stage
• Locked — progress cannot be recorded until the account reaches that stage

If you remove a stage that objectives still reference, Aimdoc blocks the deletion until you update those objectives.

Who can mark done

By default any source may mark an objective done. Enable Restrict who can mark this done when a milestone should only be completed by specific sources — for example, events your product reports through the SDK rather than the agent.

Statuses move forward as not started → in_progress → done. The agent only advances status when the conversation gives clear evidence. Signed SDK claims may set any status for keys they are allowed to complete.

Track progress

Open an account to review objective progress for that company. Account-level objectives can be updated manually from the account page. Person-level rows summarize progress across the account's contacts.

Sync from your product

In App Mode, include objective claims on aimdoc.identify when a user completes a milestone in your product. Claims require a signed v4 user_hash. See Identity Verification and SDKs.