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

Go to Orchestrations

Navigate to Orchestrations in your dashboard sidebar.

Click 'Create New'

Start building a new orchestration rule.

Set conditions

Define when this orchestration should trigger.

Add actions

Specify what should happen when conditions are met.

Save and enable

Save your orchestration and toggle it on.

Condition Types

Page Conditions

Trigger based on where the visitor is:

ConditionDescription
URL ContainsPage URL includes specific text
URL EqualsExact URL match
URL Starts WithURL begins with path

Examples:

  • url_contains: /pricing β€” Trigger on pricing pages
  • url_equals: /checkout β€” Only on checkout page
  • url_starts_with: /products/ β€” All product pages

Visitor Conditions

Trigger based on visitor behavior:

ConditionDescription
Time on PageSeconds visitor has been on page
Returning VisitorVisitor has been here before
New VisitorFirst-time visitor

Intent Conditions

Trigger based on what the visitor says:

ConditionDescription
Message ContainsChat message includes keywords

Examples:

  • message_contains: cancel β€” Detect cancellation intent
  • message_contains: refund β€” Detect refund requests
  • message_contains: speak to human β€” Manual escalation request

Language Conditions

ConditionDescription
Browser LanguageVisitor's browser language setting

Campaign Conditions

ConditionDescription
Referrer ContainsTraffic source URL
UTM ParameterSpecific UTM tag value

Action Types

Routing Actions

ActionDescription
Escalate to HumanImmediately transfer to human agent
Notify TeamSend alert to team (doesn't transfer)
Transfer PersonaSwitch to different AI persona

AI Behavior Actions

ActionDescription
Switch ToneChange AI communication style
Send GreetingSend a specific message
Ask Follow-upPrompt for more information
Ask for EmailRequest visitor's email
Send LinkShare a URL with visitor
Trigger InstructionsApply custom AI instructions

UI Actions

ActionDescription
Open Widget TabOpen specific widget section
Push URLNavigate visitor to new page
Show SuggestionDisplay 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:

  1. First orchestration matches and runs
  2. Sets "next orchestration" in action
  3. 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

ToneDescription
FriendlyWarm and approachable
ProfessionalBusiness-appropriate
CasualRelaxed and informal
FormalVery proper language
ConciseShort, direct answers
DetailedComprehensive explanations
EmpatheticUnderstanding and supportive
DirectiveAction-oriented guidance

Persona Options

PersonaBest For
SupportHelp desk and troubleshooting
SalesPricing questions and upselling
GuideTutorials and onboarding
NeutralGeneral assistance
TechnicalDeveloper/technical queries
FriendlyCasual 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:

  1. Create the orchestration in disabled state
  2. Open Test AI in a new tab
  3. Simulate the conditions
  4. Verify the actions trigger correctly
  5. Enable when confident

Best Practices

  1. Start simple β€” Begin with a few key rules
  2. Use clear names β€” Describe what the rule does
  3. Set appropriate priorities β€” Avoid conflicts
  4. Test thoroughly β€” Check all condition combinations
  5. Monitor results β€” Review in analytics

Next Steps

Was this helpful?