Tech

Server controlled prompts and call flow through IVR

Published on:

March 4, 2025

Vodia's IVR has become even more powerful with JavaScript control, enabling dynamic prompts and call flow adjustments directly from a server. By leveraging HTTP requests, the IVR can fetch responses in real-time, allowing customized greetings, prompts, and call transfers based on caller input. For example, customer codes entered via DTMF can be validated through a server, triggering personalized responses and directing calls to the appropriate destination. This flexibility enhances automation and improves customer interactions, making Vodia’s IVR a highly adaptable and intelligent solution for businesses.

Vodia IVR has become more powerful and intuitive with javascript control and call flow.

Apart from communicating with AI (through voice) and powerful call flow (which is covered in another blog), it can also be used much more flexibly (thanks to javascript) in a variety of other ways. One of them is to control the prompts and call flow from the server.

IVR Setup

To set up a Vodia IVR node to use Javascript, simply choose “Javascript” from the dropdown in the IVR node settings and save. A text area will appear where you can enter your javascript code - if you want to do anything with the call that's connected to this IVR (say from an outside trunk number that ended up in this IVR), use the call object as shown below.

Play prompts from a Server

To play a prompt, you can use Text to Speech in the call object. For example, to greet someone in a call connected to the IVR, simply call the “say” function of the call object:

call.say(“Hi, you have reached company ABC, how may I help you today?”)

The above text will be converted to speech and played for the caller.

Similarly, this text can come from a server in response to an HTTP request based on different situations, e.g., what code (through DTMF) the caller provided as a customer, etc.

HTTP example

Here is how to POST an HTTP request to a server (replace SERVER_UTL with your server url) with a body of some numbers. It accepts a javascript function as a callback, which is called when a response is received from the server with the code, response, and headers - as you can see below. In this example, the response is in JSON format, so it is parsed for the message and the message is played to the caller with call.say(res.message).

  var body = “123456  var args = {
    'method':'POST',
    'url': 'https://SERVER_UTL',
    'header': [ { name: 'Content-Type', value: 'text/plain'} ],
    'callback': callback
  }
  if (body) {
    args.body = body
  }
  system.http(args)

  function callback(code, response, headers) {
    console.log("IVR response:" + code.toString())
    var res = JSON.parse(response)
    if (res.message) call.say(res.message)
  }

Call flow control from a server

When you want to transfer the call connected to the IVR to another extension, group, IVR or anywhere else, simply call the transfer function of the call object with the destination. For example, to transfer to another IVR 87:

call.transfer(“87”)

Similarly, as in the example above, that destination can come from the server as a response to an HTTP request.

A simple example

Let’s say we want to ask the customer to enter a customer code, send it to a server and, if found, give one prompt, followed by a transfer to the customer service department, say account 42. If the code isn't found, a different prompt will be given and followed by a transfer to a different IVR (let's say 70).

'use strict';

call.say('Welcome to company ABC. Please enter your 8 digit customer number.')

var digits = ''
call.dtmf(ondtmf)
function ondtmf(digit) {
  digits += digit
  if (digits.length == 8) {
    send(digits)
    digits = ''
  }
}

function send(digits) {
  var body = digits
  var args = {
    'method':'POST',
    'url': 'https://SERVER_URL',
    'header': [ { name: 'Content-Type', value: 'text/plain'} ],
    'callback': callback
  }
  if (body) {
    args.body = body
  }
  system.http(args)

  function callback(code, response, headers) {
    console.log("IVR response:" + code.toString())
    var res = JSON.parse(response)
    if (res.message) call.say(res.message)
    if (res.transfer) setTimeout(function(){
      call.transfer(res.destination)
    }, 5000)  
  }
}

Of course this is just an example. This can be accmplished in different ways and with proper checks and logs, etc.

The function call.ondtmf() takes a function as callback, which is called every time a digit (DTMF) is pressed with the value of the digit passed as argument. In this example, they are being concatenated into a string and finally sent to the server. In this example, the server responds with a JSON reply with a message (to play out as speech) and a destination (where to transfer the call after playing the message).

So, if the number is found it could return something like this:

{

  “message”:“Thanks Mr. Jones for the number. I will now transfer you to Customer Service.”

  “Destination”:“42”

}

If the number isn't found, it could return something like:

{

  “message”:“Sorry. The number you provided does not exist.”

  “Destination”:“70”

}

When the response is received and parsed, the message is played, then the call is transferred to the destination. The transfer is done after a timeout of 5 seconds (5000 ms) to provide some time for the message to be played out completely before the call is transferred.

if (res.message) call.say(res.message)
if (res.transfer) setTimeout(function(){
  call.transfer(res.destination)
}, 5000)

Vodia's IVR system with JavaScript control provides businesses with enhanced flexibility and power, enabling them to dynamically manage call flow, personalize prompts, and integrate real-time server responses. By leveraging HTTP requests and handling DTMF inputs, the IVR can offer customized interactions, improving overall customer service efficiency. Whether it's verifying customer information or directing calls based on server responses, Vodia’s solution enhances the IVR experience, allowing businesses to create more intelligent, responsive communication systems. For more information, contact us at sales@vodia.com or call +1 (617) 861-3490.

Derniers articles

Voir tous

How the Hospitality Industry Can Exceed Guest Expectations

As hotels prepare for the upcoming travel season, many are rethinking their communication systems to better meet modern guest expectations. Vodia CEO Dr. Christian Stredicke explains how VoIP, AI, and app-based control are key to delivering smarter, more personalized service. Guests now expect mobile-first experiences—whether for check-in, room controls, or contacting hotel staff. Vodia’s customizable communication solutions help hotels automate tasks, streamline operations, and boost guest comfort while reducing costs. With robust security and seamless integration into existing hotel management systems, Vodia enables hotels to move beyond outdated hardware and deliver the connected, high-quality experience today’s travelers demand.

April 23, 2025

Seatrade Cruise Global 2025: Communications Revolution Onboard - What Cruise Experts Need to Know

At Seatrade’s 40th anniversary, Vodia and Lufthansa Industry Solutions showcased the Vodia Maritime Communication Server and the new CruisR World App—purpose-built for next-generation cruise ships and cost-effective retrofits. Key themes at the event included AI-powered language translation, breakthrough satellite connectivity, UC platforms, and advanced emergency protocols. These innovations enable cruise lines to streamline operations, personalize guest experiences, and meet growing expectations for safety and connectivity. As the cruise industry evolves, Vodia’s solutions position communication teams to lead with smarter, more human-centric technology at sea.

April 23, 2025

Christian Stredicke Discusses the Future of AI in Business Communications on the Technology Reseller News Podcast

Vodia CEO Christian Stredicke recently joined Technology Reseller News to discuss how AI is reshaping business communications. With the release of Vodia PBX version 69.5.6, features like real-time OpenAI integration and call transcription via Whisper are setting the stage for voice-driven interactions—replacing complex phone menus with simple spoken commands. Christian emphasized Vodia’s goal of using AI to improve productivity and customer experience, while recognizing the importance of tailoring AI applications to specific industries. He likened today’s AI shift to the early days of the web, where expert guidance is key to successful adoption.

April 3, 2025