Schritt 2: Führen Sie den ausstellbaren Amazon Chime aus - Amazon Chime
AWS CLIAmazon Chime APIAWS-SDK für Java

Sie müssen ein Amazon Chime Chime-Systemadministrator sein, um die Schritte in diesem Handbuch ausführen zu können. Wenn Sie Hilfe mit dem Amazon Chime Chime-Desktop-Client, der Web-App oder der mobilen App benötigen, finden Sie weitere Informationen unter Support erhalten im Amazon Chime Chime-Benutzerhandbuch.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Schritt 2: Führen Sie den ausstellbaren Amazon Chime aus

Nachdem Sie eine Chatbot-ID für Ihr Amazon Chime Enterprise-Konto erstellt haben, konfigurieren Sie Ihren ausgehenden Endpunkt, damit Amazon Chime Nachrichten an Ihren Bot sendet. Der ausgehende Endpunkt kann ein seinAWS LambdaFunktion ARN oder ein HTTPS-Endpunkt, den Sie als Teil der erstellt habenVoraussetzungen. Weitere Informationen zu Lambda finden Sie im AWS Lambda Entwicklerhandbuch.

Anmerkung

Wenn der ausgehende HTTPS-Endpunkt für Ihren Bot nicht konfiguriert oder leer ist, können Chatroom-Administratoren den Bot nicht zu einem Chatroom hinzufügen. Außerdem können Chatroom-Benutzer nicht mit dem Bot interagieren.

AWS CLI

Um einen ausgehenden Endpunkt für Ihren Chatbot zu konfigurieren, verwenden Sie denput-events-configurationBefehl imAWS CLI. Konfigurieren Sie einen Lambda-Funktions-ARN oder einen ausgehenden HTTPS-Endpunkt.

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 antwortet mit der Bot-ID und dem HTTPS-Endpunkt.


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

Amazon Chime API

Verwenden Sie Amazon Chime, um den ausgehenden Endpunkt für Ihren Chatbot zu konfigurierenPutEventsConfigurationAPI-Betrieb inAmazon Chime API-Referenz. Konfigurieren Sie entweder einen Lambda-Funktions-ARN oder einen ausgehenden HTTPS-Endpunkt.

  • Wenn Sie eine Lambda-Funktion ARN konfigurieren— Amazon Chime ruft Lambda auf, um dem Amazon Chime Chime-Administrator die Erlaubnis zu erteilenAWSKonto, um die bereitgestellte Quue für die Lambda-Funktion aufzurufen. Führen Sie einen Probelauf aus, um zu überprüfen, ob Amazon Chime die Berechtigung zum Aufrufen der Funktion hat. Wenn das Hinzufügen von Berechtigungen fehlschlägt oder wenn der Probelaufruf fehlschlägt, dannPutEventsConfigurationDie Anfrage gibt einen HTTP 4xx-Fehler zurück.

  • Wenn Sie einen ausgehenden HTTPS-Endpunkt konfigurieren— Amazon Chime verifiziert Ihren Endpunkt, indem es eine HTTP-Post-Anfrage mit einer Challenge-JSON-Payload an den ausgehenden HTTPS-Endpunkt sendet, den Sie im vorherigen Schritt angegeben haben. Ihr ausgehender HTTPS-Endpunkt muss reagieren, indem er den Challenge-Parameter im JSON-Format zurückgibt. Die folgenden Beispiele zeigen die Anforderung und eine gültige Antwort.

    Request
    
               HTTPS POST 

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

               {
                   "Challenge":"00000000000000000000"
               }

    Falls der Challenge-Handshake fehlschlägt, gibt die PutEventsConfiguration-Anforderung einen HTTP 4xx-Fehler zurück.

AWS-SDK für Java

Der folgende Beispielcode zeigt, wie Sie einen Endpunkt mit dem konfigurierenAWSSDK 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):