B.62. mailboxExists()

B.62. `mailboxExists()`

Checks to see if the specified voicemail box exists.

mailboxExists(mailbox[@context][,options])

Checks to see if the voicemail box defined in mailbox exists. A voicemail context may be specified if the mailbox being checked is not in the default context.

Sets the channel variable VMBOXEXISTSSTATUS to SUCCESS (mailbox found) or FAILED (mailbox not found).

Option j enables jumping to priority n+101 on success.

exten => 123,1,Answer()
exten => 123,n,mailboxExists(123@default)
exten => 123,n,Goto(box-${VMBOXEXISTSSTATUS})
exten => 123,10(box-SUCCESS),Voicemail(123,u)
exten => 123,20(box-FAILED),Playback(sorry)

Note

Internal help for this application in Asterisk 1.4:

  -= Info about application 'mailboxExists' =- 

[Synopsis]
Check to see if Voicemail mailbox exists

[Description]
  mailboxExists(mailbox[@context][|options]): Check to see if the specified
mailbox exists. If no voicemail context is specified, the 'default' context
will be used.
  This application will set the following channel variable upon completion:
    VMBOXEXISTSSTATUS - This will contain the status of the execution of the
                        mailboxExists application. Possible values include:
                        SUCCESS | FAILED

  Options:
    j - Jump to priority n+101 if the mailbox is found.

diff output to internal help in Asterisk 1.2:

- none -

See also

Section C.57, “VMCOUNT()”