Newer Version Available

This content describes an older version of this product. View Latest

VirtualVisitConfig

Represents an external video provider configuration, which relays events from Salesforce to the provider.

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

Important

Parent Type

This type extends the Metadata metadata type and inherits its fullName field.

File Suffix and Directory Location

VirtualVisitConfig components have the suffix .virtualVisitConfig and are stored in the VirtualVisitConfigs folder.

Version

VirtualVisitConfig components are available in API version 54.0 and later.

Special Access Rules

Access to this metadata type requires at least one of these preferences:

  • Video Calls: Org Pref (VideoVisits) Org preference
  • Industries Einstein: Intelligent Form Reader (EinsteinDocReader)
  • Industries Einstein: Sentiment Insights Account (IESentimentAnalysis)
  • Natural Language Processing: Key phrase extraction and entity detection (NLPServiceEnabled) Org Preference and the NLP: Key phrase extraction (KeyPhrasePrefEnabled) Org Preference
  • Natural Language Processing (NLPServicePrefEnabled) Org Preference

Fields

Field Name Description
comprehendServiceType
Field Type
VirtualVisitComprehendServiceType (enumeration of type string)
Description
Specifies the type of service used to convert speech into text or to analyze the converted speech text.

Valid values are:

  • ComprehendMedicalService
  • ComprehendService
experienceCloudSiteUrl
Field Type
string
Description
The URL of the Digital Experience site where the Video Call component is available to portal or guest users.
externalRoleIdentifier
Field Type
string
Description
The ID of the role that's used to allow users to join a video call and to grant them temporary access to certain functions needed to participate in the call.
isProtected
Field Type
boolean
Description
An auto-generated value that doesn’t currently impact the behavior of the metadata type.
masterLabel
Field Type
string
Description

Required.

A user-friendly name for VirtualVisitConfig, which is defined when the VirtualVisitConfig is created.

messagingRegion
Field Type
string
Description
The region where the waiting room and messaging channel data is processed and stored. Available in API version 57.0 and later.
namedCredential
Field Type
string
Description
The named credential record used to authenticate and authorize a video call vendor’s account.
storageBucketName
Field Type
string
Description
The name of the storage bucket that stores the meeting transcript.
usageType
Field Type
VirtualVisitUsageType (enumeration of type string)
Description
The name of the Salesforce feature for which the video call configuration record is created.

Valid values are:

  • CHIME
  • INTELLIGENT_FORM_READER
  • SENTIMENT_ANALYSIS
videoCallApptTypeValue
Field Type
string
Description
The default Appointment Type picklist values from the Service Appointment object that represent a video appointment type. Use semicolons to separate multiple values.
videoControlRegion
Field Type
string
Description
The region where API calls related to Video Calls are made. Available in API version 57.0 and later.
visitRegion
Field Type
VirtualVisitVisitRegion (enumeration of type string)
Description
The region where the Video Call audio and video data is processed.

Valid values are:

  • af-south-1
  • ap-east-1
  • ap-northeast-1
  • ap-northeast-2
  • ap-northeast-3
  • ap-south-1
  • ap-southeast-1
  • ap-southeast-2
  • ca-central-1
  • eu-central-1
  • eu-north-1
  • eu-south-1
  • eu-west-1
  • eu-west-2
  • eu-west-3
  • me-south-1
  • sa-east-1
  • us-east-1
  • us-east-2
  • us-west-1
  • us-west-2

Declarative Metadata Sample Definition

This is an example of a VirtualVisitConfig component.

1<?xml version="1.0" encoding="UTF-8"?>
2 <VirtualVisitConfig xmlns="http://soap.sforce.com/2006/04/metadata">
3     <usageType>CHIME</usageType>
4     <visitRegion>us-east-1</visitRegion>
5     <masterLabel>vvconfig1</masterLabel>
6     <experienceCloudSiteUrl>videocall_c@testcloudurl.com</experienceCloudSiteUrl>
7     <namedCredential>SampleNamedCredential</namedCredential>
8     <comprehendServiceType>ComprehendService</comprehendServiceType>
9     <storageBucketName>comprehendbucket</storageBucketName>
10     <isProtected>false</isProtected>
11 </VirtualVisitConfig>

This is an example package.xml that references the previous definition.

1<?xml version="1.0" encoding="UTF-8"?>
2 <Package xmlns="http://soap.sforce.com/2006/04/metadata">
3     <namespacePrefix>[namespacePrefix]</namespacePrefix>
4     <fullName>deployPackage</fullName>
5     <types>
6         <members>*</members>
7         <name>VirtualVisitConfig</name>
8     </types>
9     <types>
10         <members>*</members>
11         <name>NamedCredential</name>
12     </types>
13     <version>55.0</version>
14 </Package>

Wildcard Support in the Manifest File

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.