Describe Conversation

Updates information about a Conversation object in Kustomer.

You can add custom attributes to a Conversation object in Kustomer.

val result = Kustomer.getInstance()
                .describeConversation(conversationId, 
                                      mapOf(customKey to customValue))

  when (result) {
    is KusResult.Success -> //Success
      is KusResult.Error -> //Error
  }

Required attributes

Name

Type

Description

conversationId

String

The unique ID for the conversation in Kustomer.

mapOf(customKey to customValue)

Map<String,Any>

A map containing the custom attributes of the conversation.

Example:

{
someCustomKeyNameStr: 'some_custom_value'
}

Use custom attributes

You can send the SDK custom attribute values for custom attributes enabled in Kustomer.

Always use the attribute name instead of the Display Name listed in the Klasses editor (Settings > Platform > Klasses) in Kustomer. The attribute name will always be formatted in camelCase or PascalCase without spaces and also describes the data type for the attribute.

For example, if a custom attribute has a Display Name of "Avg Sat Score" and has a number data type, then the name may appear as AvgSatScoreNum. You would use AvgSatScoreNum, the system name for the custom attribute, with the SDK.

👍

Activate custom attributes for the Conversation klass

To update custom attributes, ensure you have the custom attribute key-value pairs activated for the Conversation klass on the Kustomer platform. To edit or view custom attributes for the Customer klass, go to Settings and select Platform > Klasses > Conversation.

To learn more, see Define custom attribute in Kustomer in the Kustomer Help Center.

Always send in the system name for custom attributes and check that the attribute is activated in the Klasses editor.Always send in the system name for custom attributes and check that the attribute is activated in the Klasses editor.

Always send in the system name for custom attributes and check that the attribute is activated in the Klasses editor.

Convert multi-level list (mll, or tree) attribute values to lowercase

👍

Convert multi-level list style attribute values to lowercass

For example, if you have a multi-level list attribute value of Level11, convert the value to level11 for use with the SDK. All value for multi-level list attributes are stored in lowercase on the backend.

If you use a multi-level list, or tree-style, format for any Conversation klass attributes, you will need to convert the values to lowercase before you can send the attribute values to the SDK.

Multi-level list format attribute in the Kustomer Klasses editor.Multi-level list format attribute in the Kustomer Klasses editor.

Multi-level list format attribute in the Kustomer Klasses editor.


Did this page help you?