Context Data Model

Reference documentation for the Context object

The Context object is equivalent to the task object documented in the POST /notify and GET /actions endpoints of our REST API. It is also described below for convenience.

Some fields, which are not documented below, might appear in actual objects. These fields are undocumented on purpose. Their use is unsupported and strongly discouraged.

Context

nametypedescription
idintegerA unique id associated with the current task (the message currently being processed by an Agent)
tagslist<Tag>The list of tags associated with the current task.
urlstringAn internal url that starts with https://alcmeon.com where this task can be viewed within Alcméon after authentication.
conversation_idintegerA unique id associated with the conversation in which the current task is embedded.
statestringone of: pending, assigned, answered, archived, archived-auto, help-requested, help-answered, on-hold.
messageMessageThe content of the message being currently processed.

Tag

nametypedescription
idintegerA unique id associated with this tag.
nameTagLabelThe name of this tag.
valueTagValueThe value of this tag.

TagLabel

nametypedescription
valuestringThe human-readable label displayed on screen

TagValue

nametypedescription
idintegerA unique id associated with this tag value.
valueTagLabelThe human-readable label associated with this tag value.

Message

nametypedescription
idintegerA unique id associated with this message
is_privatebooleanDid the author of this message send us this message privately ?
contentstringFor every channel, except Twitter, the textual content of this message. On Twitter, this content is empty.
external_idstringA channel-specific globally unique id.
datestringUTC+0, when the message was authored.
timestringUTC+0, when the message was authored.
attachmentslist<Attachment>The list of attachments associated with this message
authorAuthorThe author of this message

Author

nametypedescription
idintegerA unique id associated with the author.
namestringThe name of the author of a message. For example, on Facebook, this field contains the firstname+lastname. On Twitter, this field is empty.

Attachment

nametypedescription
idintegerA unique internal id associated with this attachment
mime_typestringThe mime type of the attachment payload
datastringThe attachment payload, encoded as base64
sizeintegerThe number of bytes of the decoded attachment payload