---
title: "Webhook"
description: "Webhook adalah permintaan HTTP yang dikirim platform ke URL yang Anda tentukan setiap kali sebuah event terjadi, misalnya pesan terkirim, dibaca, atau gagal, maupun balasan pelanggan yang masuk. Dengan begitu, sistem Anda langsung mengetahuinya tanpa perlu polling."
canonical: "https://omnichannels.ai/id/glossary/webhook/"
language: "id"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Webhook

Canonical: https://omnichannels.ai/id/glossary/webhook/
Language: id
Publisher: OmniChannels.ai by BroadNet Technologies

**Definisi:** Webhook adalah permintaan HTTP yang dikirim platform ke URL yang Anda tentukan setiap kali sebuah event terjadi, misalnya pesan terkirim, dibaca, atau gagal, maupun balasan pelanggan yang masuk. Dengan begitu, sistem Anda langsung mengetahuinya tanpa perlu polling.

Anda mendaftarkan sebuah endpoint (misalnya https://example.com/hooks/messaging). Saat event terjadi, platform mengirim permintaan POST dengan body JSON yang menjelaskan event tersebut: ID pesan, status, timestamp, kanal, dan detail error. Server Anda sebaiknya merespons dengan cepat menggunakan kode 2xx, lalu memproses event secara asinkron.

Rancang sistem untuk kondisi pengiriman di dunia nyata: webhook bisa datang terlambat, tidak berurutan, atau lebih dari satu kali. Gunakan ID pesan dan status untuk menghindari duplikasi, jangan pernah memundurkan status (misalnya dari READ ke DELIVERED), dan pastikan handler Anda idempoten sehingga aman untuk dicoba ulang.

Keamanan: terima hanya HTTPS, verifikasi signature atau shared secret pada setiap permintaan, dan jangan percaya payload sebelum terverifikasi. Standar industri seperti spesifikasi Standard Webhooks menjelaskan pola umum untuk penandatanganan (signing) dan percobaan ulang (retry).

Dalam layanan pesan, webhook menjadi sumber data untuk laporan pengiriman (DLR), tingkat baca, balasan masuk, opt-out, dan keputusan fallback (kanal cadangan).

OmniChannels.ai mengirim webhook untuk status pengiriman (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED), yang dinormalisasi ke satu format di semua kanal.

## Contoh

```
{"messageId":"msg_123","channel":"whatsapp","status":"DELIVERED","timestamp":"2026-10-10T09:15:02Z"}
```

## Sumber

- [Standard Webhooks specification](https://www.standardwebhooks.com/)