GrooveMessages.CreateReply Operation

The CreateReply operation sends a reply to a previous message.

HTTP Post URL

The HTTP Post URL targets the message replied to. This URI is available from the Read operation and other operations.

Input Message Header

GrooveRequestHeader specifies information common to all Groove Web Services, including the Groove Identity URL and the Groove Request key.

Input Message Parameters

<CreateReply>
    <ReplyToAll />
    <IncludeOriginalMessageContent />
    <AdditionalHeaderData />
    <AdditionalContent />
<CreateReply>
Element Data type Description

ReplyToAll

xs:boolean

If true, all addressees of the original message will be transferred to the recipient list. If false, only the sender of the original message will be added to the recipient list. Additional addressees may also be added in the AdditionalHeaderData element.

IncludeOriginalMessageContent

xs:boolean

If true, the body of the original message will be appended to the body of this reply.

AdditionalHeaderData

MessageHeader

Provides additional recipients for the response message.

AdditionalContent

MessageContent

Provides the response content.

Output Message Header

GrooveResponseHeader specifies the Response key.

Return Value

<CreateReplyResult />
Element Data type Description

CreateReplyResult

xs:anyURI

The URI of the sent message.

Remarks

The reply does not include any attachments or voice memos that may have been present in the original message.

You specify an additional recipient of the reply message with the Groove Identity URL of the contact in a MessageContact in the Recipients element of the AdditionalHeaderDataMessageHeader.

You can include only recipients that are accessible to the account. The following kinds of contacts are accessible:

  • Contacts in the account Contacts list.

  • Members of workspaces that the account belongs to.

  • Contacts who have been the sender or a recipient of a message in the account message history.

If a call to the Create, CreateForward, or CreateReply operation specifies a recipient that is not accessible to the account, a SOAP fault will be returned and the entire operation will fail. The SOAP exception does not provide any information on which contact caused the operation to fail.

See Also

Reference

GrooveMessages Web Service
GrooveMessages.Create Operation
GrooveMessages.CreateForward Operation

Concepts

Accessing Groove Messages