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 Alur atau ketika status Flow berubah, Social Pesan Pengguna AWS Akhir mengirimkan pemberitahuan webhook melalui tujuan acara yang sudah dikonfigurasi. Tidak diperlukan pengaturan tambahan atau jenis acara baru — Acara aliran dikirimkan 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 Soal Pengguna Akhir.

Pesan respons aliran

Saat pengguna menyelesaikan Alur, Anda menerima pesan masuk dengan jenis interactive dan sub nfm_reply tipe. Bid response_json ang 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"
                }
            }
        }
    ]
}

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

Pemberitahuan perubahan status aliran

Saat Meta mengubah status Flow (misalnya, dari DIPUBLIKASI ke DIBLOKIR), Anda menerima pemberitahuan melalui tujuan acara Anda. 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 Alur Anda sehingga Anda dapat mengambil tindakan korektif.

Pemberitahuan kesehatan titik akhir (Aliran dinamis)

Untuk Alur dinamis dengan titik akhir, Meta memantau kesehatan titik akhir dan mengirimkan pemberitahuan saat masalah terdeteksi. Anda menerimanya melalui tujuan acara yang dikonfigurasi.

Tingkat kesalahan titik akhir — Dikirim ketika tingkat kesalahan melebihi ambang batas dalam 30 menit terakhir:

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_ERROR_RATE",
                        "flow_id": "{FLOW_ID}",
                        "error_rate": 14.28,
                        "threshold": 10,
                        "alert_state": "ACTIVATED",
                        "errors": [
                            { "error_type": "CAPABILITY_ERROR", "error_rate": 66.66, "error_count": 2 },
                            { "error_type": "TIMEOUT", "error_rate": 33.33, "error_count": 1 }
                        ]
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Latensi titik akhir — Dikirim ketika latensi p90 melebihi ambang batas:

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_LATENCY",
                        "flow_id": "{FLOW_ID}",
                        "p90_latency": 8000,
                        "p50_latency": 500,
                        "requests_count": 34,
                        "threshold": 7000,
                        "alert_state": "ACTIVATED"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Ketersediaan titik akhir — Dikirim saat ketersediaan titik akhir turun di bawah ambang batas:

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_AVAILABILITY",
                        "flow_id": "{FLOW_ID}",
                        "availability": 75,
                        "threshold": 90,
                        "alert_state": "ACTIVATED"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Pantau peristiwa ini untuk mendeteksi dan menyelesaikan masalah titik akhir sebelum Meta memblokir atau membatasi Flow Anda. Untuk informasi selengkapnya tentang mengatur Aliran dinamis, lihatMenyiapkan Aliran Dinamis.

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 sampai 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 disarankan (saat ini 7.3) UpdateWhatsAppFlowAssets dengan memanggil JSON yang diperbarui, lalu publikasikan ulang Flow.