---
schema_version: "1"
id: c149bf6e76b2953b0415970cad94e16137cd71e186c49da42b91c13b184f3b4d
title: ChannelObjectLinkingRule
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_channelobjectlinkingrule.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_channelobjectlinkingrule.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: fd1009f8734663b2ad2748803d2ef990348902f1aef48ba24df70cd781753363
description: Represents a rule for linking a channel interaction with an object (such as Lead or Contact). This object is available in API version 47.0 and later.
---
# ChannelObjectLinkingRule

Represents a rule for linking a channel interaction with an object (such as Lead or Contact). This object is available in API version 47.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), query(), retrieve(), update(), upsert()

## Fields

| Field | Details |
| --- | --- |
| ActionForNoRecordFound | 
Type

picklist

Properties

Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

Description

Action to take when no matching records are found.

Possible values are:

- CreateNewRecordAndLink—Create Record and Link (Recommended)
- PromptAgent—Prompt Agent





 |
| ActionForSingleRecordFound | 

Type

picklist

Properties

Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

Description

Action to take when one matching record is found.

Possible values are:

- AutoLink—Auto-Link Record (Recommended)
- PromptAgent—Prompt Agent





 |
| ChannelType | 

Type

picklist

Properties

Create, Filter, Group, Restricted picklist, Sort

Description

The type of channel used for this rule.

Possible values are:

- FacebookMessenger
- Phone
- Text
- WeChat
- WhatsApp





 |
| Description | 

Type

textarea

Properties

Create, Nillable, Update

Description

The description for this linking rule.



 |
| DeveloperName | 

Type

string

Properties

Create, Filter, Group, Sort, Update

Description

The unique name of the object in the API. This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. In managed packages, this field prevents naming conflicts on package installations. With this field, a developer can change the object’s name in a managed package and the changes are reflected in a subscriber’s organization.

![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png)

#### Note

When creating large sets of data, always specify a unique DeveloperName for each record. If no DeveloperName is specified, performance may slow while Salesforce generates one for each record.

![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png)

#### Note

Only users with View DeveloperName OR View Setup and Configuration permission can view, group, sort, and filter this field.















 |
| IsLinkedRecordOpenedAsSubTab | 

Type

boolean

Properties

Create, Defaulted on create, Filter, Group, Sort, Update

Description

Indicates whether to open the linked record as a subtab when the link is established.



 |
| IsRuleActive | 

Type

boolean

Properties

Create, Defaulted on create, Filter, Group, Sort, Update

Description

Indicates whether the rule is active.



 |
| Language | 

Type

picklist

Properties

Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

Description

The language for this linking rule.

Possible values are:

- ar—Arabic
- bg—Bulgarian
- cs—Czech
- da—Danish
- de—German
- el—Greek
- en\_GB—English (UK)
- en\_US—English
- es—Spanish
- es\_MX—Spanish (Mexico)
- fi—Finnish
- fr—French
- hr—Croatian
- hu—Hungarian
- in—Indonesian
- it—Italian
- iw—Hebrew
- ja—Japanese
- ko—Korean
- nl\_NL—Dutch
- no—Norwegian
- pl—Polish
- pt\_BR—Portuguese (Brazil)
- pt\_PT—Portuguese (European)
- ro—Romanian
- ru—Russian
- sk—Slovak
- sl—Slovene
- sv—Swedish
- th—Thai
- tr—Turkish
- uk—Ukrainian
- vi—Vietnamese
- zh\_CN—Chinese (Simplified)
- zh\_TW—Chinese (Traditional)





 |
| MasterLabel | 

Type

string

Properties

Create, Filter, Group, Sort, Update

Description

The unique label name for this rule.



 |
| ObjectToLink | 

Type

picklist

Properties

Create, Filter, Group, Restricted picklist, Sort

Description

The type of object to link to the channel interaction.

Possible values are:

- Contact





 |
| RuleName | 

Type

string

Properties

Create, Filter, Group, Sort, Update

Description

Name of the rule as it appears in the UI. Maximum length is 80 characters.



 |