Airy Core allows its users to process messaging data from a variety of sources, which are integrated via source providers. Users connect sources via channels. Once the channel is connected, Airy Core ingests source data and transforms them into conversations, contacts, and messages.
This document aims to provide a high-level overview of the Airy Core technical vocabulary. It provides definitions of the most important terms used both in the code and in the rest of the documentation.
Our Avro schemas provide a machine readable up-to-date version of our backend data model. If you are looking for details like null constraints and such, the Avro schemas folder is the right place. Furthermore, it is worth underlining that the Avro data model and glossary do not correspond exactly. The former is the exact machine representation of the data we store and the latter is a conceptual artifact we created to discuss and solve problems.
A channel represents a connection between a source and the Airy Core Platform.
Not the same as users. Contacts are source participants whereas users are the actual users interacting with the airy platform.
A message wraps the data that is being transferred from and to the source with metadata. By definition, the data is source dependent. It can be plain text, or rich media like videos or sound, images, or templates.
Unique message id for deduplication.
postback.payloadstring postback payloads used for source automations
postback.referralstring facebook specific referral identifier
Indicates whether the message was sent by a contact or not.
contentstring Immutable string version of the ingested content.
offsetlong sequence number of message within a conversation
sourcestring source that ingested the message
pendingmessage to be sent out
deliveredmessage has been sent to source or has arrived at Airy
failedmessage sending has terminally failed
nullfor messages that are inserted first time
Header data contains information that is important for downstream processing and therefore cannot be separated from the message (as opposed to metadat). It also includes the message preview and tags that are useful for use cases like routing and automations.
Metadata is optional data attached to a subject such as a conversation, channel or a message. Have a look at this page for an in-depth explanation.
A tag is a special use case of metadata, which is used to tag conversations. As the use case of tagging conversations is so common, Airy Core provides specialized endpoints and filters for tagging conversations.
A source represents a system that generates messaging data that a user wants to process with Airy Core.
Source providers are API platforms that allow Airy Core to connect to one or more of their sources typically via a webhook. E.g. Twilio is a source provider for the Twilio SMS and WhatsApp sources.
A user represents one authorized agent in Airy Core, which is different from a Contact
Pre-defined messages that can be enhanced with user defined data.