Configuration information for Amazon AppIntegrations to automatically ingest content.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{
"AppIntegrationArn" : String,
"ObjectFields" : [ String, ... ]
}
YAML
AppIntegrationArn: String
ObjectFields:
- String
Properties
AppIntegrationArn-
The Amazon Resource Name (ARN) of the AppIntegrations DataIntegration to use for ingesting content.
-
For Salesforce
, your AppIntegrations DataIntegration must have an ObjectConfiguration if objectFields is not provided, including at least Id,ArticleNumber,VersionNumber,Title,PublishStatus, andIsDeletedas source fields. -
For ServiceNow
, your AppIntegrations DataIntegration must have an ObjectConfiguration if objectFields is not provided, including at least number,short_description,sys_mod_count,workflow_state, andactiveas source fields. -
For Zendesk
, your AppIntegrations DataIntegration must have an ObjectConfiguration if objectFieldsis not provided, including at leastid,title,updated_at, anddraftas source fields. -
For SharePoint
, your AppIntegrations DataIntegration must have a FileConfiguration, including only file extensions that are among docx,pdf,html,htm, andtxt. -
For Amazon S3
, the ObjectConfiguration and FileConfiguration of your AppIntegrations DataIntegration must be null. The SourceURIof your DataIntegration must use the following format:s3://your_s3_bucket_name.Important
The bucket policy of the corresponding S3 bucket must allow the AWS principal
app-integrations.amazonaws.com.rproxy.goskope.comto performs3:ListBucket,s3:GetObject, ands3:GetBucketLocationagainst the bucket.
Required: Yes
Type: String
Pattern:
^arn:[a-z-]+?:[a-z-]+?:[a-z0-9-]*?:([0-9]{12})?:[a-zA-Z0-9-:/]+$Minimum:
1Maximum:
2048Update requires: Replacement
-
ObjectFields-
The fields from the source that are made available to your agents in Amazon Q in Connect. Optional if ObjectConfiguration is included in the provided DataIntegration.
-
For Salesforce
, you must include at least Id,ArticleNumber,VersionNumber,Title,PublishStatus, andIsDeleted. -
For ServiceNow
, you must include at least number,short_description,sys_mod_count,workflow_state, andactive. -
For Zendesk
, you must include at least id,title,updated_at, anddraft.
Make sure to include additional fields. These fields are indexed and used to source recommendations.
Required: No
Type: Array of String
Minimum:
1 | 1Maximum:
4096 | 100Update requires: Replacement
-
