Skip to main content

Smart Call Flow Action Reference

What each Smart Call Flow action needs to save, its options, limits and branches.

A
Written by Aaron Sundukovskiy

This reference covers every action you can add in the Smart Call Flow builder: what it does, what's required to save it, what's optional, and its limits. To open the builder, save, and publish your flow, see Salesmsg Smart Call Flow.


Ring (Call Distribution)

Routes an incoming call to inbox members using a chosen distribution method.

Required to save

  • A distribution method

  • Team members selected (for simultaneously, round robin, or linear round robin)

Optional

  • Ring duration: 10 to 60 seconds, in 5-second steps (default: 30 seconds)

Distribution methods

  • Simultaneously (default)

  • Round robin

  • Linear round robin

  • Salesmsg group: contact owner

  • Salesmsg group: conversation assignee

  • HubSpot group: contact owner, deal owner + custom properties

How each method rings

  • Simultaneously: all selected members ring at the same time.

  • Round robin: one member rings per call, taking turns. The next call starts with the next member in the list.

  • Linear round robin: the selected members ring one after another during the same call, until someone answers or every member has been tried.

  • HubSpot group: uses a HubSpot property that holds a HubSpot user, such as the contact owner or deal owner, and rings the Salesmsg member linked to that HubSpot user. HubSpot must be connected. If it's disconnected, Ring actions tied to HubSpot are paused until you reconnect.

Limits

  • Simultaneous ringing caps at 10 members, or you can select the Auto · 10 inbox members option instead of picking individuals. These two options are mutually exclusive.

  • Round robin and linear round robin have no member limit.

  • Member selection only applies to simultaneously, round robin, and linear round robin.

  • Members are excluded from distribution if they've set an away status, muted the inbox, or aren't in the specified member list.

  • Call forwarding and IVR/Call Queue configurations take precedence over call distribution when they're active elsewhere in the flow.

  • Aircall numbers can't use Ring.

  • You can add any number of Ring actions to a flow, and you can't delete just one branch. Deleting a Ring action removes both branches and everything under them (with a confirmation modal).

Automatic branching Adding Ring automatically creates an "if call is not answered" sub-action, defaulted to Send to Voicemail. Click it to replace with any compatible action.


Send to voicemail

Sends the caller to voicemail with a recorded, uploaded, or text-to-speech greeting.

Required to save

  • An audio file (record, upload, or generate via text-to-speech). You can't save this action without one.

Optional

  • Get voicemail via email toggle (default: off). Only appears after you've added audio. When on, voicemail recordings go to your email.

Limits

  • Recordings cap at 3 minutes; recording stops automatically at that mark.

  • Uploads must be MP3 or WAV, 10MB or smaller, 3 minutes or shorter.

  • You can't chain two voicemail actions back to back.


Play audio

Plays a message, announcement, or hold music at a specific point in the flow.

Required to save

  • An audio file (record, upload, or text-to-speech)

Optional

  • A custom name for the audio file (auto-generated for text-to-speech; required when recording or uploading)

Audio options

Method

Details

Record

Records directly in your browser via microphone. Caps at 3 minutes; stops automatically at that mark. Preview before saving. Filename required.

Upload

MP3 or WAV only, 10MB max, 3 minutes max. Files outside these limits are rejected with a toast error.

Text-to-speech

Type your message, pick a voice (basic, premium, or custom), preview with Play, then save. Both message text and filename are required.

Library management All saved audio lives in a reusable library across your call flows. From there you can play/pause, search by name, and use the three-dot menu to preview, download, rename, or delete a file.


IVR phone tree

Lets callers press a key to route themselves to the right destination.

Required to save

  • A greeting message (record, upload, or text-to-speech)

  • At least 1 menu option (key assignment)

Optional

  • Additional menu options, up to the 10-key limit

  • A custom branch name per key (doesn't need to be unique, just non-empty)

Limits

  • Maximum 26 menu options - 0-25.

    • When any key above 9 is configured, the system automatically collects up to 2 digits from the caller.

    • For menus that include two-digit options, callers selecting a single-digit key must either press # to route immediately or wait for a 5-second timeout.

  • Only 1 level deep. No sub-menus.

  • Each key can only be used once; duplicates aren't allowed. Once all options are used, the Add button disables.

  • Deleting a menu option frees up that key again.

  • You can have up to 2 IVR configurations in a flow, with business hours logic determining which one activates.

  • Aircall numbers can't use IVR.

  • A "no selection" branch is included by default and defaults to Send to Voicemail; this branch can't be deleted independently (every other branch can).

Note: if you add IVR before an existing chain of actions, everything that was already there gets wrapped inside the IVR tree.


Forward call

Routes the incoming call to an external number or another Salesmsg inbox.

Required to save

  • Destination: either an external number (validated in real time) or a Salesmsg inbox + number

Optional

  • Extension number (external number destinations only)

  • Call whisper toggle: plays a message to the person answering before connecting the call. When enabled, you must enter open text; only Salesmsg merge fields can be inserted.

  • Call screening toggle

Limits

  • Aircall numbers can't use call forwarding.

  • Blocked contacts are automatically filtered out.

  • If the inbox has a single number, you configure forwarding directly in the sidebar. If it's a smart inbox with 2+ numbers, you configure forwarding per number in a dedicated modal.


Call queue

Routes callers into a queue for all inbox members, with a greeting they hear while waiting. Call Queue splits into Call is answered and Call is not answered branches, so you can set different next steps depending on how the call ends.

Required to save

  • Greeting music

  • Greeting message

Both are required before you can save the action.

Optional

  • Audio can be record, upload, or text-to-speech, same controls and limits as Play Audio and IVR (3-minute cap, MP3/WAV ≤10MB for uploads).

Automatic branching

  • Call is answered: only post-call actions run here, such as Send SMS or an AI Texting Agent

  • Call is not answered: the call goes to Send to Voicemail by default, then any post-call actions run from there. Click the branch to replace the default with a compatible action

If your inbox already had a missed call follow-up SMS configured, it now lives under the Call is not answered branch automatically. Existing queues were migrated to reflect this, so you don't need to recreate anything.

Limits

  • Aircall numbers are excluded from queue.

  • Configuration priority relative to other routing actions: Call Forwarding, then IVR, then Call Queue, then Call Distribution (Ring), then Voicemail.

  • You can't delete just one branch. Deleting the Call Queue action removes both branches and everything under them.


Send SMS

Sends an automated text message at a specific point in the flow. This is a post-call action, not an in-call one.

Required to save

  • A message. You can't save an empty message; the field highlights red if you try.

Optional

  • Inbox to send from (defaults to the current inbox, but you can pick another and its number)

  • Any message box feature: attachments, merge fields, saved replies, emojis, AI, meetings, link shortening

Limits

  • Must be placed only after the "Call ends" node. It's a post-call action.

  • Exception: Send SMS can be the only action inside an IVR or Business Hours branch.

  • Blocked and opted-out contacts are automatically filtered out before sending.

  • Sends immediately once the flow reaches that step.


Business hours

Splits the flow into two branches based on whether the call comes in during or outside your configured business hours.

Required to save

  • Business hours must already be configured and enabled in account settings. The action isn't available otherwise.

Optional / defaults

  • "During hours" branch defaults to Ring (replaceable)

  • "After hours" branch defaults to Voicemail (replaceable)

Limits

  • Only one Business Hours action allowed per call flow.

  • The out-of-office message configured in Business Hours settings applies to messaging only. Calling behavior follows whatever you build in this branch.

  • Deleting the whole action removes both branches. Deleting an individual branch action removes just that action and anything under it, except the "After hours" branch itself can't be deleted independently.

  • If your account's business hours are disabled, the action shows a validation error on canvas until you enable them (a banner links out to the Business Hours settings page in a new tab).

Note: adding Business Hours before an existing chain of actions wraps everything already there inside the Business Hours tree.


AI calling agent

Places an AI voice agent in the flow to handle the call.

Required to save

  • Either an existing active agent selected from the dropdown, or a new agent built from scratch with:

    • A starting template (default: Custom; exactly one must be selected)

    • Agent name: text, 50 characters max, must be non-empty and unique

    • A greeting message (pre-filled by template, editable)

    • Behavioral instructions (the main prompt the agent follows during calls, rich text with merge fields)

Optional

  • Escalate to human toggle (default: off). When on, the AI forwards the caller to a live agent in the inbox if it can't handle the request. When off, the AI handles the entire call with no transfer option.

  • AI knowledge base toggle (default: off). When on, select which documents the agent can reference (individual files or "All files"). A "Go to knowledge base" link opens the knowledge base page in a new tab. If the toggle is on but no documents are selected, the knowledge base has no effect.

  • Test Agent: available at any point during configuration, before saving or activating.

Limits

  • Aircall numbers can't use AI Calling Agent (same restriction as Call Queue, Distribution, and Forwarding).

  • Configuration priority relative to other routing actions: Call Forwarding, then IVR, then Call Queue, then Call Distribution, then AI Calling Agent, then Voicemail.


AI texting agent

Places an AI text agent in the flow to handle SMS conversations, typically as a post-call action.

Required to save

  • An existing active agent, selected from a dropdown

Optional

  • Inbox to use (pre-fills from the agent's settings if one exists there; you can pick another)

  • Environment validation checkbox (default: off)

Limits

  • Configuration priority relative to other routing actions: Call Forwarding, then IVR, then Call Queue, then Call Distribution, then Voicemail.


Frequently Asked Questions

Why is Send SMS only available after "Call ends"?

Send SMS and AI Texting Agent are post-call actions. They don't require an active call, so they live after the flow's "Call ends" node, with one exception: either can be the only action inside an IVR or Business Hours branch.

Where did the old Call Distribution settings go?

Call Distribution is now the Ring action in Smart Call Flow. Ring groups are Ring actions, and the next step for an unanswered call is set in the Ring action's Call is not answered branch.


Related Articles


Need Help? ✋🏻

Contact us on live chat or send an email to us at [email protected].

Did this answer your question?