msnp-wiki/docs/services/abservice/contactinfo.md

Introduction

The <contactInfo> element is the main associative element of a <Contact> node.

contactInfo

This element can contain many children, all of which optional:

• <quickName>: The sorting name of this contact
• <passportName>: The user handle of this contact.
• <IsPassportNameHidden> Are the contents of <passportName> hidden to the user (true or false)?
• <isMessengerUser>: Is this contact a part of the Messenger Service Network (true or false)?
• <contactType>: The type of contact this is related to:
  • LivePending: A user yet to authorise you
  • Regular: A user from another service.
• <displayName>: The display name for this contact.
• <puid>: Unused. Always 0.
• <CID>: The Common ID of this contact, which is a signed 64-bit integer.
• <IsNotMobileVisible>: Is this contact not visible as a mobile user (true or false)?
• <isMobileIMEnabled>: Does this contact allow me to talk to them via their mobile device (true or false)?
• <isFavorite>: Is this contact in the "Favorites" group (true or false)?
• <isSmtp>: Is this contact using a Japanese mobile phone (true or false)?
• <hasSpace>: Does this contact have a blog (true or false)?
• <spotWatchState>: Does this contact have a web watch, if not, set to NoDevice.
• <birthdate>: This contact's birthday as a ISO 8601 timestamp.
• <PendingAnnotations>: (ABContactAdd only) A list of <Annotation> elements you would like to add.
• <firstName>: The first name for this contact.
• <lastName>: The last name for this contact.
• <comment>: The user attached comment for this contact. New lines are included as-is.
• <MiddleName>: The middle name for this contact.
• <annotations>: Contains many <Annotation> elements.
• <primaryEmailType>: Can be any of the following:
  • ContactEmailPersonal
  • ContactEmailMessenger
  • ContactEmailBusiness
  • ContactEmailOther
  • Passport
• <emails>: Contains many <ContactEmail> elements.
• <PrimaryPhone>: Can be any of the following:
  • ContactPhonePersonal
  • ContactPhonePager
  • ContactPhoneFax
  • ContactPhoneBusiness
  • ContactPhoneOther
  • ContactPhoneMobile
• <phones>: Contains many <ContactPhone> elements.
• <PrimaryLocation>: Can be any of the following:
  • ContactLocationBusiness
  • ContactLocationPersonal
• <locations>: Contains many <ContactLocation> elements.
• <webSites>: Contains many <ContactWebSite> elements.
• <IsPrivate>: Is this contact private (true or false).
• <Gender>: What gender is this contact, if unsure, set to Unspecified.
• <TimeZone>: What time zone is this contact in?, if unsure, set to None.

Annotation

This element contains two children:

• <Name>: The key of this property:
  • MSN.IM.MBEA: (Only for you) Can users talk to me via my mobile phone? (0 or 1).
  • MSN.IM.GTC: (Only for you) Do I automatically add users to the AL or ask first? (0 or 1).
  • MSN.IM.BLP: (Only for you) Are all users blocked or allowed by default to talk to me? (0 or 1).
  • AB.JobTitle: The job title of this contact.
  • AB.NickName: The user-provided nick-name for this contact.
  • AB.Spouse: The contact's spouse's name.
• <Value>: The value of this property.

ContactEmail

This element contains two children:

• <contactEmailType>: Can be any of the following:
  • ContactEmailPersonal
  • ContactEmailMessenger
  • ContactEmailBusiness
  • ContactEmailOther
• <email>: The e-mail address associated with the <contactEmailType>.

ContactPhone

This element contains two children:

• <contactPhoneType>: Can be any of the following:
  • ContactPhonePersonal
  • ContactPhonePager
  • ContactPhoneFax
  • ContactPhoneBusiness
  • ContactPhoneOther
  • ContactPhoneMobile
• <number>: The phone number associated with the <contactPhoneType>.

ContactLocation

This element contains two children:

• <contactLocationType>: Can be any of the following:
  • ContactLocationBusiness
  • ContactLocationPersonal
• <name>: The name associated with the <contactLocationType>.
• <street>: The street associated with the <contactLocationType>.
• <city>: The city associated with the <contactLocationType>.
• <state>: The state associated with the <contactLocationType>.
• <country>: The country associated with the <contactLocationType>.
• <postalCode>: The postal code associated associated with the <contactLocationType>.
• <Changes>: A space delimited list of changed elements in this <ContactLocation>:
  • Name
  • Street
  • City
  • State
  • Country
  • PostalCode

ContactWebSite

This element contains two children:

• <contactWebSiteType>: Can be any of the following:
  • ContactWebSiteBusiness
  • ContactWebSitePersonal
• <webURL>: The location of the website associated with the <contactWebSiteType>.