Configuration de l'intégration pour les applications intégrées dans Amazon Connect

Ces intégrations utilisent les applications intégrées dans Amazon Connect pour fournir des mises à jour régulières à la fonctionnalité Profils des clients Amazon Connect.

Avant de commencer

Ingestion en bloc de données

Lorsque vous configurez votre intégration, il vous est demandé de saisir la date à laquelle vous souhaitez remonter pour ingérer les données. Si vous choisissez une date remontant à plus de deux mois, la fonctionnalité Profils des clients active automatiquement l'ingestion en bloc en créant plusieurs flux. Cela vous évite d'avoir à calculer le nombre de flux dont vous avez besoin pour ingérer des données.

Lorsque l'ingestion automatique en bloc est activée, la fonctionnalité Profils des clients effectue les opérations suivantes :

• Définit la taille du lot sur deux mois.

• Réessaie jusqu'à trois fois en cas d'échec temporaire avant d'échouer.

Vous pouvez utiliser l'CreateIntegrationWorkflowRequestAPI pour appeler votre propre taille de lot.

Pourquoi me demande-t-on de sélectionner ou de créer un rôle IAM ?

Pour Salesforce, Marketo et Customer Profiles ServiceNow, vous pouvez améliorer l'assimilation historique de ces sources en utilisant votre rôle IAM pour créer plusieurs flux de travail afin d'ingérer vos données rapidement et efficacement.

Pour ces sources, si vous sélectionnez un sélecteur de date Date d'importation des enregistrements il y a plus de 60 jours, vous serez invité à créer un nouveau rôle IAM ou à en sélectionner un existant. Ce rôle permet à la fonctionnalité Profils des clients de gérer votre intégration. Il fournit à la fonctionnalité Profils des clients les autorisations nécessaires pour mettre à jour et créer un flux de travail pour ingérer vos données. Une fois le flux de travail terminé, la fonctionnalité Profils des clients crée une intégration continue standard qui ingère vos nouvelles données au fur et à mesure de leur mise à jour dans votre source.

Le rôle créé dans la console n'est utilisable que par le domaine sur lequel il a été créé. Cela est dû au fait qu'Amazon Connect limite l'accès du rôle à la seule clé KMS utilisée par le domaine.

Pour plus d’informations, consultez Autorisation de l'accès de moindre privilège à votre rôle d'exécution Profils des clients.

Autorisation de l'accès de moindre privilège à votre rôle d'exécution Profils des clients

Si vous souhaitez créer votre propre rôle IAM, nous vous recommandons d'utiliser les autorisations indiquées dans le code suivant afin de limiter le rôle au minimum d'autorisations nécessaires. Utilisez l'extrait ci-dessous pour créer votre rôle manuellement. Utilisez votre propre clé KMS et spécifiez votre région si nécessaire.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow"
                }
            },
            "Action": [
                "appflow:CreateFlow",
                "appflow:TagResource",
                "profile:TagResource",
                "profile:PutIntegration"
            ],
            "Resource": "*",
            "Effect": "Allow",
            "Sid": "CreateFlowResources"
        },
        {
            "Action": [
                "appflow:UseConnectorProfile"
            ],
            "Resource": "*",
            "Effect": "Allow",
            "Sid": "UseConnectorResources"
        },
        {
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow"
                }
            },
            "Action": [
                "appflow:DescribeFlow",
                "appflow:DescribeFlowExecutionRecords",
                "appflow:DeleteFlow",
                "appflow:StartFlow",
                "appflow:StopFlow",
                "appflow:UpdateFlow",
                "profile:DeleteIntegration"
            ],
            "Resource": "*",
            "Effect": "Allow",
            "Sid": "AccessFlowResources"
        },
    {
      "Action": [
        "kms:CreateGrant",
        "kms:ListGrants"
      ],
      "Resource": "{{YourKMSKeyConsumedByTheDomain}}",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": [
            "appflow.{{region}}.amazonaws.com"
          ]
        }
      },
      "Effect": "Allow",
      "Sid": "KMSAppflow"
    },
    {
      "Action": [
        "kms:CreateGrant"
      ],
      "Resource": "{{YourKMSKeyConsumedByTheDomain}}",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": [
            "profile.{{region}}.amazonaws.com"
          ]
        },
        "ForAllValues:StringEquals": {
          "kms:GrantOperations": [
            "Decrypt"
          ]
        }
      },
      "Effect": "Allow",
      "Sid": "KMSCustomerProfiles"
    }
  ]
}  

Surveillance de vos intégrations Profils des clients

Une fois votre connexion établie, si elle cesse de fonctionner, supprimez l'intégration, puis rétablissez-la.

Que faire si des objets ne sont pas envoyés

Si un objet ne parvient pas à être envoyé, choisissez Détails du flux pour en savoir plus sur le problème.

Vous devrez peut-être supprimer la configuration et vous reconnecter à l'application externe.