Fase 2: configurare l'endpoint DLQ per un chatbot Amazon Chime - Amazon Chime
AWS CLIAPI Amazon ChimeSDK AWS per Java

Devi essere un amministratore di sistema Amazon Chime per completare i passaggi di questa guida. Se hai bisogno di assistenza con il client desktop, l'app Web o l'app mobile Amazon Chime, consulta Ottenere assistenza nella Guida per l'utente di Amazon Chime.

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à.

Fase 2: configurare l'endpoint DLQ 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 unAWS Lambdafunzione ARN o un endpoint HTTPS creato come parte diprerequisiti. 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 ilput-events-configurationcomando inAWS 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, usa Amazon ChimePutEventsConfigurationFunzionamento API inRiferimento API Amazon Chime. Configura una funzione Lambda ARN o un endpoint HTTPS in uscita.

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

  • 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.

SDK AWS per Java

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