Daftarkan endpoint HTTPS dari sistem anda di papan pemuka untuk menerima maklum balas.
Webhook status
Terima status mesej WhatsApp dalam sistem anda.
Tetapkan URL untuk menerima acara piawai bagi penciptaan, penghantaran, dibaca dan ralat, serta semak sejarah penghantaran melalui API tanpa mengira sambungan yang dipilih.
Aliran
WPP Marketing memberitahu sistem anda apabila status berubah.
Webhook status berguna untuk audit, penyelarasan, papan pemuka dalaman, sokongan dan peraturan dalam sistem anda sendiri.
Webhook memberitahu hasil sesuatu mesej; ia bukan permintaan penghantaran. Gunakan Messaging API untuk menghantar mesej dan Events API untuk mencetuskan automasi dengan acara komersial yang disokong.
Hidupkan hanya status yang sistem anda perlu proses untuk mengelakkan gangguan operasi.
Penciptaan, penghantaran, pembacaan atau ralat dinormalisasikan dengan cara yang sama tanpa mengira sambungan yang dipilih.
Endpoint anda memproses payload dan sejarah penghantaran menjadi tersedia di papan pemuka dan melalui GET /webhooks.
Acara tersedia dan semakan penghantaran.
Keempat acara menggunakan kontrak yang sama pada sebarang sambungan, dan API membolehkan pertanyaan keputusan setiap percubaan penghantaran.
POST
MESSAGE_CREATED
Mesej telah dibuat dalam aliran dan menerima pengecam untuk penjejakan.
Criação
POST
MESSAGE_DELIVERED
Mesej disampaikan kepada penerima apabila saluran mengembalikan pengesahan.
Entrega
POST
MESSAGE_READ
Mesej dibaca apabila resit bacaan tersedia.
Leitura
POST
MESSAGE_ERROR
Mesej mengalami ralat semasa penghantaran, pengesahan, atau pemprosesan.
Erro
GET
/webhooks
Lihat sejarah penghantaran dengan status, percubaan, respons HTTP dan penomboran muka. Memerlukan skop webhooks:read.
Logs
Amalan terbaik
Sediakan endpoint anda untuk menerima acara yang berulang dan tidak mengikut turutan.
Webhook adalah penghantaran antara sistem. Backend anda harus memberi respons dengan cepat, merekod log dan memproses secara idempotent.
Daftarkan URL HTTPS awam dan dayakan acara di papan pemuka. Kontrak semasa tidak menghantar tandatangan HMAC; konfigurasikan perlindungan dan pengesahan sesuai untuk penerima tanpa menganggap tandatangan yang tidak wujud.
Balas dengan HTTP 2xx dalam masa 15 saat dan proses tugas jangka panjang dalam barisan dalaman. Pengalihan tidak diikuti.
Gunakan id acara, yang juga dihantar dalam Webhook-Id, untuk mengelakkan pemprosesan berganda dan menerima acara di luar susunan. Webhook-Attempt menunjukkan nombor percubaan. Hanya acara yang diaktifkan direkod dan dihantar.
Lihat percubaan dan respons HTTP pada GET /webhooks dengan webhooks:read. Rekod yang selesai, dihantar atau gagal secara tetap disimpan selama 30 hari. Lindungi data peribadi dan kandungan mesej dalam log anda sendiri.
Kegagalan sambungan, tamat masa dan respons 408, 425, 429 atau 5xx boleh mencetuskan sehingga tujuh percubaan jumlahnya, dengan selang 1, 5 dan 15 minit, dan 1, 6 dan 24 jam. Retry-After dihormati sehingga 24 jam. Ralat 4xx lain menghentikan penghantaran.
Webhook status ialah respons daripada WPP Marketing. Untuk menghantar acara komersial kedai, gunakan Events API.
Mahukah anda menjejak penghantaran dan ralat dalam sistem anda?
Sediakan URL di papan pemuka, pilih status dan jejak penghantaran dalam laporan webhook.