Configuration map
Workspace profile
Customer-facing identity, workspace defaults, and visible company details.
Members and roles
Access for operators, admins, technical reviewers, and workspace owners.
Tags
Lightweight labels for triage, issue grouping, and workflow reporting.
Custom fields
Structured customer and conversation context for operators and the agent.
Macros
Reusable replies and ticket actions for common support workflows.
Automations
Rules that tag, route, delay, or annotate conversations and issues.
Workspace profile
Use the workspace profile for the company identity customers and operators will recognize. Keep names and labels clean. Avoid internal project names unless customers already know them. Review:- Workspace name.
- Company display details.
- Default support behavior.
- Notification and channel defaults.
- Any customer-facing wording used by the widget or outbound messages.
Members and roles
Invite teammates based on what they need to do.| Role pattern | Typical access | Good fit |
|---|---|---|
| Operator | Inbox, replies, notes, tags, and issue handling. | Support teammates working customer conversations. |
| Admin | Workspace settings, integrations, sources, members, and permissions. | Support leads and workspace owners. |
| Technical reviewer | API Context, agent testing, and source review. | Developer relations, engineering, or API support leads. |
| Viewer | Read-only context where appropriate. | Stakeholders who need visibility without operational access. |
Tags
Tags are quick labels. Use them for triage and grouping, not as a substitute for structured fields. Good tags are:- Short.
- Stable.
- Action-oriented.
- Easy to understand in a queue.
- Free of secrets or sensitive customer data.
| Tag | Use when |
|---|---|
auth | The customer is blocked by authentication or token behavior. |
billing | The issue involves billing, plan limits, or invoices. |
bug | The conversation likely represents a product defect. |
needs-engineering | Support needs engineering help before responding. |
waiting-on-customer | The team needs more details from the customer. |
Custom fields
Custom fields capture structured context on customers and conversations. Use them when operators need the same detail repeatedly. Common fields:- Account ID.
- Plan.
- Environment.
- API version.
- Region.
- Priority.
- Product area.
- Integration type.
AI-suggested custom field values are context hints. Endpoint, auth, schema, request, and response claims still need to come from API Context evidence.
Macros
Macros help operators reply consistently and take repeatable actions. Use macros for:- Asking for request IDs, timestamps, or environment details.
- Explaining how to generate API keys.
- Confirming escalation to engineering.
- Sharing a verified workaround.
- Closing a resolved conversation.
Automations
Automations are best for simple, visible workflow actions. Start narrow and review the results before expanding.Pick a clear event
Choose a kickoff event your team understands, such as a new conversation, a changed status, or an issue creation.
Add narrow conditions
Match clear text, channel, status, tag, priority, or field values. Avoid broad rules that catch unrelated work.
Choose safe actions
Start with tagging, routing, notes, or status updates before using more complex flows.
Internal notes
Private notes are for operator-only context. Use them for investigation state, escalation details, reproduction notes, and internal links. Do not store:- API keys.
- Passwords.
- OAuth tokens.
- Session cookies.
- Private signing keys.
- Customer-private data from unrelated accounts.
Readiness checklist
People
People
Members have appropriate roles, stale access has been removed, and operators know when to escalate.
Data model
Data model
Tags and custom fields cover your common support scenarios without collecting unnecessary sensitive data.
Operator workflow
Operator workflow
Macros are reviewed, private-note expectations are clear, and issue handoff is understood.
Automation
Automation
Automations are narrow, tested, and limited to decisions your team is comfortable delegating.
