> ## Documentation Index
> Fetch the complete documentation index at: https://docs.csku.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pengenalan Webhook

> Notifikasi real-time untuk event CSKU AI

## Pengenalan

Sistem webhook CSKU AI memungkinkan Anda menerima notifikasi real-time tentang event yang terjadi dalam percakapan chatbot AI Anda. Webhook memungkinkan Anda membangun integrasi yang bereaksi terhadap pesan pelanggan, respons AI, aktivitas agen, dan perubahan status perangkat.

<CardGroup cols={2}>
  <Card title="Mulai Cepat" icon="rocket" href="/webhooks/configuration">
    Siapkan webhook dalam hitungan menit
  </Card>

  <Card title="Event" icon="zap" href="/webhooks/events/channel-message-in">
    Jelajahi event webhook
  </Card>

  <Card title="Autentikasi" icon="lock" href="/webhooks/authentication">
    Amankan webhook Anda
  </Card>

  <Card title="Contoh" icon="code" href="/webhooks/examples">
    Contoh kode dalam berbagai bahasa
  </Card>
</CardGroup>

## Cara Kerja Webhook

<Steps>
  <Step title="Konfigurasi">
    Siapkan URL webhook Anda di Settings → Webhook
  </Step>

  <Step title="Terima">
    Dapatkan request HTTP POST dengan data event
  </Step>

  <Step title="Proses">
    Tangani payload di aplikasi Anda
  </Step>

  <Step title="Respons">
    Kembalikan HTTP 200 OK untuk mengonfirmasi penerimaan
  </Step>
</Steps>

## Alur Webhook

```
Pesan Pelanggan
       ↓
   Platform CSKU AI
       ↓
   Proses Pesan
       ↓
   Trigger Webhook
       ↓
   HTTP POST → URL Webhook Anda
       ↓
   Server Anda Memproses Event
       ↓
   Respons 200 OK
```

## Event yang Didukung

<Callout>
  Webhook mendukung berbagai jenis event untuk memberikan informasi tentang semua aktivitas penting.
</Callout>

| Event                  | Deskripsi                  | Trigger                  |
| ---------------------- | -------------------------- | ------------------------ |
| `channel.message_in`   | Pesan masuk dari pelanggan | Pelanggan mengirim pesan |
| `agent.message_out`    | Pesan dari agen manusia    | Agen mengirim pesan      |
| `ai.message_generated` | Respons dari agen AI       | AI menghasilkan respons  |
| `device.connected`     | Perangkat online           | Perangkat terhubung      |
| `device.disconnected`  | Perangkat offline          | Perangkat terputus       |

<Callout type="info">
  Pelajari lebih lanjut tentang setiap jenis event di [Bagian Event](/webhooks/events/channel-message-in).
</Callout>

## Status Pengiriman Pesan

CSKU AI melacak status pengiriman pesan keluar melalui webhook. Setiap status mewakili tahap dalam siklus pengiriman pesan.

| Status      | Deskripsi                                                                           | Indikator Visual        |
| ----------- | ----------------------------------------------------------------------------------- | ----------------------- |
| `pending`   | Pesan tersimpan di database, menunggu untuk dikirim                                 | Centang abu-abu tunggal |
| `process`   | Pesan dikirim ke API channel (WABA, Instagram, Facebook, WhatsApp)                  | Centang abu-abu tunggal |
| `sent`      | Pesan berhasil terkirim ke penerima                                                 | Centang abu-abu ganda   |
| `delivered` | Pesan dikonfirmasi terkirim ke perangkat penerima                                   | Centang abu-abu ganda   |
| `read`      | Penerima telah membaca pesan (via webhook dari WABA, Instagram, WhatsApp, Facebook) | Centang biru ganda      |
| `failed`    | Pengiriman pesan gagal                                                              | Indikator merah         |

### Diagram Alur Status

```
pending → process → sent/delivered → read
    ↓         ↓
  failed    failed
```

<Callout type="info">
  Status `read` hanya tersedia untuk channel yang mendukung tanda baca: WhatsApp Business API (WABA), Instagram, WhatsApp, dan Facebook.
</Callout>

## Persyaratan

Sebelum menyiapkan webhook, pastikan Anda memiliki:

* Endpoint HTTPS yang dapat diakses publik (untuk produksi)
* Server yang dapat menerima request POST
* Business ID dan Secret Key Anda untuk autentikasi

## Manfaat

<AccordionGroup>
  <Accordion title="Notifikasi Real-Time">
    Terima notifikasi instan saat event terjadi, menghilangkan kebutuhan untuk polling.
  </Accordion>

  <Accordion title="Alur Kerja Otomatis">
    Trigger aksi otomatis berdasarkan event tertentu, seperti mengirim email follow-up atau memperbarui CRM Anda.
  </Accordion>

  <Accordion title="Sinkronisasi Data">
    Jaga sistem eksternal Anda tetap sinkron dengan data CSKU AI secara otomatis.
  </Accordion>

  <Accordion title="Analitik Lebih Baik">
    Kumpulkan event webhook untuk analitik dan pelaporan kustom.
  </Accordion>
</AccordionGroup>

## Langkah Selanjutnya

<CardGroup cols={2}>
  <Card title="Siapkan Webhook" icon="settings" href="/webhooks/configuration">
    Konfigurasi endpoint webhook Anda
  </Card>

  <Card title="Autentikasi" icon="shield" href="/webhooks/authentication">
    Pelajari cara mengamankan webhook
  </Card>

  <Card title="Referensi Event" icon="list" href="/webhooks/events/channel-message-in">
    Dokumentasi event lengkap
  </Card>

  <Card title="Praktik Terbaik" icon="check-circle" href="/webhooks/best-practices">
    Pastikan penanganan webhook yang andal
  </Card>
</CardGroup>

## Pertimbangan Keamanan

<Callout type="warning">
  <strong>Keamanan Sangat Penting</strong>
</Callout>

* Selalu validasi header `Authorization`
* Gunakan HTTPS untuk endpoint produksi
* Jangan pernah log informasi sensitif dari payload
* Rotasi secret key Anda secara berkala
* Implementasikan rate limiting pada endpoint Anda

## Dukungan

Butuh bantuan dengan webhook?

<CardGroup cols={2}>
  <Card title="Email Support" icon="envelope" href="mailto:support@csku.ai">
    [support@csku.ai](mailto:support@csku.ai)
  </Card>

  <Card title="Dashboard" icon="layout" href="https://dashboard.csku.ai">
    Kelola webhook di dashboard
  </Card>
</CardGroup>