System requirements: SIP gateway




The SIP gateway must support SIP INFO for the exchange of DTMF tones between the PBX and the BlackBerry Mobile Voice System.


Your organization's SIP gateway must be able to perform the following actions:

  • Detect and intercept DTMF tones from the cellular call leg between the PBX and BlackBerry devices
  • Notify the BlackBerry MVS Server of the DTMF tones using SIP INFO notification
  • Emit DTMF tones into the audio path when the BlackBerry MVS requests them
  • Send DTMF tones that are at least 100 milliseconds in duration to devices

SIP trunk

The BlackBerry MVS requires that a SIP trunk be connected to the SIP gateway so that the SIP gateway can send calls to the mobile numbers on devices. When you configure the SIP trunk, you must provide the IP address and port number of the MVS Session Manager.

If you configure the BlackBerry MVS for high availability, you must configure a SIP trunk on each MVS Session Manager.

Call routing patterns for internal numbers and external numbers

The phone numbers that the BlackBerry MVS sends to the PBX are E.164 formatted numbers and might not contain leading digits to indicate how the PBX should route the call. You might need to configure the PBX so that the call routing patterns add or remove leading digits for routing to internal numbers or external numbers. For example, you should consider creating the following call routing patterns:

  • One that permits BlackBerry MVS users to make calls from the call log or contact list on their devices without adding 9 before a phone number
  • One that removes an NDD number from phone numbers that are dialed from devices if the BlackBerry MVS user is in the same geographic location as the PBX. The PBX should be configured to manage calls from devices if the user types (519) 555-0100 or (1) (519) 555-0100.
  • One for regions or countries that your organization's users frequently travel to

Ensure the Class of Service setting of "User may change the mobile phone number" is checked. When your organization's users are roaming internationally, it might be necessary for the users to manually change the mobile number on their SIM-unlocked devices to reflect what the PBX must dial to contact the user. For example, if the user is from the United Kingdom the mobile number on the user's device should be changed to include the IDD (00), the home country code (44), and the user's area code and local phone number. For more information on changing the mobile phone number on the device, visit to read article KB17940.

DID/DDI number

To configure device-initiated calling, you must configure your organization's call routing patterns so that the PBX can route the device-initiated calls that use a DID/DDI number through the SIP Gateway, so the SIP Gateway can translate DTMF authentication into SIP INFO messages, to the MVS Session Manager that is associated with the DID/DDI number. For example, if the DID/DDI number that you configure in the MVS Console for the MVS Session Manager is +15195550100, for any device-initiated calls that arrive at the PBX using a DID/DDI number of +15195550100, the PBX must route the calls to the MVS Session Manager that is associated with the DID/DDI number of +15195550100.

You require one DID/DDI number for each MVS Session Manager in your organization’s environment.

High availability

If your organization has configured the BlackBerry MVS for high availability, on the SIP gateway, you should configure the following parameters:

  • In a proxy sets table, configure the two IP addresses of the computers that host the two MVS Session Manager instances
  • A keep alive time of 60 seconds
  • The options parameter. The SIP gateway uses this parameter to ping the active MVS Session Manager every 60 seconds. If the SIP gateway does not receive a response to the ping, it will start to route calls to the standby MVS Session Manager.
Next topic: Glossary

Was this information helpful? Send us your comments.