Memproses tanggapan dari pesan AppInstanceBot untuk Amazon Chime SDK - Amazon Chime SDK

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memproses tanggapan dari pesan AppInstanceBot untuk Amazon Chime SDK

Saat pengguna mengirim pesan, pengguna AppInstanceBot merespons dengan pesan saluran. Anda dapat membuat daftar pesan saluran untuk mendapatkan respons bot.

Contoh berikut menunjukkan Anda untuk menggunakan CLI untuk daftar pesan saluran.

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

Tanggapan sukses dari AppInstanceBot mengambil format berikut. 

{
    "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

ContentBidang berisi daftar pesan yang berasal dari bot Amazon Lex V2. Untuk informasi selengkapnya tentang pesan-pesan tersebut, lihat pesan di Amazon Lex V2 RecognizeText API.

Contoh berikut menunjukkan cara menggunakan Content bidang dalam pesan selamat datang.

{
    "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"
                    }
                ]
            }
        }
    ]
}

Untuk respons kegagalan, bidang Konten berisi pesan kesalahan dan kode dalam format berikut:

{
    "Code": error_code
}
ContentType

ContentTypeMengacu pada jenis payload yang berisi Content bidang, dan harus diperiksa untuk mengurai bidang. Content

catatan

Bot Lex V2 menggunakan yang berbedaContentType.

ContentTypediatur application/amz-chime-lex-msgs untuk respons sukses, atau application/amz-chime-lex-error untuk respons kegagalan.

MessageAttributes

A MessageAttributeadalah peta kunci string untuk nilai string. Tanggapan dari sebuah AppInstanceBot berisi atribut pesan berikut yang dipetakan ke respons dari bot Amazon Lex.

  • Chime.lex.SessionState.Intent.Name — Nama bot Lex bermaksud bahwa permintaan tersebut berusaha untuk memenuhi.

  • Chime.lex.SessionState.Intent.state — Status maksud saat ini. Nilai yang mungkin meliputi:Fulfilled,InProgress, danFailed.

  • Chime.lex.SessionState. originatingRequestId — Pengidentifikasi unik untuk permintaan khusus ke bot Amazon Lex. Ini diatur ke MessageId pesan pengguna asal yang memicu. AppInstanceBot

  • Chime.lex.SessionState.SessionId — Pengidentifikasi unik untuk percakapan antara pengguna dan bot. Saat pengguna memulai obrolan dengan bot Anda, Amazon Lex membuat sesi.

Untuk informasi selengkapnya tentang sesi Amazon Lex dan status sesi, lihat Referensi API Amazon Lex, dan Mengelola sesi di Panduan Pengembang Amazon Lex V2 SessionState

Untuk informasi selengkapnya tentang atribut yang dikembalikan Amazon Lex V2, lihat Amazon Lex Runtime V2 APIs.