Conversation Integration Guide
Overview
Rithum's Dsco platform supports retailers and suppliers having direct message conversations with each other on the platform. Customers find this feature useful because they can easily initiate a conversation thread on an order or on an item that is being setup or on a return and the context of the conversation is saved as part of the conversation thread. This makes it easy for a trading partner to find and act on the messages of the conversation since the context of that conversation is explicitly known.
Approach
Conversations, and thus the messages within them, are always between exactly one retailer and one supplier. For now, the Dsco platform has elected to not do direct person to person communication due to privacy concerns and the use cases this feature is meant to solve. Instead, a message is shared by a retailer or supplier with a specific trading partner, for a supplier it's a single retailer and for a retailer it's a single supplier. The message can be seen and responded to by any user at either the retailer or supplier who are associated with the conversation.
Either a retailer or supplier may create a Conversation.
Details
Either a retailer or supplier may use the Create Conversation API to create a conversation and optionally include an initial message to add to the conversation.
You will be required to designate which of your partners you want to have a conversation with when you create
the conversation. You will also be required to specify the context of the conversation in the
context
attribute. Below are the different contexts supported.
Account Context
Use the account context to initiate an arbitrary conversation with a trading partner.
Order Context
Use the order context to have a conversation around a single order. You will have to specify which specific Order object you mean to have the conversation around.
Catalog Context
Use the catalog context to have a conversation about item setup or about catalog content attributes on a given item. You will have to specify which Item Catalog object you mean to have the conversation around.
Inventory Context
Use the inventory context to have a conversation about inventory of a given item. You will have to specify which Item Inventory object you mean to have the conversation around.
Contract Context
Use the contract context to have a conversation about a contract shared from a retailer to a supplier. You will have to specify which Contract object you mean to have the conversation around.
Invoice Context
Use the invoice context to have a conversation about an invoice. You will have to specify which Invoice object you mean to have the conversation around.
Return Context
Use the return context to have a conversation about a return. You will have to specify which Return object you mean to have the conversation around.
Conversation Status
Conversations have a life cycle, captured in the status
attribute. Newly created conversations
that do not have a message added to them will be in the new
state. Conversations that
have at least one message added to them will be in the in_progress
state. Conversations that
have been explicitly closed or where there hasn't been activity for an extended period of time and
were automatically closed will be in the closed
state. You may not add messages to a conversation
that is closed. You may reopen a conversation by updating its status to in_progress
.
Customer Care Conversations
Customer care is one of the fundamental conversation types supported to facilitate getting end consumer feedback via a retailer to a supplier whose responses are routed back to the end consumer via the retaier. Please reference the Customer Care Integration Guide for more information.