Author object

The Author object defines the remote author associated with a message. You'll include an author object in any JSON payload sent with a request to:

• POST /bots/v3/respond
• PUT /bots/v3/author
• PUT /bots/v3/control
• PUT /bots/v3/note
• PUT /bots/v3/priority
• PUT /bots/v3/resolve
• PUT /bots/v3/tag
• PUT /bots/v3/workqueue
• PUT /bots/v3/authors

The Author object optionally includes a properties object containing a list of key/value pairs. This properties object is specific to the Khoros Messaging channel. The key/value pairs represent custom metadata set on the Messaging author via the Messaging SDKs.

Examples of metadata include things like the page being viewed, the content of a search box, author phone number, anything that the mobile app chooses to capture about the author. Passing this metadata from the mobile app gives the bot additional context that you can use to help the bot make decisions when responding to a message.

If custom properties are not set on the author by Khoros Messaging, the properties object is not included in the Author object.

"author":{  
  "id":"urn:mbid:....",
  "fullName":"Anonymous Alligator",
  "properties":{  
    "customerUserName":"customerSupplied1",
    "searchBarContents":"product"
  }
}