KustomerCore.describeCustomer()

Update information about a customer in Kustomer.

πŸ‘

First, initialize chat

You must initialize with KustomerCore.init() before you can execute any additional Core SDK methods

Examples

We're provided some examples of how you can call KustomerCore.describeCustomer():

// Update custom attributes of the customer

KustomeCorer.describeCustomer({
  attributes: {
    emails: ['[email protected]']
  }
});

KustomerCore.describeCustomer({
  attributes: {
    emails: ['[email protected]'],
    phones: ['5555555555'],
    socials: [{
      username: 'facebook_username',
      type: 'facebook'
    }]
  }
});

// Update custom attributes of the customer and run a callback after

KustomerCore.describeCustomer({
  customAttributes: {
    some_custom_attribute: 'some custom value'
  }
}, function (callbackResponse, error) {
  console.log('Updated information about the customer');
});

Syntax

KustomerCore.describeCustomer(options, function(callbackResponse, error))
ParameterTypeDescription
optionsObjectRequired

An object containing all of the properties you want to update on the customer inside Kustomer. A breakdown of the options object is listed below.
function(callbackResponse, error)FunctionOptional

A callback that is run after KustomerCore.describeCustomer() completes.

callbackResponse is an object returned to the callback function. See the callbackResponse section below to see the properties of the object.

error is either undefined or a native JavaScript Error object.

options

{
  attributes: {
    emails: ['[email protected]', '[email protected]'],
    phones: ['5555555555', '8888888888'],
    socials: [
      {
        username: 'facebook_username',
        type: 'facebook'
      },
      {
        username: 'twitter_username',
        type: 'twitter'
      }
    ]
  },
  customAttributes: {
    some_custom_attribute: 'some_custom_value',
    some_custom_attribute2: 'some_custom_value2'
  }
}

πŸ“˜

customAttributes

Before you can update a custom attribute with KustomerCore.describeCustomer(), the custom attribute must first exist on the Customer Klass in your Kustomer organization.

You can learn more about Klasses and custom attributes in the Kustomer Help Center.

PropertyTypeDescription
attributesObjectOptional

An object containing the attributes of a customer. We allow describing emails, phones, or socials. See above for an example payload.
customAttributesObjectOptional

An object containing the custom attributes of the customer

callbackResponse

PropertyTypeDescription
phonesArrayRequired

An array of phone number strings.
emailsArrayRequired

An array of email address strings.
socialsArrayRequired

An array of objects describing the social media accounts connected to the customer.
customerIdStringRequired

The customer's unique ID in Kustomer's database.
customObjectOptional

An object containing the custom attributes of the customer.

{ some_custom_attribute: 'some_custom_value' }