64 lines
2.1 KiB
Markdown
64 lines
2.1 KiB
Markdown
|
# Introduction
|
||
|
|
`ABGroupContactAdd` is one of the SOAP actions the [Address Book Service](../abservice.md) 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](../abservice.md) 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](../abservice.md) 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>`](contactinfo.md) 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>`](contactinfo.md) 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](../abservice.md) 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.
|