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

Menerima respons Flow dan perubahan status

Saat pengguna menyelesaikan Flow atau saat status Flow berubah,AWS End User Messaging Social akan mengirimkan notifikasi webhook melalui tujuan peristiwa yang sudah dikonfigurasi. Tidak diperlukan pengaturan tambahan atau jenis acara baru - Acara aliran dikirim secara otomatis ke tujuan acara yang sama yang Anda gunakan untuk pesan dan tanda terima pengiriman. Anda harus mengaktifkan tujuan acara untuk menerima pemberitahuan ini. Untuk informasi selengkapnya, lihat Tambahkan pesan dan tujuan acara ke AWS Pesan Pengguna Akhir Sosial.

Pesan respons aliran

Saat pengguna menyelesaikan Flow, Anda menerima pesan masuk dengan jenis interactive dan subtipe. nfm_reply response_jsonBidang berisi data yang dikirimkan oleh pengguna sebagai string JSON.

Contoh berikut menunjukkan payload webhook respons Flow:

{
    "messages": [
        {
            "from": "14085551234",
            "id": "wamid.XXX",
            "timestamp": "1234567890",
            "type": "interactive",
            "interactive": {
                "type": "nfm_reply",
                "nfm_reply": {
                    "response_json": "{\"name\":\"John Doe\",\"email\":\"john@example.com\",\"phone\":\"+14085551234\"}",
                    "body": "Sent",
                    "name": "flow"
                }
            }
        }
    ]
}

response_jsonBerisi pasangan kunci-nilai yang sesuai dengan nama bidang formulir yang ditentukan dalam Flow JSON Anda dan nilai yang dimasukkan oleh pengguna. Parse string JSON ini untuk mengekstrak data yang dikirimkan.

Pemberitahuan perubahan status alur

Saat Meta mengubah status Flow (misalnya, dari PUBLISH ke BLOCKED), Anda akan menerima pemberitahuan melalui tujuan acara. Contoh berikut menunjukkan payload perubahan status:

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "FLOW_STATUS_CHANGE",
                        "flow_id": "{FLOW_ID}",
                        "old_status": "PUBLISHED",
                        "new_status": "BLOCKED",
                        "reason": "Policy violation detected"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Pantau peristiwa perubahan status ini untuk mendeteksi kapan Meta memblokir atau membatasi Flow sehingga Anda dapat mengambil tindakan korektif.

Peringatan kedaluwarsa versi aliran

Meta mengirimkan webhook peringatan saat versi Flow JSON yang digunakan oleh Flow Anda mendekati tanggal akhir masa pakainya. Ketika versi kedaluwarsa, Anda tidak dapat mengirim Flow hingga Anda memperbarui ke versi yang lebih baru.

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "FLOW_VERSION_EXPIRY_WARNING",
                        "flow_id": "{FLOW_ID}",
                        "warning": "Your current Flow version will freeze in 21 days. You won't be able to send the Flow after it expires. Please migrate to the recommended version as soon as possible."
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Saat Anda menerima peringatan ini, perbarui Flow JSON Anda untuk menggunakan versi yang direkomendasikan (saat ini 7.3) UpdateWhatsAppFlowAssets dengan menelepon dengan JSON yang diperbarui, lalu publikasikan ulang Flow.