Core Concepts
Understanding Relay's core concepts will help you get the most out of the platform. This guide explains the fundamental building blocks.
Organizations
An Organization is your workspace in Relay. It contains all your tickets, customers, team members, and settings.
Key Points
- Each organization is completely isolated from others
- You can be a member of multiple organizations
- Settings, integrations, and data are organization-specific
- Your organization has a unique slug used in URLs
Organization Settings Include
- Name and branding
- Business hours
- Default timezone
- Custom domain (optional)
Users & Roles
Users are team members who access Relay to handle support.
Roles
| Role | Capabilities |
|---|---|
| Admin | Full access: settings, integrations, user management, billing, plus all agent capabilities |
| Agent | Handle tickets, use AI features, create articles, view analytics |
User Properties
- Name and email
- Avatar
- Role
- Organization membership
Customers
Customers are the people you support. Relay creates and maintains customer profiles automatically.
Customer Sources
- Email senders
- Widget chat visitors
- Shopify customers (synced)
- SMS contacts
- Social media contacts
Customer Profile Includes
- Contact information (name, email, phone)
- All tickets and conversations
- Order history (via Shopify)
- Payment history (via Stripe)
- Timeline of all interactions
Customer Matching
Relay automatically matches customers across channels using:
- Email address (primary)
- Phone number
- Shopify customer ID
- Other integration IDs
Tickets
A Ticket is a customer support request. Tickets are the primary work item in Relay.
Ticket Properties
| Property | Description |
|---|---|
| Number | Auto-incrementing ID (e.g., #1234) |
| Subject | Brief description of the issue |
| Status | Open, Pending, Resolved, Closed |
| Priority | Urgent, High, Normal, Low |
| Type | Question, Bug, Feature Request, Task |
| Assignee | Team member responsible |
| Tags | Categorization labels |
| Channel | Source (email, widget, SMS, etc.) |
Ticket Lifecycle
Created → Open → Pending → Resolved → Closed
↑ ↓
└───────────┘
- Created: Ticket enters the system
- Open: Awaiting agent response
- Pending: Awaiting customer response
- Resolved: Issue addressed
- Closed: Ticket archived
AI-Enhanced Properties
- Summary: AI-generated 2-3 sentence overview
- Sentiment: Positive, Neutral, or Negative
- Suggested Priority: AI-recommended urgency
- Suggested Tags: AI-recommended labels
Conversations
Conversations are the messages within a ticket. They form a threaded discussion.
Conversation Types
| Type | Visibility | Description |
|---|---|---|
| Reply | Customer & Team | Public response to customer |
| Note | Team Only | Internal comment not visible to customer |
| Customer & Team | Email sent/received | |
| SMS | Customer & Team | Text message sent/received |
Conversation Properties
- Author (agent or customer)
- Timestamp
- Content (rich text)
- Attachments
- Channel source
Channels
Channels are the communication methods customers use to reach you.
Supported Channels
| Channel | Description |
|---|---|
| Traditional email support | |
| Widget | Embedded chat on your website |
| Slack | Messages from Slack |
| SMS | Text messages via Twilio |
| WhatsApp Business messages | |
| Messenger | Facebook Messenger |
Channel Routing
All channels route to the same unified inbox. Each ticket shows its source channel, and replies go back through the same channel.
Knowledge Base
The Knowledge Base (KB) is your self-service help content.
Components
| Component | Description |
|---|---|
| Articles | Individual help documents |
| Collections | Groups of related articles |
| Help Center | Public-facing KB website |
Article Workflow
Draft → In Review → Published
How KB Helps
- Customers find answers themselves
- AI suggests relevant articles to agents
- Reduces repetitive ticket volume
Integrations
Integrations connect Relay to your other business tools.
Integration Types
| Type | Examples | Purpose |
|---|---|---|
| Communication | Email, Slack, SMS | Receive/send messages |
| E-commerce | Shopify | Customer and order context |
| Payments | Stripe | Payment and refund info |
| Migration | Zendesk, Freshdesk | Import existing data |
Automations
Automations are rules that perform actions automatically.
Automation Components
-
Trigger: What starts the automation
- Ticket created
- Ticket updated
- Time elapsed
-
Conditions: When the automation should run
- Priority equals "Urgent"
- Tags contain "billing"
-
Actions: What happens
- Assign to agent
- Add tag
- Send notification
SLAs
Service Level Agreements (SLAs) define response time expectations.
SLA Components
| Component | Description |
|---|---|
| Policy | Rules defining target times |
| First Response | Time to first agent reply |
| Resolution | Time to ticket resolution |
| Business Hours | When SLA timer runs |
SLA Status
- On Track: Within target time
- Warning: Approaching deadline
- Breached: Exceeded target time
Key Relationships
Organization
├── Users (team members)
├── Customers (people you support)
├── Tickets (support requests)
│ └── Conversations (messages)
├── Articles (help content)
│ └── Collections (article groups)
├── Integrations (connected tools)
├── Automations (workflow rules)
└── SLA Policies (response targets)
Next Steps
Now that you understand the core concepts: