messages
Use the messages data format creator to export Messages from the messenger and save this data in the cloud. The raw data file is stored in the cloud for a maximum of 6 months. Therefore, the data must be processed before this date. The following tables contain further information about the format.
1. Technical specifications
See Table 1 for further information on the available properties and their corresponding values.
Property | Meaning | Value | Explanation |
---|---|---|---|
dataName |
Name |
messages |
Name of the creator process and prefix of the created file. |
fileFormat |
File format |
CSV, GZIP |
The data is provided as a GZIP-compressed CSV file (RFC 1952). |
limitPage |
Lines per request |
up to 8,000 |
The maximum number of data rows that is written into a single file. |
limitDay |
Lines per day |
up to 200,000 |
The maximum number of data rows that is written on one day in total. |
earliestPossibleDataDate |
Earliest point in time |
2020-01-01 |
Point in time as of which the raw data can be collected. The data is filtered by the date saved in the dataUpdatedAtColumnName column. |
filterType |
Filter type |
lastUpdate |
Data are filtered based on the last update. |
dataUpdatedAtColumnName |
Column header |
msg_updated_at |
Name of the column that contains the time stamp of the last data update. |
defaultActive |
Activated by default |
no |
The data is only exported automatically in the background after you have activated the creator in the Setup » plentyBI » Raw data menu. |
interval |
Interval |
daily |
With this setting, all data that has been changed since the last run is exported once a day, usually during the night. |
storableFromPlan |
Storage starting from tariff |
plentyBI S |
Minimum fee plan required for saving the data in cloud storage and making it available via REST. |
processableFromPlan |
Usage starting from tariff |
plentyBI L |
Minimum fee plan required for making the data available in plentyBI Data Warehouse, i.e. for using, filtering and processing key figures. |
2. Data columns
See {dataColumns} for further information on the messages data columns included in the CSV file during raw data export.
Column name | Data type | Full name | Explanation |
---|---|---|---|
msg_id (Primary key) |
VARCHAR NOT NULL |
message id |
ID of the message |
msg_parent_id |
VARCHAR |
message parent id |
ID of the parent message |
plenty_id |
INTEGER NOT NULL |
plenty id |
ID of the plentymarkets system |
o_id |
VARCHAR |
order id |
ID of the order |
ac_id |
VARCHAR NOT NULL |
account contact id |
ID of the contact |
msg_from_type |
VARCHAR |
message from type |
Type of the message |
msg_from_value |
VARCHAR |
message from value |
Sender of the message |
msg_referrer_type |
VARCHAR |
message referrer type |
Referrer of the message |
msg_minutes |
INTEGER |
message minutes |
Number of minutes saved for the message, e.g. “30 minutes support” |
msg_chargeable |
SMALLINT |
message chargeable |
Flag that indicates whether the minutes are billed. |
msg_done_at |
TIMESTAMPTZ |
message done at |
Time stamp when the message was closed |
msg_created_at |
TIMESTAMPTZ NOT NULL |
message created at |
Time stamp of the creation |
msg_updated_at |
TIMESTAMPTZ NOT NULL |
message updated at |
Time stamp of the last update |
msg_deleted_at |
TIMESTAMPTZ |
message deleted at |
Time stamp of the deletion |