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

Menyiapkan Aliran Dinamis

Aliran Dinamis memanggil titik akhir HTTPS Anda sendiri saat runtime untuk mengambil konten layar dan memutuskan navigasi. Aliran Statis menentukan semua layar di Flow JSON. Aliran Dinamis malah menggunakan data_exchange tindakan untuk meminta data dari titik akhir Anda setiap kali pengguna menavigasi antar layar. Ini memungkinkan pengalaman yang dipersonalisasi dan berbasis data seperti menunjukkan kepada pengguna pesanan terbuka mereka, memvalidasi sisi server input, atau percabangan berdasarkan keputusan backend.

Ketika pengguna berinteraksi dengan Dynamic Flow, Meta memanggil titik akhir Anda secara langsung dengan permintaan terenkripsi. Titik akhir Anda mendekripsi permintaan, menjalankan logika bisnis Anda, mengenkripsi respons, dan mengembalikannya ke Meta. Permintaan dan respons terenkripsi melewati langsung antara Meta dan titik AWS akhir Anda, sehingga Social Pesan Pengguna Akhir tidak pernah memiliki akses ke konten yang didekripsi dari pertukaran ini. AWS Social Pesan Pengguna Akhir mengelola bidang kontrol: membuat dan memperbarui Alur, mengunggah kunci publik enkripsi, dan mengirimkan webhook kesehatan Flow.

Untuk mengatur Aliran Dinamis, Anda menyelesaikan langkah-langkah berikut:

Langkah 1: Menyebarkan titik akhir HTTPS

Titik akhir Anda harus memenuhi persyaratan berikut:

Anda dapat menggunakan opsi komputasi apa pun yang menyediakan URL HTTPS publik. Pendekatan umum meliputi:

Titik akhir Anda harus menerapkan kontrak pertukaran data Meta, yang menangani jenis permintaan berikut:

Untuk panduan implementasi titik akhir lengkap, termasuk contoh kode enkripsi dan dekripsi dalam berbagai bahasa, lihat Menerapkan titik akhir Flow Anda di situs web Meta for Developers.

Langkah 2: Unggah kunci publik bisnis

Meta mengenkripsi semua permintaan pertukaran data end-to-end menggunakan kunci publik RSA (Rivest-Shamir-Adleman) Anda. Titik akhir Anda mendekripsi permintaan menggunakan kunci pribadi yang sesuai. AWS Social Pesan Pengguna Akhir mengunggah kunci publik ke Meta atas nama Anda tetapi tidak pernah mengakses atau menyimpan kunci pribadi.

Gunakan PutWhatsAppBusinessPublicKey API untuk mengunggah kunci publik untuk nomor telepon. Anda harus memberikan salah satu dari berikut ini:

Menyediakan keduanya atau tidak keduanya mengembalikanInvalidParametersException.

Modus PEM

Buat pasangan kunci RSA dan unggah kunci publik:

# Generate a key pair
openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -pubout -out public.pem

# Upload the public key
aws social-messaging put-whatsapp-business-public-key \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --business-public-key "$(cat public.pem)"

Simpan kunci pribadi dengan aman dan sediakan ke titik akhir Anda untuk dekripsi.

AWS KMS Modus

Buat kunci KMS RSA asimetris dan unggah ARN-nya:

# Create the KMS key
KMS_KEY_ARN=$(aws kms create-key \
    --key-spec RSA_2048 \
    --key-usage ENCRYPT_DECRYPT \
    --description "WhatsApp Dynamic Flow encryption key" \
    --query KeyMetadata.Arn --output text)

# Upload the KMS key ARN
aws social-messaging put-whatsapp-business-public-key \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --kms-key-arn $KMS_KEY_ARN

Kebijakan kunci KMS harus memberikan izin berikut:

Memverifikasi kunci

Gunakan GetWhatsAppBusinessPublicKey API untuk memverifikasi kunci yang disimpan dan memeriksa status penandatanganan Meta:

aws social-messaging get-whatsapp-business-public-key \
    --origination-phone-number-id {PHONE_NUMBER_ID}

Respons termasuk PEM yang disimpan dan status penandatanganan Meta (VALIDatauMISMATCH). MISMATCHStatus menunjukkan bahwa kunci yang disimpan tidak sesuai dengan yang diharapkan Meta. Unggah kunci baru jika Anda melihat status ini.

Langkah 3: Buat Alur dengan titik akhir

Saat membuat Dynamic Flow, berikan --endpoint-uri parameter dengan URL titik akhir HTTPS Anda. Flow JSON juga harus mendeklarasikandata_api_version, yang memberitahu Meta untuk memanggil titik akhir Anda selama sesi Flow.

aws social-messaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_dynamic_flow" \
    --categories '["OTHER"]' \
    --flow-json fileb://flow.json \
    --endpoint-uri "https://your-endpoint.example.com/flow"

Anda juga dapat menambahkan atau mengubah titik akhir pada ALUR DRAFT yang ada menggunakanUpdateWhatsAppFlow:

aws social-messaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --endpoint-uri "https://your-endpoint.example.com/flow"

Untuk memverifikasi versi endpoint dan data API yang dikonfigurasi untuk Flow, gunakanGetWhatsAppFlow:

aws social-messaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

Tanggapan termasuk endpointUri saat Meta memegangnya, yang di dataApiVersion deklarasikan dalam Flow JSON, dan yang saat ini dilampirkanapplication.

Langkah 4: Lampirkan aplikasi Meta Anda untuk verifikasi permintaan

Secara default, saat Anda membuat Flow melalui AWS Social Pesan Pengguna Akhir, itu terkait dengan aplikasi Meta layanan. Untuk memverifikasi bahwa permintaan pertukaran data ke titik akhir Anda berasal dari Meta, lampirkan aplikasi Meta Anda sendiri ke Flow. Tanpa aplikasi Anda sendiri yang dilampirkan, verifikasi asal permintaan tidak mungkin dilakukan. Melampirkan aplikasi Anda memberi Anda akses ke rahasia aplikasi yang diperlukan untuk memverifikasi header X-Hub-Signature-256 HMAC yang disertakan Meta pada setiap permintaan.

aws social-messaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --meta-app-id "{YOUR_META_APP_ID}"

Aplikasi Meta harus dimiliki oleh bisnis yang sama yang memiliki Akun WhatsApp Bisnis (WABA).

Anda dapat mengatur --endpoint-uri dan --meta-app-id dalam panggilan yang sama atau dalam panggilan terpisah. Kedua bidang tersebut independen.

Setelah melampirkan aplikasi Anda, verifikasi konfigurasi dengan menelepon GetWhatsAppFlow dan memeriksa application bidang dalam respons. Itu application.id harus cocok dengan ID aplikasi Meta yang Anda berikan.

Mengamankan titik akhir Anda

Karena Meta memanggil titik akhir Anda secara langsung, pertimbangkan praktik keamanan berikut:

Menulis JSON Aliran Dinamis

Dynamic Flow JSON berbeda dari JSON Flow statis dalam dua cara:

Contoh berikut menunjukkan Dynamic Flow JSON minimal dengan dua layar. Layar pertama mengumpulkan nama pengguna dan mengirimkannya ke titik akhir. Titik akhir mengembalikan salam yang dipersonalisasi di layar kedua.

{
    "version": "6.0",
    "data_api_version": "3.0",
    "routing_model": {
        "INPUT": ["RESULT"],
        "RESULT": []
    },
    "screens": [
        {
            "id": "INPUT",
            "title": "Welcome",
            "data": {
                "greeting": {
                    "type": "string",
                    "__example__": "Tell us your name"
                }
            },
            "layout": {
                "type": "SingleColumnLayout",
                "children": [
                    {
                        "type": "TextBody",
                        "text": "${data.greeting}"
                    },
                    {
                        "type": "Form",
                        "name": "input_form",
                        "children": [
                            {
                                "type": "TextInput",
                                "name": "user_name",
                                "label": "Your name",
                                "input-type": "text",
                                "required": true
                            },
                            {
                                "type": "Footer",
                                "label": "Submit",
                                "on-click-action": {
                                    "name": "data_exchange",
                                    "payload": {
                                        "user_name": "${form.user_name}"
                                    }
                                }
                            }
                        ]
                    }
                ]
            }
        },
        {
            "id": "RESULT",
            "title": "Hello",
            "terminal": true,
            "data": {
                "message": {
                    "type": "string",
                    "__example__": "Hello, World!"
                }
            },
            "layout": {
                "type": "SingleColumnLayout",
                "children": [
                    {
                        "type": "TextBody",
                        "text": "${data.message}"
                    },
                    {
                        "type": "Footer",
                        "label": "Done",
                        "on-click-action": {
                            "name": "complete",
                            "payload": {}
                        }
                    }
                ]
            }
        }
    ]
}

Untuk referensi skema Flow JSON lengkap, lihat Flow JSON di situs web Meta for Developers.

End-to-end contoh

Contoh berikut menunjukkan urutan lengkap panggilan API untuk mengatur dan menerbitkan Aliran Dinamis:

# 1. Upload the business public key (KMS mode)
aws social-messaging put-whatsapp-business-public-key \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --kms-key-arn {KMS_KEY_ARN}

# 2. Create the Dynamic Flow with an endpoint
FLOW_ID=$(aws social-messaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_dynamic_flow" \
    --categories '["OTHER"]' \
    --flow-json fileb://flow.json \
    --endpoint-uri "https://your-endpoint.example.com/flow" \
    --query flowId --output text)

# 3. Attach your Meta app for signature verification
aws social-messaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id $FLOW_ID \
    --meta-app-id "{YOUR_META_APP_ID}"

# 4. Publish the Flow
aws social-messaging publish-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id $FLOW_ID

# 5. Verify the configuration
aws social-messaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id $FLOW_ID

Setelah penerbitan, Flow tersedia untuk digunakan dalam pesan template. Untuk informasi selengkapnya tentang mengirim Alur, lihatMengirim WhatsApp Arus ke pengguna.