Comment puis-je résoudre les problèmes liés à la fonction Lambda dans un flux de contacts Amazon Connect ?

Résolution

Vérifiez le message d'erreur dans le journal de flux de contacts

Procédez comme suit :

• Si vous n'avez pas configuré le journal de flux de contacts, activez la journalisation de flux de contacts pour votre instance Amazon Connect.
• Recherchez tout message d'erreur dans vos journaux de flux de contacts. Par exemple, pour rechercher un message d'erreur dans une période donnée, exécutez une requête similaire à la requête suivante :

  fields @timestamp, @message
  | filter @message like 'Results'
  | parse @message '"Results":"*","ContactId":"*","ContactFlowId":"*","ContactFlowName":"*","ContactFlowModuleType":"*"' as Results, ContactId, ContactFlowId, ContactFlowName, BlockType
  | filter Results like 'rror' or Results like 'ailed' or Results like 'imeout' or Results like 'xception' or Results like 'No prompt provided' or Results like 'Instance has reached concurrent Lambda thread access limit' or Results like 'nsupported' or Results like 'nvalid' or Results like 'not found' or Results like 'execution limit reached'
  | filter BlockType = 'InvokeExternalResource'
  | sort @timestamp asc
  | display Timestamp, Results, ContactId, ContactFlowId, ContactFlowName, BlockType

En fonction du message d'erreur, effectuez les tâches suivantes.

Code de statut : 403 ; code d’erreur : AccessDeniedException; RequestId: XXXXXXXX

Si la stratégie basée sur les ressources de votre fonction n'autorise pas Amazon Connect à invoquer la fonction, l'erreur précédente peut s'afficher. Vous pouvez consulter la stratégie basée sur les ressources de votre fonction pour savoir si elle inclut les autorisations requises.

Pour ajouter les autorisations requises à la stratégie, utilisez l'une des méthodes suivantes :

• Utilisez la console Amazon Connect pour ajouter une fonction Lambda à votre instance. La fonction obtient automatiquement les autorisations de ressources lorsqu'elle est ajoutée à l'instance.

• Exécutez la commande add-permission de l’interface de la ligne de commande AWS (AWS CLI). Incluez le principal connect.amazonaws.com et l’Amazon Resource Name (ARN) de votre instance Amazon Connect.
  Exemple :

  aws lambda add-permission --function-name function-name --action lambda:InvokeFunction --statement-id connect-to-lambda --principal connect.amazonaws.com --source-arn connect-instance-arn

• Utilisez la console Lambda pour créer une stratégie basée sur les ressources. Pour plus d'informations, consultez la section Gestion des autorisations dans Lambda.
  Exemple de stratégie basée sur les ressources :

  {
    "Version": "2012-10-17",
    "Id": "default",
    "Statement": [
      {
        "Sid": "100",
        "Effect": "Allow",
        "Principal": {
          "Service": "connect.amazonaws.com"
        },
        "Action": "lambda:InvokeFunction",
        "Resource": "<Qualified AWS Lambda ARN>",
        "Condition": {
          "ArnLike": {
            "AWS:SourceArn": "<Amazon Connect ARN>"
          }
        }
      }
    ]
  }

« La fonction Lambda a renvoyé une erreur »

Pour déterminer la cause de l'erreur précédente, consultez les métriques Amazon CloudWatch pour Lambda. Examinez les métriques des données à l'horodatage correspondant.

Si les métriques d'erreur ne contiennent pas de données à l'horodatage correspondant, vérifiez la réponse de votre fonction.

Remarque : Il est recommandé de tester la sortie renvoyée par votre fonction Lambda. Vérifiez que la fonction Lambda renvoie la sortie dans un format compatible avec Amazon Connect.

Pour la sortie, examinez les configurations suivantes :

• La charge utile Lambda doit être une valeur autre que NULL.
• Si le type de validation de réponse est STRING_MAP, la sortie doit être un objet plat composé de paires clé-valeur, et il ne peut pas être imbriqué. Si le type est JSON, l'objet doit être une valeur JSON valide et il peut inclure un JSON imbriqué.
• Les paires clé-valeur ne peuvent inclure que des caractères alphanumériques, le tiret ou le caractère de soulignement.
• La taille des données renvoyées doit être inférieure à 32 Ko de données UTF-8.
• Vérifiez que le paramètre Délai d’expiration de votre fonction Lambda est défini sur une valeur suffisamment élevée. La valeur doit être suffisamment élevée pour permettre à votre fonction d'invoquer, de traiter des données, puis de renvoyer une réponse.

Lorsque vous utilisez l’option Appeler une fonction Lambda dans le flux de contacts, la limite est inférieure à ce qui est configuré dans la limite d’expiration maximale Lambda. Le paramètre Délai d’expiration a une valeur par défaut de 3 secondes et une valeur maximale de 8 secondes.

Supposons, par exemple, que votre fonction Lambda soit configurée avec une valeur de délai d’expiration de 15 secondes et que votre fonction Lambda s'exécute pendant 10 secondes. Bien que vous n'obteniez pas d'erreur de délai d’expiration, le flux de contacts achemine l'exécution vers la branche d'erreur car la valeur de Délai d’expiration maximale autorisée est de 8 secondes.

Pour connaître le temps nécessaire à l'appel de votre fonction, consultez les métriques de durée de la fonction dans Amazon CloudWatch. Puis, mettez à jour la valeur du délai d'expiration de l’option Appeler une fonction Lambda et des fonctions Lambda, selon les besoins.

Remarque : Pour inclure dans votre flux de contacts des fonctions Lambda dont l'invocation prend plus de huit secondes, utilisez des fonctions Lambda asynchrones avec Amazon Connect. Si vous invoquez plusieurs fonctions Lambda, la durée de la séquence de fonctions doit être inférieure ou égale à 20 secondes.

Si les métriques d'erreur Lambda contiennent des données à l'horodatage correspondant, suivez les étapes décrites dans la section Comment puis-je résoudre les échecs de la fonction Lambda ?

Informations connexes

Invoquer un alias de fonction AWS Lambda depuis Amazon Connect