의 응답 처리 AppInstanceBot

사용자가 메시지를 보내면 채널 메시지로 AppInstanceBot 응답합니다. 채널 메시지를 나열하여 봇의 응답을 받을 수 있습니다.

다음 예에서는 CLI를 사용하여 채널 메시지를 나열하는 방법을 보여줍니다.

aws chime-sdk-messaging list-channel-messages \
--chime-bearer caller_app_instance_user_arn \
--channel-arn channel_arn

의 성공 응답은 다음과 같은 형식을 AppInstanceBot 취합니다.

{
    "MessageId": "messageId",
    "Content": "*{\"Messages\":[{\"...\"}]}*",
    "ContentType": "application/amz-chime-lex-msgs",
    "MessageAttributes": {
        "CHIME.LEX.sessionState.intent.name": {
            "StringValues": [
                "lex_bot_intent_name"
            ]
        },
        "CHIME.LEX.sessionState.intent.state": {
            "StringValues": [
                "lex_bot_intent_fullfilment_status"
            ]
        },
        "CHIME.LEX.sessionState.originatingRequestId": {
            "StringValues": [
                "lex_bot_originating_request_id"
            ]
        },
        "CHIME.LEX.sessionState.sessionId": {
            "StringValues": [
                "lex_bot_session_id"
            ]
        }
    },
    "Sender": {
        "Arn": "app_instance_bot_arn",
        "Name": "app_instance_bot_name"
    },
    "Type": "STANDARD",
}

Content

Content필드에는 Amazon Lex V2 봇에서 전송된 메시지 목록이 포함되어 있습니다. 이러한 메시지에 대한 자세한 내용은 Amazon Lex V2 RecognizeText API의 메시지를 참조하십시오.

다음 예제는 환영 메시지에서 Content 필드를 사용하는 방법을 보여줍니다.

{
    "Messages":
    [
        {
            "Content": "Hello!",
            "ContentType": "PlainText"
        },
        {
            "ContentType": "ImageResponseCard",
            "ImageResponseCard":
            {
                "Title": "Hello! I'm BB, the Bank Bot.",
                "Subtitle": "I can help you with the following transactions",
                "Buttons":
                [
                    {
                        "Text": "Check balance",
                        "Value": "Check balance"
                    },
                    {
                        "Text": "Escalate to agent",
                        "Value": "Escalate to agent"
                    }
                ]
            }
        }
    ]
}

실패 응답의 경우 콘텐츠 필드에는 다음 형식의 오류 메시지와 코드가 포함됩니다.

{
    "Code": error_code
}

ContentType

는 Content 필드에 포함된 페이로드 유형을 ContentType 나타내며 필드를 파싱하려면 반드시 확인해야 합니다. Content

참고

Lex V2 봇은 다른 ContentType 것을 사용합니다.

ContentType성공 application/amz-chime-lex-msgs 응답의 경우 또는 실패 application/amz-chime-lex-error 응답의 경우 로 설정됩니다.

MessageAttributes

MessageAttributeA는 문자열 키와 문자열 값의 매핑입니다. 의 AppInstanceBot 응답에는 Amazon Lex 봇의 응답에 매핑된 다음 메시지 속성이 포함됩니다.

• Chime.lex.sessionState.intent.name — 요청이 이행하려고 시도한 렉스 봇 인텐트의 이름입니다.

• Chime.lex.SessionState.Intent.State — 인텐트의 현재 상태입니다. 가능한 값에는: FulfilledInProgress, 및 등이 Failed 있습니다.

• 차임 렉스 세션 상태. originatingRequestId— Amazon Lex 봇에 대한 특정 요청을 위한 고유 식별자입니다. 이 값은 를 트리거한 발신 사용자 메시지의 으로 AppInstanceBot 설정됩니다. MessageId

• Chime.lex.sessionState.sessionID — 사용자와 봇 간의 대화를 위한 고유 식별자입니다. 사용자가 봇과 채팅을 시작하면 Amazon Lex가 세션을 생성합니다.

Amazon Lex 세션 및 세션 상태에 대한 자세한 내용은 Amazon Lex API 참조의 내용을 참조하고 Amazon Lex V2 개발자 안내서의 세션 관리를 참조하십시오. SessionState

Amazon Lex V2가 반환하는 속성에 대한 자세한 내용은 Amazon Lex 런타임 V2 API를 참조하십시오.