bestmatchCustomers

Find a customer best match based on known Social Information

Details

Every bestmatch field is optional. In most cases, only displayName, screenName, and profileUrl will be present.

Responses and Response Schema

200 (Customers Found)

The 200 response consists of an array[object] consisting of the following fields.

Field NameTypeDescription
id*string
url*string

Format: uri
The URI the agent can click on to see the customer.
customNonSearchableCustomerFieldOnestringThese will only be present if specified via the /meta/object/customer endpoint.
customNonSearchableCustomerFieldTwostringThese will only be present if specified via the /meta/object/customer endpoint.
customSearchableCustomerFieldOnestringThese will only be present if specified via the /meta/object/customer endpoint.
customSearchableCustomerFieldTwostringThese will only be present if specified via the /meta/object/customer endpoint.
400 (Invalid Field in Payload)

An invalid field in the payload. Generic errors.

Field NameTypeDescription
fieldsobject
error*stringThe name of the error or code.
message*stringMessage passable to the user.
fields object
Field NameType
name*string
errorMessage*string
401 (API Key is Invalid)

API key is invalid or has become de-authenticated.

500 (Unexpected Error)

Unexpected error.

Field NameTypeDescription
error*stringName of the error or code.
message*stringMessage passable to the user.
Body Params
string

The name of the user as it would appear on the social network.

string

The social handle of the user.

string

A description of the user as specified in Khoros Care.

string

A direct link to the user's social profile #header.

string

An email address to the user.

phoneNumbers
array of strings

A list of phone numbers for the user as defined in Khoros Care.

phoneNumbers
addresses
array of objects

A list of addresses for the user as defined in Khoros Care.

addresses
orderNumbers
array of strings

A list of order numbers for the user as defined in Khoros Care.

orderNumbers
caseNumbers
array of strings

A list of case numbers for the user as defined in Khoros Care. Note: These will not be case numbers from this system.

caseNumbers
accountNumbers
array of strings

A list of account numbers for the user as defined in Khoros Care.

accountNumbers
Headers
string

The email ID of the Khoros Care agent performing the action.

int32

The ID of the active Khoros Care initiative the user is in when performing the action.

int32

The Khoros Care ID of the company the user is in when making the request.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
URL
Response
Choose an example:
application/json
text/plain