findOrCreate.map

Use the findOrCreate.map method to search for or create records that contain specific customer details.

Usage 

Searches for or creates records that contain the customer data that’s specified in the pre-chat form that the customer completes. This method maps the value of the custom details to the fields on the specified record in the Salesforce console.

You can call the findOrCreate.map method as many times as necessary to find the appropriate records. You can list multiple fields and their corresponding details to map the detail values to the appropriate fields within the record.

Available in API versions 29.0 and later.

Syntax 

<input type= “hidden” name= “liveagent.prechat.findorcreate.map: String entityName” value= “String fieldName, String detailName;” />

Parameters 

NameTypeDescriptionAvailable Versions
entityNameStringThe type of record to search for or create when an agent accepts a chat with a customer, for example, a contact recordAvailable in API versions 29.0 and later.
fieldNameStringThe name of the field in the record EntityName to which to map the corresponding custom detail valueAvailable in API versions 29.0 and later.
detailNameStringThe value of the custom detail to map to the corresponding field fieldNameAvailable in API versions 29.0 and later.
  • findOrCreate.map.doFind

    Use the findOrCreate.map.doFind method to specify which fields to search against existing customer records when a customer completes a pre-chat form.

  • findOrCreate.map.isExactMatch

    Use the findOrCreate.map.isExactMatch method to specify whether a field value must exactly match the field value in an existing record when you conduct a search with the findOrCreate.map method.

  • findOrCreate.map.doCreate

    Use the findOrCreate.map.doCreate method to specify which fields in findOrCreate.map method to use to create a new record if an existing record isn’t found.