Passaggio 2: configura l'endpoint in uscita per un chatbot Amazon Chime - Amazon Chime
AWS CLIAPI Amazon ChimeAWS SDK per Java

Avviso di fine del supporto: il 20 febbraio 2026, AWS terminerà il supporto per il servizio Amazon Chime. Dopo il 20 febbraio 2026, non potrai più accedere alla console Amazon Chime o alle risorse dell'applicazione Amazon Chime. Per ulteriori informazioni, consulta il post del blog. Nota: ciò non influisce sulla disponibilità del servizio Amazon Chime SDK.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Passaggio 2: configura l'endpoint in uscita per un chatbot Amazon Chime

Dopo aver creato un ID chatbot per il tuo account Amazon Chime Enterprise, configura l'endpoint in uscita per Amazon Chime da utilizzare per inviare messaggi al bot. L'endpoint in uscita può essere una funzione AWS Lambda ARN o un endpoint HTTPS creato come parte dei prerequisiti. Per ulteriori informazioni su Lambda, consulta la Guida per gli sviluppatori di AWS Lambda.

Nota

Se l'endpoint HTTPS in uscita per il bot non è configurato o è vuoto, gli amministratori della chat room non possono aggiungere il bot a una chat room. Inoltre, gli utenti della chat room non possono interagire con il bot.

AWS CLI

Per configurare un endpoint in uscita per il tuo chatbot, usa il put-events-configuration comando in. AWS CLI Configura una funzione Lambda ARN o un endpoint HTTPS in uscita.

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 risponde con l'ID bot e l'endpoint HTTPS.


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

API Amazon Chime

Per configurare l'endpoint in uscita per il tuo chatbot, utilizza l'operazione dell'API Amazon Chime nell'Amazon Chime PutEventsConfigurationAPI Reference. Configura una funzione Lambda ARN o un endpoint HTTPS in uscita.

  • Se configuri una funzione Lambda ARN, Amazon Chime chiama Lambda per aggiungere l'autorizzazione e consentire all'account AWS dell'amministratore di Amazon Chime di richiamare la funzione Lambda ARN fornita. Segue una chiamata dry run per verificare che Amazon Chime sia autorizzato a richiamare la funzione. Se l'aggiunta delle autorizzazioni fallisce o se la chiamata dry run fallisce, la richiesta restituisce un errore HTTP 4xx. PutEventsConfiguration

  • Se configuri un endpoint HTTPS in uscita, Amazon Chime verifica il tuo endpoint inviando una richiesta HTTP Post con un payload JSON Challenge all'endpoint HTTPS in uscita fornito nel passaggio precedente. L’endpoint HTTPS in uscita deve rispondere eseguendo l'echoing del parametro Challenge in formato JSON. I seguenti esempi mostrano la richiesta e una risposta valida.

    Request
    
               HTTPS POST 

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

               {
                   "Challenge":"00000000000000000000"
               }

    Se l’handshake Challenge ha esito negativo, la richiesta PutEventsConfiguration restituisce un errore HTTP 4xx.

AWS SDK per Java

Il codice di esempio seguente mostra come configurare un endpoint utilizzando l' 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):