This document is for an older version of Kazoo (version 4.3) that is no longer supported. You should upgrade and read the current documentation.

Voicemail

About Voicemail

Puts the caller into the Voicemail system.

Schema

Validator for the Voicemail callflow element

KeyDescriptionTypeDefaultRequiredSupport Level
actionWhether to check voicemail box or compose a new voicemail message`string(‘check''compose’)`composefalse
callerid_match_loginWhether to match the caller ID to a voicemail boxboolean()falsefalse
idThe ID of the voicemail boxstring(32)false
interdigit_timeoutThe amount of time (in milliseconds) to wait for the caller to press the next digit after pressing a digitinteger()2000false
max_message_lengthMax length of the message that caller can leave in voicemail boxinteger()500false
single_mailbox_loginAllow login if caller has a single mailboxboolean()falsefalse
skip_moduleWhen set to true this callflow action is skipped, advancing to the wildcard branch (if any)boolean()false

Checking voicemail

There are a couple ways to create feature codes to check a voicemail box.

Generic voicemail check

{
  "flow":{
    "module":"voicemail"
      ,"data":{
        "action":"check"
      }
    }
  }
  ,"numbers":["*97"]
}

If the calling device has an owner_id and a voicemail box has the same owner_id, that voicemail box will be loaded.

If the voicemail box does not require a pin, the caller will be put into the prompts to check the box.

If the voicemail box does require a pin, the caller will need to enter the pin to access the box.

Generic voicemail check with auto-login

{
  "flow": {
    "module": "voicemail"
    ,"data": {
      "action": "check",
      "single_mailbox_login": true
    }
  }
  ,"numbers": [
    "*98"
  ]
}

If the owner of the device also only owns one voicemail box, they will be logged in automatically to that box (pin rules apply).

Generic voicemail check feature code

{
  "flow": {
    "module": "voicemail"
    ,"data": {
      "action": "check"
    }
  }
  ,"patterns": [
    "\\*98(\\d+)"
  ]
}

If you would like to tie a BLF key to monitor and check a voicemail box, create a pattern (with the literal * escaped as \\*).

For example, to monitor and check box 3456, the BLF key could be tied to *983456. This would then check box 3456 and if the device owner matches the box owner, auto-login would occur (pin rules apply here too).

Note

If you want to do MWI subscriptions, you must configure the account or system to do so. In the callflow system_config document (or the account’s config doc), set dialog_subscribed_mwi_prefix to the prefix (in this above case, *98 would be the value): sup kapps_config set_default callflow dialog_subscribed_mwi_prefix '*98'.