Microsoft Visual voicemail

中国移动VVM  http://yyxx.10086.cn/tariff.html?chn=0000

Visual voicemail supports both traditional voicemail (retrieved through a phone call) and visual voicemail. Users can select between traditional voicemail and visual voicemail when they first attempt to access voicemail. If the mobile operator does not support this visual voicemail implementation, the user will only see the traditional voicemail option. For mobile operators that have their own particular brand that they want to use instead of visual voicemail, partners can rebrand all instances of visual voicemail in the Windows 10 Mobile UI to use the operator's brand.

The mobile operator visual voicemail system must be an OMTP-compliant system that meets the following requirements.

• Uses the AMR-NB codec for incoming voicemail messages.
• Sends all SMS-MT as port-directed SMS.
• Sends all SMS-MT with 7-bit default or UCS2 encoding.
• Supports enabling and disabling the visual voicemail feature on the phone by using ACTIVATE and DEACTIVATE SMS-MO messages.

The visual voicemail implementation on the phone is based on the OMTP visual voice mail interface specification. Visual voicemail support on Windows Phone 8.1 was tested on OMTP-based protocols by Comverse and Alcatel Lucent. Other OMTP-based protocols like Streamwide may also be supported, although tests were performed only on Comverse and Alcatel Lucent. Variations from the OMTP standard may result in unsupported scenarios.

The following table shows the extent of support for the features recommended by OMTP. The features marked "Partially supported" provide a button to enable the user to call in to the voicemail system and change the settings over the phone.

Feature recommended by OMTP	Support in Windows Phone
IMAP4 message retrieval	Supported
Local visual voicemail store creation	Supported
Hide visual voicemail store from user	Supported
Display non-audio messages	Not supported
Codec support: AMR 12.2k	Supported
Codec support: WAV g711a	Not supported
Codec support: WAV g711u	Not supported
Codec support: QCELP 13.3k	Not supported
Codec support: EVRC 13.3k	Not supported
Mark incoming visual voicemail messages as \Seen, \Deleted	Supported
Deposit visual voicemail messages	Not supported
Forward visual voicemail messages	Not supported
Set/Change TUI password	Partially supported
Change TUI language	Partially supported
Close New User tutorial	Supported
Query for storage quota status	Not supported
Enable/disable on-demand audio message transcription	Not supported
Store a custom personal greeting	Not supported
Delete a stored custom personal greeting	Not supported
Store a voice signature	Not supported
Enable/disable custom personal greeting	Not supported
Retrieve and store provisioning status and credentials	Supported
Activate and deactivate visual voicemail	Supported

Constraints: None

Instructions

To configure visual voicemail for a mobile operator, the OEM must add setting several settings depending on the OMTP-based protocol being used by the operator.

Note

Visual voicemail settings have already been set for AT&T, T-Mobile USA, and Deutsche Telekom AG (DTAG), and no further configuration is required for these three mobile operators.

1. Create a customization answer file using the contents shown in the following code sample.

   XML

• 
  

<?xml version="1.0" encoding="utf-8" ?>
<ImageCustomizations xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate"
                     Name="VisualVoicemail"
                     Description="Use to configure visual voicemail settings in the phone image."
                     Owner=""
                     OwnerType="OEM">
  <Static>
    <Settings Path="Phone/VoicemailRegistrationTable">
       <!-- The MCCMNC macro allows you to set multiple MCCMNC\VVMMMO pairs.
           The Value stored here will be the key for the Table. -->
      <Setting Name="ProviderRegistration/$(MCCMNC)" Value="" />
      <Setting Name="ProviderRegistration/$(MCCMNC)" Value="" />
    </Settings>
     <!-- The VVMMO is the value stored in the MCCMNC setting. This macro allows you to create multiple table entries. -->
    <Settings Path="Phone/VoicemailRegistrationTable/$(VVMMO)">
      <Setting Name="CLSIDProvider" Value="" />
      <Setting Name="CLSIDAccessor" Value="" />
      <Setting Name="ProtocolVariant" Value="" />
      <Setting Name="IncomingPort" Value="" />
      <Setting Name="ClientType" Value="" />
      <Setting Name="DeviceType" Value="" />
      <Setting Name="InitialSmsDestinationNumber" Value="" />
      <Setting Name="EncryptedSmsSupported" Value="" />
      <Setting Name="KeyData" Value="" />
      <Setting Name="ImapPortOverride" Value="" />
      <Setting Name="TokenLogin" Value="" />
      <Setting Name="SuppressSsl" Value="" />
      <Setting Name="IgnoreLegacyNotifications" Value="" />
      <Setting Name="Branding" Value="" />
    </Settings>  
    <Settings Path="Phone/VoicemailRegistrationTable/$(VVMMO)">
      <Setting Name="CLSIDProvider" Value="" />
      <Setting Name="CLSIDAccessor" Value="" />
      <Setting Name="ProtocolVariant" Value="" />
      <Setting Name="IncomingPort" Value="" />
      <Setting Name="ClientType" Value="" />
      <Setting Name="DeviceType" Value="" />
      <Setting Name="InitialSmsDestinationNumber" Value="" />
      <Setting Name="EncryptedSmsSupported" Value="" />
      <Setting Name="KeyData" Value="" />
      <Setting Name="ImapPortOverride" Value="" />
      <Setting Name="TokenLogin" Value="" />
      <Setting Name="SuppressSsl" Value="" />
      <Setting Name="IgnoreLegacyNotifications" Value="" />
      <Setting Name="Branding" Value="" />
    </Settings>
  </Static>
</ImageCustomizations>

Specify an Owner.

Set multiple MCCMNC\VVMMO pairs by adding the following entry in your customization answer file.

XML

    <Settings Path="Phone/VoicemailRegistrationTable">
      <Setting Name="ProviderRegistration/$(MCCMNC)" Value="" /> 
    </Settings>

1. Replace $(MCCMNC) with the MCCMNC for the mobile operator. For example, 99999.
2. Set the corresponding Value to the name of the VVMMO. For example, Contoso.

3. Add and set as many MCCMNC\VVMMO pairs as you need for each mobile operator ID. For example, if you are adding another VVMMO called Fabrikam with MCC/MNC of 999/10, your entries will look like this:

   XML

3.     <Settings Path="Phone/VoicemailRegistrationTable">
         <Setting Name="ProviderRegistration/99999" Value="Contoso" />
         <Setting Name="ProviderRegistration/99910" Value="Fabrikam" />
       </Settings>
   

For each mobile operator ID defined in the previous step, you must define the applicable settings for that mobile operator by adding the following settings in your customization answer file.

XML

4.     <Settings Path="Phone/VoicemailRegistrationTable/$(VVMMO)">
         <Setting Name="CLSIDProvider" Value="" />
         <Setting Name="CLSIDAccessor" Value="" />
         <Setting Name="ProtocolVariant" Value="" />
         <Setting Name="IncomingPort" Value="" />
         <Setting Name="ClientType" Value="" />
         <Setting Name="DeviceType" Value="" />
         <Setting Name="InitialSmsDestinationNumber" Value="" />
         <Setting Name="EncryptedSmsSupported" Value="" />
         <Setting Name="KeyData" Value="" />
         <Setting Name="ImapPortOverride" Value="" />
         <Setting Name="TokenLogin" Value="" />
         <Setting Name="SuppressSsl" Value="" />
         <Setting Name="IgnoreLegacyNotifications" Value="" />
       </Settings>
   

5. Replace $(VVMMO) with the name of the VVMMO. For example, Contoso.

6. Set only the applicable settings that apply to the VVMMO and are required depending on the OMTP-based protocol being used. Note that you do not have to set all of these if they are not supported. The following table describes the values to use and indicates if the keys are required depending on the OMTP-based protocol being used.

Key name	Type	Generic OMTP	Comverse	Alcatel Lucent	Details
CLSIDProvider	REG_SZ	Required	Required	Required	Use {039B8E0E-EA5E-4801-96CD-71E7B343F03F} for an OMTP visual voicemail server or Comverse visual voicemail server. Use {C9804AB2-60B0-4AFF-8205-E30E591F145B} for an Alcatel Lucent visual voicemail server.
CLSIDAccessor	REG_SZ	Required	Required	Required	Use the value {BC371B86-031F-4BD7-9E7D-FB5DF7D1D8C3}
ProtocolVariant	REG_SZ	Required	Required	--	OMTP protocol version (“pv”). Use "ProtocolVariant"="omtp" for generic OMTP systems, or "ProtocolVariant"="comverse" for implementations that use Comverse systems.
IncomingPort	REG_DWORD	Required	Required	Required	SMS-MT application port (“pt”)
ClientType	REG_SZ	Required	Required	--	An identifier for the category of devices, which can be set to any string. (“ct”)
DeviceType	REG_SZ	Required	Required	--	A second–level Comverse-specific device type identifier.
InitialSmsDestinationNumber	REG_SZ	Required	Required	--	Phone number to use for SMS-MO messages for visual voicemail such as ACTIVATE or DEACTIVATE (“dn”).
EncryptedSmsSupported	REG_DWORD	Not required	Not required	--	Specifies whether 3DES encrypted SMS is supported. Use a value of 0 to indicate it is not supported. Use 1 to indicate this feature is supported.
KeyData	REG_BINARY	Required if EncryptedSmsSupported is set to 1.	Required if EncryptedSmsSupported is set to 1.	--	The binary key to use for encrypted SMS.
ImapPortOverride	REG_DWORD	--	--	Not required	Specifies the IMAP port to use regardless of the message contents. This feature should be turned on only for mobile operators that require it.
TokenLogin	REG_DWORD	--	--	Not required	Enables the use of token-based login instead of traditional username and password. This feature should be turned on only for mobile operators that require it.
SuppressSsl	REG_DWORD	--	--	Not required	Ignores any directive in the message payload to use SSL and forces non-SSL IMAP. This feature should be turned on only for mobile operators that require it. Use a value of 0 to indicate the feature is off; use 1 to indicate it is turned on.
IgnoreLegacyNotifications	REG_DWORD	Not required	Not required	Not required	Specifies whether legacy voicemail notifications should be ignored when visual voicemail is enabled. If the ignore legacy voicemail notification feature is enabled, legacy message waiting indicator SMS messages are ignored (i.e. these will not trigger a visual voicemail sync). If this feature is absent or not enabled, legacy voicemail MWI messages will cause a visual voicemail sync to be initiated. This feature should be turned on only for mobile operators that require it. This feature is not enabled by default. Use a value of 0 to indicate the feature is off; use 1 to indicate it is turned on.

1. For mobile operators that have their own particular brand that they want to use instead of visual voicemail, partners can rebrand all instances of Visual voicemail in the Windows device UI to use the operator's brand.

   To do this, set the value for Branding to the specific name that the mobile operator is using for visual voicemail. For example, you can set the value to Contoso Voice Inbox.

   Note

   This setting does not support a resource-only DLL for localized strings so you need to set the new string directly as the value.

Testing

Work with your mobile operator to obtain the settings and values that you need to configure visual voicemail and the value to use for Branding.

Once you have configured the visual voicemail settings and the branding, work with the mobile operator to test this customization on their network and verify that all instances of Visual voicemail in the Windows device UI have been replaced with the custom brand that you specified.

Related topics

Prepare for Windows mobile development

Customization answer file overview

Note

The feedback system for this content will be changing soon. Old comments will not be carried over. If content within a comment thread is important to you, please save a copy. For more information on the upcoming change, we invite you to read our blog post.