msnp-wiki/docs/services/abservice/abgroupcontactadd.md
yellows111 f096fe907f
[0.1.3] ABGroup(Contact)*, parts of *Member (CSS)
rework XML stuff a bit, right now it's wildly inconsistent, but all the AB stuff should be fine

more ContactUpdate out of known because i didn't even KNOW that was an operation in sharingservice and noticed it looked weird being in known.

Add a SOAP template too.
2024-10-30 21:33:59 +00:00

2.1 KiB

Introduction

ABGroupContactAdd is one of the SOAP actions the Address Book Service provides.

Adds a contact from the Forward List (FL) to a contact group.

Client/Request

The template used in this action is described on the Address Book Service main page.

ABGroupContactAdd

This element has only one attribute:

  • xmlns: Is always set to http://www.msn.com/webservices/AddressBook.

abId

This element contains your Address Book Service GUID.

groupFilter

This element only contains the <groupIds> element.

groupIds

This element only contains one or multiple <guid> element(s).

guid

The GUID of the group you'd like to add a contact to.

contacts

This element only contains the <Contact> element.

Contact

This element only contains the <contactInfo> element.

This element has one optional child:

  • <contactId>: Used to add an existing contact to a group.
contactInfo

NOTE: This element is only used when adding a new contact to a group.

For more information about this element, read the <contactInfo> article.

The relevant elements are:

  • <isSmtp>: Used with <phones> or <emails> if this is a new contact outside of the Messenger Network.
  • <emails>: Used with <isSmtp> if this is a new email-only contact.
  • <phones>: Used with <isSmtp> if this is a new phone-only contact.

groupContactAddOptions

This element has two children:

  • <fGenerateMissingQuickName>: Should this action generate the <quickName> in the <contactInfo> element (true or false).
  • <EnableAllowListManagement>: Usually only set to true.

Server/Response

The template used in this action is described on the Address Book Service main page.

ABGroupContactAddResponse

This element has only one attribute:

  • xmlns: Is always set to http://www.msn.com/webservices/AddressBook.

ABGroupContactAddResult

This element only contains the <guid> element.

guid

This element contains the GUID of the contact that was added to the group.