Hey moveworks community,
As announced earlier regarding the upcoming changes in the notifications entity of Data API : HERE
This post highlights the schema of Conversations entity that you can expect after the rollout.
We encourage you to update your data pipeline accordingly to get the most of this rollout.
Conversations entity
| Col Name (Data API convention) | Expectation |
|---|---|
| id | Unique ID for the conversation |
| user_id | User ID |
| primary_domain | primary_domain populated for DM, Ticket & Channel Interception events wherever detected |
| route | One of these enum values - DM, Notification, Channel, Ticket |
| created_time | Time stamp when conversation is initiated either by the system or user |
type 🆕(string) | Only populated for newly added SysEvents. More details about the enum values below |
detail 🆕(JSON object) | Populated as per the conversation type. More details below |
| org | Org |
Here is the further breakdown for “type” and detail” fields
type | detail |
|---|---|
| CONVERSATION_TYPE_APPROVAL_UPDATE_NOTIFICATION | type source domain |
| CONVERSATION_TYPE_COMMS_NOTIFICATION | campaign_id campaign_name |
| CONVERSATION_TYPE_AMBIENT_AGENT_NOTIFICATION | usecase_id usecase_name |
| CONVERSATION_TYPE_EVENTS_NOTIFICATION | usecase_id usecase_name |
| CONVERSATION_TYPE_TICKET_UPDATE_NOTIFICATION | ticket_id |
| CONVERSATION_TYPE_TICKET_WAITING_NOTIFICATION | ticket_id |
| CONVERSATION_TYPE_TICKET_WATCHER_NOTIFICATION | ticket_id |
| CONVERSATION_TYPE_TICKET_NUDGE_NOTIFICATION | ticket_id |
| CONVERSATION_TYPE_EXPIRED_PASSWORD_NOTIFICATION | NA |
| CONVERSATION_TYPE_EXPIRING_PASSWORD_NOTIFICATION | NA |
| CONVERSATION_TYPE_LOCKED_ACCOUNT_NOTIFICATION | NA |
| CONVERSATION_TYPE_CSAT_NOTIFICATION | NA |
| CONVERSATION_TYPE_TICKET_INTERCEPTION | ticket_id content - content here refers to actual ticket description |
| CONVERSATION_TYPE_CHANNEL_INTERCEPTION | channel_id channel_name content - content here refers to actual channel message from the user |
| CONVERSATION_TYPE_BOT_DIGEST_NOTIFICATION | NA |
| CONVERSATION_TYPE_NUDGE_NOTIFICATION | NA |
| CONVERSATION_TYPE_PROMOTION_NOTIFICATION | NA |
| CONVERSATION_TYPE_SELF_SERVE_ALERT_NOTIFICATION | NA |
| CONVERSATION_TYPE_UNSPECIFIED_SYS_EVENT | NA |