A voicemail box item sends the caller to the voicemail box of an employee - either to leave a message, or to listen to the messages and configure the voicemail.

The voicemail box belongs to the employee currently on the selected extension, so it follows hotdesking. When listening, the caller can instead be asked to enter the extension number (askForExtension), which makes the item a number the employees can call from any phone to reach their voicemail. If no extension is selected, or the extension has no employee, the caller is told that voicemail is not enabled.

Listening always requires the employee's pincode - also when the employee calls from their own phone. If the call variable pin holds the correct pincode, for example set with a Set value item or by a URL router earlier in the call, the caller is let straight in. Otherwise the caller is asked to enter it. A wrong pin counts as a wrong pincode, and after 5 wrong pincodes the voicemail box is locked for 15 minutes. The value of the call variable pin is never shown in realtime events or API responses - it is shown as ****.

This request will create a voicemail box. All properties are optional except for customer and name. An item without an extension tells callers that voicemail is not enabled until one is selected.

{
  customer: '12345678901234567890ABCD',
  name: 'Aflyt telefonsvarer',
  number: '8888',
  mode: 'LISTEN',
  askForExtension: true,
  x: 123,
  y: 456
}

{
  _id: '12345678901234567890FEED',
  type: 'VOICEMAIL_BOX',
  customer: '12345678901234567890ABCD',
  name: 'Aflyt telefonsvarer',
  number: '8888',
  startAudio: null,
  redirect: '',
  notes: '',
  mode: 'LISTEN',
  extension: null,
  askForExtension: true,
  x: 123,
  y: 456
}