Étape 2 : configurer le point de terminaison de sortie d'un chatbot Amazon Chime - Amazon Chime
AWS CLIAPI Amazon ChimeKit SDK AWS pour Java

Vous devez être un administrateur système Amazon Chime pour effectuer les étapes décrites dans ce guide. Si vous avez besoin d'aide concernant le client de bureau, l'application Web ou l'application mobile Amazon Chime, consultez la section Obtenir de l'aide dans le guide de l'utilisateur Amazon Chime.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Étape 2 : configurer le point de terminaison de sortie d'un chatbot Amazon Chime

Après avoir créé un identifiant de chatbot pour votre compte Amazon Chime Enterprise, configurez votre point de terminaison sortant pour qu'Amazon Chime l'utilise pour envoyer des messages à votre bot. Le point de terminaison sortant peut être unAWS Lambdafonction ARN ou point de terminaison HTTPS que vous avez créé dans le cadre duexigences. Pour plus d'informations sur Lambda, consultez le guide du développeur AWS Lambda.

Note

Si le point de terminaison HTTPS sortant de votre bot n'est pas configuré ou est vide, les administrateurs du salon de discussion ne peuvent pas ajouter le bot au salon de discussion. De plus, les utilisateurs du salon de discussion ne peuvent pas interagir avec le bot.

AWS CLI

Pour configurer un point de terminaison sortant pour votre chatbot, utilisez leput-events-configurationcommande dans leAWS CLI. Configurez un ARN de fonction Lambda ou un point de terminaison HTTPS sortant.

Lambda ARN
aws chime put-events-configuration --account-id 12a3456b-7c89-012d-3456-78901e23fg45 --bot-id botId --lambda-function-arn arn:aws:lambda:us-east-1:111122223333:function:function-name
HTTPS endpoint
aws chime put-events-configuration --account-id 12a3456b-7c89-012d-3456-78901e23fg45 --bot-id botId --outbound-events-https-endpoint https://example.com:8000

Amazon Chime répond avec l'ID du bot et le point de terminaison HTTPS.


{
    "EventsConfiguration": {
        "BotId": "BotId", 
        "OutboundEventsHTTPSEndpoint": "https://example.com:8000"
    }
}

API Amazon Chime

Pour configurer le point de terminaison sortant de votre chatbot, utilisez Amazon ChimePutEventsConfigurationFonctionnement de l'API dansRéférence de l'API Amazon Chime. Configurez un ARN de fonction Lambda ou un point de terminaison HTTPS sortant.

  • Si vous configurez un ARN de fonction Lambda— Amazon Chime appelle Lambda pour ajouter l'autorisation d'autoriser l'administrateur Amazon Chime àAWScompte pour appeler l'ARN de la fonction Lambda fourni. Ceci est suivi d'une invocation de course à sec pour vérifier qu'Amazon Chime est autorisé à appeler la fonction. Si l'ajout d'autorisations échoue ou si l'invocation du dry run échoue, alors lePutEventsConfigurationLa requête renvoie une erreur HTTP 4xx.

  • Si vous configurez un point de terminaison HTTPS sortant— Amazon Chime vérifie votre point de terminaison en envoyant une requête HTTP Post avec une charge utile Challenge JSON au point de terminaison HTTPS sortant que vous avez indiqué à l'étape précédente. Votre point de terminaison HTTPS sortant doit répondre en renvoyant le paramètre Challenge au format JSON. Les exemples suivants illustrent la demande et une réponse valide.

    Request
    
               HTTPS POST 

               JSON Payload:
               {
                  "Challenge":"00000000000000000000",
                  "EventType" : "HTTPSEndpointVerification"
               }
    Response
    
               HTTP/1.1 200 OK
               Content-type: application/json

               {
                   "Challenge":"00000000000000000000"
               }

    Si le challenge handshake échoue, la demande PutEventsConfiguration renvoie une erreur HTTP 4xx.

Kit SDK AWS pour Java

L'exemple de code suivant montre comment configurer un point de terminaison à l'aide duAWSSDK pour Java.

PutEventsConfigurationRequest putEventsConfigurationRequest = new PutEventsConfigurationRequest()
     .withAccountId("chimeAccountId")
     .withBotId("botId")
     .withOutboundEventsHTTPSEndpoint("https://www.example.com")
     .withLambdaFunctionArn("arn:aws:lambda:region:account-id:function:function-name");

 chime.putEventsConfiguration(putEventsConfigurationRequest):