conversations Property

Current information about Live Connect is now available in the Windows Live Developer Center. The information in the following sections is provided for legacy purposes only.

Gets the ConversationCollection object for the user.

Feature:  Messenger.Core
Namespace:  Microsoft.Live.Messenger

// To retrieve:
var conversations = instance.get_conversations();

Return Value

A ConversationCollection object that represents the open conversations of the user.

Use the ConversationCollection object to create new conversations and manage existing ones.

The following code example uses the conversations property to get the list of conversations for the user and then creates a new conversation with a contact. The contact value is the Contact object that represents the user who is to be invited into the conversation.

            // Get the Messenger context and User object.
            messengerContext = wl.App.get_messengerContext(); 
            user = messengerContext.get_user();
            // Get the imAddress of a contact. The contact value represents a Contact object of the user with whom to initiate the conversation.
            imAddress = contact.get_currentAddress();
            // Create a new conversation with the specified contact.
            conv = user.get_conversations().create(imaddress);

Windows Live Messenger Connect

Supported in: 4.1

Windows Live Messenger Web Toolkit

Supported in: 3.7, 3.5, 3.1, 3.0, 2.5, 2.0, 1.0

Internet Explorer 8.0, Internet Explorer 7.0, Internet Explorer 6.0, Firefox 3.6, Firefox 3.5, Firefox 3.0, Firefox 2.0, Firefox 1.5, Chrome 4.0, Chrome 3.0, Chrome 2.0, Chrome 1.0, Safari 4.0, Safari 3.0, Opera 10.5