stratus-weather-ivr

Contact our Help Desk as we will need to work with you to get calls pointed at your Web responder. Include the following information:

Subject: Web Responder
The web URL of your Responder.
Instructions to route calls to it ( DID, IVR Option, Internal Dial Code ).

Our Stratus platform has the possibility to use "Web Responders".

For instance, if someone dials into a DID on our system, we can cause that call to interact with your web server via HTTP/S API calls. This sample queries a web API for weather data but it is not limited to just that. You could use it to query your backend databases, salesforce, or many other systems.

This sample creates a Web Responder for our Stratus platform that:

Causes Stratus to play an announcement and wait for a 5 digit US ZIP code.
Queries https://openweathermap.org/ with that ZIP code and gets back the current weather.
Uses Amazon Polly text to speech to create a WAV file of the returned data.
Converts the WAV file to 8khz mono u-law which is required by Stratus.
Causes Stratus to play that WAV file.
Hangs up the call.

Notes:

Requires /usr/bin/mpg123 and /usr/bin/sox to convert the WAV files created by Polly to 8khz mono u-law which is requried by Stratus.
Rename includes/creds.sample.php to includes/creds.php and update it with your keys.

How Stratus Web Responders work:

Stratus will browse your web server and expects to receive XML "verbs" ( i.e. instructions ) and wav files. Stratus will do things based on these instructions. This gives you the ability create IVRs that do all sorts of things.

When Stratus requests to your WebResponder application (inbound or outbound), the URL always contains at least the following parameters:

NmsAni : caller, e.g., "1001"
NmsDnis : callee e.g., "2125551212"
AccountUser : Account User
AccountDomain : Account Domain
AccountLastDial : Last Dialed Digits by the Account User
Digits : Received Digits
OrigCallID : (1-1188b)
TermCallID : (1-1188b)
ToUser : User Part input to the Responder
ToDomain : Domain Part input to the Responder

There are three verbs you can give Stratus:

Play
Gather
Forward

Verbs

All verbs take an "action" attribute. If the "action" attribute is present then control is returned to the URL given by the "action" attribute. If not present then the application ends.

Play

The action plays the given .wav file and posts back to the given action URL. For example,

<Play action='continue.php'>
 http://www.example.com/hello-world.wav
</Play>

This verb plays the .wav file and posts back (i.e., returns control) to continue.php.

To end the call, omit the action parameter.

Gather

The action gathers the given number of DTMF digits and posts back to the given action url, optionally playing the given .wav file. numDigits the number of digits to gather, e.g., '1' (default=20) For example,

<Gather numDigits='3' action='handle-account-number.php'>
 <Play>
  http://www.example.com/what-is-your-account-number.wav
 </Play>
<Gather>

This gathers 3 digits and posts back the relative URL handle-account-number.php?Digits=555. The verb posts back to the given action URL with the following parameters: Digits the gathered digits, for example, 123

Forward

The action forwards to the given destination. The verb does NOT take an "action" parameter. The verb is effectively a "goto". For example,

<Forward>
 2125551212
</Forward>

spectrumvoip / stratus-web-responder-weather