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.

Sediakan di papan pemuka Lihat Events API

Webhook POST https://seusistema.com/webhooks/wpp

{
  "id": "evt_0123456789abcdef",
  "event": "MESSAGE_DELIVERED",
  "timestamp": "2026-09-15T10:30:00Z",
  "message": {
    "id": "msg_123",
    "status": "delivered",
    "phone": "5511999999999"
  }
}

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.

01 Anda memberikan URL

Daftarkan endpoint HTTPS dari sistem anda di papan pemuka untuk menerima maklum balas.

02 Pilih acara

Hidupkan hanya status yang sistem anda perlu proses untuk mengelakkan gangguan operasi.

03 Status berubah

Penciptaan, penghantaran, pembacaan atau ralat dinormalisasikan dengan cara yang sama tanpa mengira sambungan yang dipilih.

04 Terima dan jejak

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.

HTTPS

Gunakan URL yang selamat, awam dan stabil untuk menerima acara panggilan balik.

Balas pantas

Balas dengan HTTP 200 atau 204 selepas menerima acara dan proses tugas jangka panjang dalam barisan dalaman.

Idempoten (Idempotency)

Gunakan pengecam mesej dan acara untuk mengelakkan penduaan semasa penghantaran semula.

Log

Log payload, tarikh, status HTTP dan hasil pemprosesan untuk tujuan audit.

Amaran

Gunakan MESSAGE_ERROR untuk memberi amaran kepada sokongan atau operasi tentang kegagalan yang dikembalikan oleh mana-mana sambungan.

Pemisahan

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.

Configurar webhooks