Orchestrations
Create automated rules that control how your AI behaves in different situations.
Orchestrations are powerful rules that automate AI behavior based on conditions. Think of them as "if this, then that" for your chat.
What Are Orchestrations?
Orchestrations let you:
- Route conversations to the right team or person
- Change AI behavior based on context
- Automate actions like collecting emails
- Customize responses for specific scenarios
Well-designed orchestrations can handle complex scenarios automatically, reducing the workload on your team.
Creating an Orchestration
Navigate to Orchestrations in your dashboard sidebar.
Start building a new orchestration rule.
Define when this orchestration should trigger.
Specify what should happen when conditions are met.
Save your orchestration and toggle it on.
Condition Types
Page Conditions
Trigger based on where the visitor is:
| Condition | Description |
|---|---|
| URL Contains | Page URL includes specific text |
| URL Equals | Exact URL match |
| URL Starts With | URL begins with path |
Examples:
url_contains: /pricingβ Trigger on pricing pagesurl_equals: /checkoutβ Only on checkout pageurl_starts_with: /products/β All product pages
Visitor Conditions
Trigger based on visitor behavior:
| Condition | Description |
|---|---|
| Time on Page | Seconds visitor has been on page |
| Returning Visitor | Visitor has been here before |
| New Visitor | First-time visitor |
Intent Conditions
Trigger based on what the visitor says:
| Condition | Description |
|---|---|
| Message Contains | Chat message includes keywords |
Examples:
message_contains: cancelβ Detect cancellation intentmessage_contains: refundβ Detect refund requestsmessage_contains: speak to humanβ Manual escalation request
Language Conditions
| Condition | Description |
|---|---|
| Browser Language | Visitor's browser language setting |
Campaign Conditions
| Condition | Description |
|---|---|
| Referrer Contains | Traffic source URL |
| UTM Parameter | Specific UTM tag value |
Action Types
Routing Actions
| Action | Description |
|---|---|
| Escalate to Human | Immediately transfer to human agent |
| Notify Team | Send alert to team (doesn't transfer) |
| Transfer Persona | Switch to different AI persona |
AI Behavior Actions
| Action | Description |
|---|---|
| Switch Tone | Change AI communication style |
| Send Greeting | Send a specific message |
| Ask Follow-up | Prompt for more information |
| Ask for Email | Request visitor's email |
| Send Link | Share a URL with visitor |
| Trigger Instructions | Apply custom AI instructions |
UI Actions
| Action | Description |
|---|---|
| Open Widget Tab | Open specific widget section |
| Push URL | Navigate visitor to new page |
| Show Suggestion | Display quick reply buttons |
Common Orchestration Patterns
Pricing Page Assistance
When visitors are on pricing:
Conditions:
- URL contains
/pricing - Time on page > 30 seconds
Actions:
- Send greeting: "Have questions about our plans?"
- Transfer persona:
sales
Cancellation Prevention
When someone wants to cancel:
Conditions:
- Message contains:
cancel,cancellation,stop service
Actions:
- Switch tone:
empathetic - Escalate to human
- Notify team
VIP Customer Treatment
For high-value customers:
Conditions:
- UTM parameter:
source=vip
Actions:
- Switch tone:
professional - Send greeting: "Welcome back! How can I assist you today?"
- Transfer persona:
support
After-Hours Support
When team is away:
Conditions:
- New visitor
- (Combined with availability settings)
Actions:
- Ask for email
- Send greeting: "We're away, but leave your email and we'll follow up!"
Product-Specific Help
Different products, different responses:
Conditions:
- URL starts with:
/products/enterprise
Actions:
- Transfer persona:
technical - Trigger instructions: "Focus on enterprise features..."
Orchestration Settings
Priority
When multiple orchestrations could match:
- Higher priority (lower number) runs first
- Set priority 1 for critical rules
- Use 10+ for general rules
Chaining
Orchestrations can trigger other orchestrations:
- First orchestration matches and runs
- Sets "next orchestration" in action
- Second orchestration runs immediately
Global Settings
Set defaults that apply when no orchestration matches:
- Default Tone β Friendly, Professional, Concise, etc.
- Default Persona β Support, Sales, Guide, etc.
- Custom Instructions β Global AI guidelines
Tone Options
| Tone | Description |
|---|---|
| Friendly | Warm and approachable |
| Professional | Business-appropriate |
| Casual | Relaxed and informal |
| Formal | Very proper language |
| Concise | Short, direct answers |
| Detailed | Comprehensive explanations |
| Empathetic | Understanding and supportive |
| Directive | Action-oriented guidance |
Persona Options
| Persona | Best For |
|---|---|
| Support | Help desk and troubleshooting |
| Sales | Pricing questions and upselling |
| Guide | Tutorials and onboarding |
| Neutral | General assistance |
| Technical | Developer/technical queries |
| Friendly | Casual conversations |
Warnings and Conflicts
The system detects:
- Duplicate priorities β Same priority level
- Conflicting conditions β Rules that could interfere
- Unreachable rules β Rules that never trigger
Review warnings in the orchestrations dashboard.
Testing Orchestrations
Before going live:
- Create the orchestration in disabled state
- Open Test AI in a new tab
- Simulate the conditions
- Verify the actions trigger correctly
- Enable when confident
Best Practices
- Start simple β Begin with a few key rules
- Use clear names β Describe what the rule does
- Set appropriate priorities β Avoid conflicts
- Test thoroughly β Check all condition combinations
- Monitor results β Review in analytics
Next Steps
Was this helpful?