Notes, Annotations etc are stored as objects in the data stores, these objects, along with the data stored have additional properties such as a created_date. All properties of an object are returned for that object, there is no requirement to specify what is returned.

Note

A note object represents a single text based note attached to a Social Media Author. The following properties appear on a note

Property Description Variations
action action type that created this note add_note, modify_note
created_date ISO datetime of the action N/A
author see explanation of author object N/A
id unique ID of the note N/A
text contents of the note N/A
user ID of the agent that created or modified this note N/A

JSON view of a note object

{
      "action": "add_note",
      "created_date": "2016-03-15T17:48:49",
      "author": {
        "author_ids": [
          "t:2825986021"
        ],
        "customer_profiles_id": "564b5d829bd56c14074805f0"
      },
      "id": "56e84b019bd56c6a6c692a5a",
      "text": "A Thaum is the basic unit of magical strength. It has been universally established as the amount of magic needed to create one small white pigeon or three normal-sized billiard balls",
      "user": 16
}

Annotation

An annotation is a key value piece of data that is stored against a Social Media Author. The annotations have types which are created through the Conversocial interface, which act as the key. For instance, one of the default types is "Email" and an email value can be stored against it.

"email": "rincewind@unseenuniversity.disc"

The annotations are exposed as an object with its value and its type. The following properties appear on an annotation

Property Description Variations
action action type that created this annotation add_note, modify_note
created_date ISO datetime of the action N/A
author see explanation of author object N/A
id unique ID of the annotation N/A
text value of the annotation N/A
type_id see explanation of annotation types N/A
user ID of the agent that created or modified this annotation N/A

JSON view of an annotation object

{
      "action": "add_annotation",
      "created_date": "2015-11-17T17:02:06",
      "author": {
        "author_ids": [
          "t:2825986021"
        ],
        "customer_profiles_id": "564b5d829bd56c14074805f0"
      },
      "id": "564b5d8e9bd56c14074805f2",
      "text": "rincewind@unseenuniversity.ac.disc",
      "type_id": "564b5d709bd56c14074805ec",
      "user": 16
}


Annotation Types

An annotation_type is the key for an annotation. These are created through Conversocial and every annotation will have a type_id that corresponds to an annotation_type.

Property Description Variations
format short, long
id the ID of the annotation type
is_active whether this field can currently be used by agents true / false
name the name of the annotation type

JSON view of an annotation-type

{
  "format": "short",
  "id": "564b5d709bd56c14074805ec",
  "is_active": true,
  "name": "Wizard Rank"
}


Tags

A tag is a simple string attached to a Customer Profile. Any number of tags can be attached to a Social Media Author as long as these have been defined through the Conversocial interface. In a similar fashion to notes, and annotations, tags are represented by a tag object with properties.

Property Description Variations
action action type that created this tag add_tag, modify_tag
created_date ISO datetime of the action N/A
author see explanation of author object N/A
id unique ID of the tag N/A
name the tag name N/A
user ID of the agent that created or modified this annotation N/A

JSON view of a tag object

{
      "action": "add_tag",
      "created_date": "2015-12-29T13:24:11.075000",
      "author": {
        "author_ids": [
          "t:123456"
        ],
        "customer_profiles_id": "5682897b9bd56c0cba207aa3"
      },
      "id": "5682897b9bd56c0cba207aa2",
      "name": "wizard",
      "user": 1
}


Author

The author is a single object encompassing all data in Customer profiles, stored against that _author_id.

The author objects property author is itself an object that details the Conversocial author ID and the Customer Profiles internal ID. Each Social Media Author in Conversocial has an ID, this is known as the author_id. This author_id is the Social Media platforms unique ID prepended with a letter e.g. a Facebook author_id will look something like f:123121231231 whereas a Twitter author_id will be prepended with t:.

Property Description
author_ids a list of the author IDs in Conversocial which are attached to this Customer profile
customer_profiles_id the ID of this Customer profile
    "author": {
        "author_ids": [
          "t:2825986021"
        ],
        "customer_profiles_id": "564b5d829bd56c14074805f0"
    },

An author fully represents all active properties of an Authors Profile. Retrieved by its author_id property, it returns all notes, annotations, and tags.

Property Description
annotations a list of annotations. see explanation of annotations
notes a list of notes. see explanation of notes
tags a list of tags. see explanation of tags
author see explanation of author object

JSON view of an author

{
  "customer": {
        "annotations": [
            {
              "action": "add_annotation",
              "created_date": "2015-11-17T17:02:06",
              "id": "564b5d8e9bd56c14074805f2",
              "text": "rincewind@unseenuniversity.ac.disc",
              "type_id": "564b5d709bd56c14074805ec",
              "user": 16
            },
            {
              "action": "add_annotation",
              "created_date": "2015-11-19T15:05:30",
              "id": "564de53a9bd56c1c9c89e375",
              "text": "1-800-get-magic",
              "type_id": "564b5d709bd56c14074805ed",
              "user": 16
            }
        ],
        "author": {
            "author_ids": [
              "t:2825986021"
            ],
            "customer_profiles_id": "564b5d829bd56c14074805f0"
        },
        "notes": [
            {
              "action": "add_note",
              "created_date": "2016-03-15T17:48:49",
              "id": "56e84b019bd56c6a6c692a5a",
              "text": "A Thaum is the basic unit of magical strength. It has been universally established as the amount of magic needed to create one small white pigeon or three normal-sized billiard balls",
              "user": 16
            }
        ],
        "tags": [
            {
              "action": "add_tag",
              "created_date": "2015-12-29T13:24:11.075000",
              "author": {
                "author_ids": [
                  "t:123456"
                ],
                "customer_profiles_id": "5682897b9bd56c0cba207aa3"
              },
              "id": "5682897b9bd56c0cba207aa2",
              "name": "wizard",
              "user": 1
            }
        ]
  },
  "status_code": 200,
  "success": true
}