This page describes the language of a scenario: branches, expressions, variables, conditions, goto and defaults. New to Callr Actions? Start with the Introduction. The parameters, results and examples of each action are in Actions.

ℹ️

Tip

We recommend using the Callr Console to create your Callr Actions scenarios. It features a built-in code editor with autocomplete, inline documentation, and live testing to help you build faster.

Architecture

Call flows in Callr Actions are organized around branches – sequences of actions that determine your call’s behavior. There are four special branches:

• inbound-call: The entry point for an Inbound Call.
• inbound-sms: The entry point for an Inbound SMS.
• api-initiated: The entry point for actions triggered via the API.
• hangup: Executed for Inbound Calls once the call is hung up.

You can also create additional branches to organize your logic. To jump between branches, use the built-in goto statement:

branches:
  inbound-call:
    actions:
      - # your initial actions...
      - if: '!$dial.ok'
        goto:
          branch: voicemail
          
  voicemail:
    actions:
      - action: play@v3
        params:
          tts:
            text: Sorry, we are not available at the moment.

Expressions

Expressions, enclosed in double curly braces ${{ expression }}, can be used in any params object. They are evaluated at runtime using a modern JavaScript engine.

- action: play@v3
  params:
    tts:
      text: Hello! Your number is ${{ call.fromNumber }}.

- action: play@v3
  params:
    tts:
      text: >
        I know that 1 + 1 equals ${{ 1+1 }}

- action: play@v3
  params:
    tts:
      text: >
        Your ticket ID is ${{ $ticketID.split('').join(' ') }}

User-defined variables

You can define your own variables to use in expressions. These variables must start with a dollar sign and be valid JavaScript identifiers. The variable type is inferred from the value and preserved when used in expressions.

variables:
  $errorCode: 0 # an int
  $pi: 3.14159265359 # a float
  $user: # an object
    name: John # a string
    age: 42 # an int
  $list: # an array
    - apples
    - oranges

For example, you can reference these variables in a branch:

branches:
  inbound-call:
    actions:
      - action: play@v3
        params:
          tts:
            text: >
              Hello ${{ $user.name }}!
              You look like you are ${{ $user.age/2 }} years old!

Conditions

Use the if statement to conditionally execute actions. Conditions are expressions evaluated with a modern JavaScript engine.

- if: call.fromNumber.match(/^\+33/)
  action: play@v3
  params:
    tts:
      text: Bonjour. Comment allez-vous?
      language: fr-FR

For multiple actions under one condition, use the if-then structure:

- if: call.fromNumber == '+33199004242'
  then:
    - action: play@v3
      params:
        tts:
          text: Hello boss!
    - action: play@v3
      params:
        tts:
          text: How are you today?
    - action: play@v3
      params:
        tts:
          text: See you later!
    - action: hangup@v1

Goto & Labels

The goto lets you jump to another branch or a specific label within a branch. This is useful for looping or branching logic.

compat:
  version: "2025-09-01"

branches:
  inbound-call:
    actions:
      - label: gather # Define a label
        action: gather@v4
        params:
          maxDigits: 1
          tts:
            text: Hello! Press 1 to accept the call
        result: $digits

      - if: $digits.input == '1'
        goto:
          branch: accept # Jump to a different branch

      - action: play@v3
        params:
          tts:
            text: >
              Sorry, I didn't get your answer.

      - goto:
          label: gather # Jump back to the label

  accept: # New branch defined here
    actions:
      - action: play@v3
        params:
          tts:
            text: >
              OK! I'm going to connect you to the other party.
      - action: bridge@v3

Defaults

Defaults allow you to define common behavior at the top level of your scenario or for specific branches. These values can be overridden by branch-level defaults.

compat:
  version: "2025-09-01"

defaults:
  language: en-US        # Default language for speech (TTS/STT)
  voice: en-US-Ava:DragonHDLatest # Default voice for TTS
  autoAnswer: true       # If false, you need to use answer@v1

branches:
  voicemail:
    defaults:
      language: en-GB    # the voicemail uses a British accent
    actions:
      - action: play@v3
        params:
          tts:
            text: Sorry, we are not available at the moment.

List of actions

Each action has its own page with its parameters, its result and examples: click its name, or browse them by family in Actions.

Older versions

Older versions keep working in existing scenarios. Use the current version in new scenarios:

Templates

Complete scenarios to copy, also available in the template gallery of the Callr Console. Browse them all in Templates:

• Route calls: call forwarding, phone menus, opening hours, call screening, AI intent routing
• Never miss a call: voicemail with transcription, missed-call SMS
• AI agents: AI receptionist, outbound AI agent, voice AI over SIP, AI SMS agent
• Call data: recording, transcription and AI summaries
• Connect people: click-to-call, conference rooms, number masking
• Reminders & alerts: appointment reminders, voice OTP, alert escalation
• SMS: SMS auto-reply, links by SMS during a call
• Call tracking: tracking per campaign, advanced call tracking
• Integrations: your API, Salesforce, your own ElevenLabs voice