Using the ivrType ‘group’, Alerting Hub enables a select number of recipients to be called and placed in a conference call.
The group IVR plays the main message and waits for a PIN to be entered. If the PIN is wrong then a badpin message is played and the IVR repeats. When a good PIN is entered then a final message is played, after which the recipient is placed into the group conference. PINs are used to ensure that there is actually a person on the end of the call (to avoid voicemail and so forth). PINs are specified as part of the ivr setup (see below) and can be as simple as ‘*’ to denote any key press. To use the group IVR you must include additionalContent with the following contentTags (the main message is provided by the normal content/storedContent items in the alert JSON):
- badpin – played to the caller if their PIN is incorrect
- enter – played to the caller just before they enter the group call after entering a good PIN
|ivrAttempts||Optional||1||Number of times the call will be attempted, if the call is not placed into the group call.|
|ivrPin||Optional||*||Specifies the PIN that the recipient must enter to be allowed into the group call. A single * (star) means any key and can be used to simply ensure the recipient is actually present.|
|ivrNoPinAttempts||Optional||1||The number of times that the recipient will be asked for a PIN without any key presses being received.|
|ivrBadPinAttempts||Optional||1||The number of times that the recipient will be asked for a PIN when they have entered a previous bad PIN.|
See Interactive Voice Response for further options.