Étape 2 : Configuration du point de terminaison sortant pour un chatbot Amazon Chime - Amazon Chime
AWS CLIAPI Amazon ChimeAWS SDK pour Java

Avis de fin de support : le 20 février 2026, le support du service Amazon Chime AWS prendra fin. Après le 20 février 2026, vous ne pourrez plus accéder à la console Amazon Chime ni aux ressources de l'application Amazon Chime. Pour plus d'informations, consultez le billet de blog. Remarque : Cela n'a aucune incidence sur la disponibilité du service Amazon Chime SDK.

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 : Configuration du point de terminaison sortant pour 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 un ARN de AWS Lambda fonction ou un point de terminaison HTTPS que vous avez créé dans le cadre des prérequis. 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 la put-events-configuration commande du. AWS 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 l'opération d'API Amazon PutEventsConfigurationChime dans le manuel Amazon Chime API Reference. 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 permettant au compte de l'administrateur Amazon Chime d'appeler l'ARN AWS de la fonction Lambda fourni. Ceci est suivi d'un appel à 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, la PutEventsConfiguration 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 fourni à 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.

AWS SDK pour Java

L'exemple de code suivant montre comment configurer un point de terminaison à l'aide du AWS SDK for 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):