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

# Endpoint webhook Chatwoot

> Menerima event webhook dari Chatwoot dan mengirim pesan ke WhatsApp.
Konfigurasikan URL ini di pengaturan webhook inbox Chatwoot Anda.

Saat CHATWOOT_WEBHOOK_SECRET ditetapkan, permintaan harus membuktikan bahwa
rahasia tersebut diketahui. Direkomendasikan: tanda tangan bawaan Chatwoot, yang dikirim oleh Chatwoot saat saluran API
memiliki rahasia webhook — `X-Chatwoot-Timestamp` (detik Unix) dan
`X-Chatwoot-Signature: sha256=<hex HMAC-SHA256 of "<timestamp>.<raw body>">`.
Timestamp harus berada dalam rentang CHATWOOT_WEBHOOK_SIGNATURE_TOLERANCE (default
5m) dari waktu server. Juga diterima: `X-Hub-Signature-256`
(HMAC-SHA256 dari body mentah), rahasia dalam `X-Chatwoot-Webhook-Secret`
atau `X-Gowa-Chatwoot-Secret`, atau parameter kueri `secret` (tidak disarankan:
rahasia tersebut akan muncul di URL dan log).

Rahasia yang berlaku adalah rahasia perangkat tujuan perutean
payload: `webhook_secret` dalam konfigurasi perangkat tersebut jika tersedia (rahasia
global tidak diterima untuk perangkat tersebut), atau CHATWOOT_WEBHOOK_SECRET
jika tidak tersedia dan saat tidak ada perangkat yang dapat ditentukan. Permintaan bertanda tangan Chatwoot yang
sudah diterima (dijawab dengan 2xx) dalam rentang toleransi
diakui dengan 200 dan tidak diproses ulang. Permintaan yang dijawab
dengan status lain tidak diingat, sehingga pengiriman ulang permintaan
yang identik akan diproses.




## OpenAPI

````yaml /id/openapi.yml post /chatwoot/webhook
openapi: 3.0.0
info:
  title: WhatsApp API MultiDevice
  version: 9.7.0
  description: >
    API ini digunakan untuk mengirim pesan WhatsApp melalui API.


    Dashboard web merupakan proyek terpisah (gowa-ui); server mengunduh aset
    rilis

    terbarunya dan menyajikannya di `/` (atau mengembalikan banner JSON saat

    APP_UI_ENABLED=false).


    Cakupan perangkat:

    - Kirim `X-Device-Id` pada semua panggilan REST yang memiliki cakupan
    perangkat.

    - WebSocket: hubungkan ke `/ws?device_id=<id>`.

    - Autentikasi WebSocket (saat autentikasi dasar diaktifkan): browser tidak
    dapat menyetel
      header Authorization pada koneksi WebSocket, sehingga sertakan juga
      `&authorization=<base64(user:pass)>` dalam query string. Gunakan TLS di
      produksi karena kredensial terlihat di URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Koneksi awal ke server WhatsApp
  - name: device
    description: Pengelolaan perangkat untuk dukungan multi-perangkat
  - name: user
    description: Mengambil informasi
  - name: send
    description: Kirim pesan (teks/gambar/berkas/video).
  - name: message
    description: Manipulasi pesan (cabut/beri reaksi/perbarui).
  - name: call
    description: Pengelolaan panggilan (tolak panggilan masuk)
  - name: chat
    description: Percakapan chat dan perpesanan
  - name: group
    description: Pengaturan grup
  - name: newsletter
    description: Pengaturan newsletter
  - name: chatwoot
    description: Integrasi Chatwoot untuk dukungan pelanggan
paths:
  /chatwoot/webhook:
    post:
      tags:
        - chatwoot
      summary: Endpoint webhook Chatwoot
      description: >
        Menerima event webhook dari Chatwoot dan mengirim pesan ke WhatsApp.

        Konfigurasikan URL ini di pengaturan webhook inbox Chatwoot Anda.


        Saat CHATWOOT_WEBHOOK_SECRET ditetapkan, permintaan harus membuktikan
        bahwa

        rahasia tersebut diketahui. Direkomendasikan: tanda tangan bawaan
        Chatwoot, yang dikirim oleh Chatwoot saat saluran API

        memiliki rahasia webhook — `X-Chatwoot-Timestamp` (detik Unix) dan

        `X-Chatwoot-Signature: sha256=<hex HMAC-SHA256 of "<timestamp>.<raw
        body>">`.

        Timestamp harus berada dalam rentang
        CHATWOOT_WEBHOOK_SIGNATURE_TOLERANCE (default

        5m) dari waktu server. Juga diterima: `X-Hub-Signature-256`

        (HMAC-SHA256 dari body mentah), rahasia dalam
        `X-Chatwoot-Webhook-Secret`

        atau `X-Gowa-Chatwoot-Secret`, atau parameter kueri `secret` (tidak
        disarankan:

        rahasia tersebut akan muncul di URL dan log).


        Rahasia yang berlaku adalah rahasia perangkat tujuan perutean

        payload: `webhook_secret` dalam konfigurasi perangkat tersebut jika
        tersedia (rahasia

        global tidak diterima untuk perangkat tersebut), atau
        CHATWOOT_WEBHOOK_SECRET

        jika tidak tersedia dan saat tidak ada perangkat yang dapat ditentukan.
        Permintaan bertanda tangan Chatwoot yang

        sudah diterima (dijawab dengan 2xx) dalam rentang toleransi

        diakui dengan 200 dan tidak diproses ulang. Permintaan yang dijawab

        dengan status lain tidak diingat, sehingga pengiriman ulang permintaan

        yang identik akan diproses.
      operationId: chatwootWebhook
      parameters:
        - name: X-Chatwoot-Signature
          in: header
          description: >-
            Tanda tangan Chatwoot: sha256=<hex HMAC-SHA256 of "<timestamp>.<raw
            body>" keyed with the webhook secret>
          schema:
            type: string
        - name: X-Chatwoot-Timestamp
          in: header
          description: Waktu Unix (detik) saat webhook ditandatangani
          schema:
            type: string
        - name: secret
          in: query
          description: Rahasia webhook. Tidak disarankan; utamakan header tanda tangan.
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: Payload webhook Chatwoot (lihat dokumentasi Chatwoot)
      responses:
        '200':
          description: Webhook berhasil diproses
        '401':
          description: >-
            Rahasia atau tanda tangan tidak ada atau tidak valid untuk perangkat
            tujuan perutean permintaan, atau timestamp tanda tangan berada di
            luar rentang toleransi
        '503':
          description: >-
            Perangkat tidak tersedia, konfigurasi perangkat tujuan tidak dapat
            dibaca, atau permintaan bertanda tangan yang identik masih diproses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
components:
  schemas:
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: Kode Status HTTP
        message:
          type: string
          example: field cannot be blank
          description: Pesan kesalahan terperinci
        results:
          type: object
          example: null
          description: data tambahan
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Endpoint webhook Chatwoot per perangkat](https://gowa-docs.mintlify.site/id/api-reference/chatwoot/endpoint-webhook-chatwoot-per-perangkat.md)
- [Integrasi Chatwoot](https://gowa-docs.mintlify.site/id/integrations/chatwoot.md)
- [Webhook](https://gowa-docs.mintlify.site/id/concepts/webhooks.md)
- [Autentikasi API](https://gowa-docs.mintlify.site/id/api-reference/authentication.md)
- [Daftar konfigurasi Chatwoot per perangkat](https://gowa-docs.mintlify.site/id/api-reference/chatwoot/daftar-konfigurasi-chatwoot-per-perangkat.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.