IVR: Sound File Step

IVR: Sound File Step

📂 Upload or select a file from the library

The Sound File Step plays an audio file during an IVR call flow, such as a greeting, announcement, or instructional message, before proceeding to the next configured step.


⚙️ Configuration

🔊 Sound File Upload

  • Upload a new audio file or select from the library of previously uploaded files.

  • Supported Formats: .mp3 and .wav.

🔁 Number of Loops

This setting defines how many times the audio file plays before the IVR moves to the next step, considering that the initial play is counted as the first one in the loop.

Example: Setting the number of loops to 3 means the audio file repeats three times before moving to the next step, such as a menu or voicemail.


⏩ Next Steps

After Playing the File, Go To: Specifies the next IVR step after the audio file has played completely.



🗣️ Text-To-Speech Configurations

The Text-to-Speech (TTS) Step converts written text into spoken audio, generating sound files that can be played during the IVR call flow. 

It supports both 

  • Static text (fixed phrases) 

  • Dynamic text based on the variables fetched from your system through API, such as order ID or caller name, etc. 

This step makes the IVR flow more customized and saves a significant amount of time and effort that would have been spent on voice recording. 

⚙️ Configurations


🌐 Language and Voice

  • Language: TTS at Maqsam supports both Arabic and English languages

  • Voice Gender Options: Male and Female voices are supported for the Arabic and English languages. The gender can be selected according to your preference.


📌 Static TTS Message 

  • Static Text: Enter fixed text to be converted to speech.
    Example: "Welcome to our service" generates a consistent greeting.


⏩ Next Steps

  • After playing the sound, go to: Specifies the next IVR step, such as routing to a menu or call forwarding.

🔁 Dynamic TTS Message

  • Dynamic Text: It sends all the caller information to the external system, then fetches the full text from this other external system using an API request, then this text gets converted to voice through Maqsam, and the IVR plays the converted voice to the caller.

    The configuration of the dynamic step is as follows

    1. Select the API method

    2. Enter the API endpoint URL

    3. Add headers if needed

    4. The 'Send call data' box can be checked so that caller data is sent along with the API request.

    5. The expected response is a text that Maqsam will convert to a voice message through the call.

Example: "Hello {caller_name}, your order {order_id} is ready" personalizes messages based on caller data.


⏩ Next Steps

  • After playing the sound, go to: Specifies the next IVR step, such as routing to a menu or call forwarding.

  • If the TTS request fails, go to: In case the dynamic TTS is selected, and the API call, for any reason, fails, the next IVR step is to be configured from here.


    • Related Articles

    • IVR: Menu Step

      ? Overview The Menu Step is an interactive decision point in the IVR call flow, presenting callers with audio-prompted options and routing calls based on their keypad input. Example: A welcome message like "For sales, press 1; for support, press 2" ...
    • IVR: Voicemail Step

      ? Overview The Voicemail Step allows callers to record a voice message that is stored in the system for later review by agents or administrators. ⚙️ Configuration ? Sound File An audio file is played to the caller before recording begins, such as a ...
    • IVR Builder Overview

      ? What is the IVR Builder The IVR (Interactive Voice Response) Builder in Maqsam allows you to create dynamic and customized call flows using a drag-and-drop interface. It provides an intuitive way to automate call handling, route calls based on ...
    • IVR: Call Forwarding Step

      ? Overview The Call Forwarding step routes your incoming calls to agents, groups, or external phone numbers so that callers get help quickly and efficiently. ? Option 1: Forwarding Calls to Agents or Groups ⚙️ Configurations Below are the available ...
    • IVR: Webhook Step

      ? Overview The Webhook Step sends an API request that delivers all call information, such as caller number, agent name, call state, IVR inputs, etc., to an external system. This enables actions like data updates or notifications based on the IVR ...