2단계: Amazon Chime 챗봇에 대한 아웃바운드 엔드포인트 구성 - Amazon Chime
AWS CLIAmazon Chime APIJava용 AWS SDK

이 가이드의 단계를 완료하려면 Amazon Chime 시스템 관리자여야 합니다. Amazon Chime 데스크톱 클라이언트, 웹 앱 또는 모바일 앱과 관련하여 도움이 필요한 경우 Amazon Chime 사용 설명서의 지원 받기를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

2단계: Amazon Chime 챗봇에 대한 아웃바운드 엔드포인트 구성

Amazon Chime 엔터프라이즈 계정에 대한 챗봇 ID를 생성한 후에는 Amazon Chime이 봇에 메시지를 전송하는 데 사용할 아웃바운드 엔드포인트를 구성합니다. 아웃바운드 엔드포인트는 사용자가 사전 조건의 일부로 생성한 AWS Lambda 함수 ARN 또는 HTTPS 엔드포인트일 수 있습니다. Lambda에 대한 자세한 내용은 AWS Lambda 개발자 설명서를 참조하세요.

참고

봇에 대한 아웃바운드 HTTPS 엔드포인트가 구성되지 않았거나 비어 있는 경우 채팅룸 관리자는 채팅룸에 봇을 추가할 수 없습니다. 또한 채팅룸 사용자는 봇과 상호 작용할 수 없습니다.

AWS CLI

챗봇에 대한 아웃바운드 엔드포인트를 구성하려면 AWS CLI의 put-events-configuration 명령을 사용하세요. Lambda 함수 ARN 또는 아웃바운드 HTTPS 엔드포인트를 구성합니다.

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은 봇 ID 및 HTTPS 엔드포인트로 응답합니다.


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

Amazon Chime API

챗봇에 대한 아웃바운드 엔드포인트를 구성하려면 Amazon Chime API 참조에서 Amazon Chime PutEventsConfiguration API 작업을 사용하세요. Lambda 함수 ARN 또는 아웃바운드 HTTPS 엔드포인트를 구성합니다.

  • Lambda 함수 ARN을 구성할 경우 - Amazon Chime은 Lambda를 직접 호출하여 Amazon Chime 관리자의 AWS 계정이 제공된 Lambda 함수 ARN을 간접 호출할 수 있는 권한을 추가합니다. 이후 Amazon Chime에서 함수를 간접 호출할 권한이 있는지 확인하는 모의 실습 호출이 수행됩니다. 권한 추가에 실패하거나 모의 실습 호출이 실패하면 PutEventsConfiguration 요청에서는 HTTP 4xx 오류가 반환됩니다.

  • 아웃바운드 HTTPS 엔드포인트를 구성할 경우 - Amazon Chime에서는 Challenge JSON 페이로드가 있는 HTTP Post 요청을 이전 단계에서 제공한 아웃바운드 HTTPS 엔드포인트로 전송하여 엔드포인트를 확인합니다. 아웃바운드 HTTPS 엔드포인트에서는 Challenge 파라미터를 JSON 형식으로 되풀이하여 응답해야 합니다. 다음은 요청 및 유효한 응답을 보여주는 예입니다.

    Request
    
               HTTPS POST 

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

               {
                   "Challenge":"00000000000000000000"
               }

    Challenge 핸드셰이크가 실패하면 PutEventsConfiguration 요청에서는 HTTP 4xx 오류가 반환됩니다.

Java용 AWS SDK

아래의 샘플 코드는 Java용 AWS SDK를 사용하여 엔드포인트를 구성하는 방법을 보여줍니다.

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):