> ## 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.

# Tarik Pesan

> Tarik (hapus untuk semua orang) pesan. Secara default, menarik pesan milik bot sendiri.
Jika pesan tujuan dikirim oleh pengguna lain dan tersedia di penyimpanan chat,
pengirim asli ditentukan secara otomatis sehingga bot admin grup dapat menarik
pesan anggota lain (untuk penanganan spam). Server WhatsApp menolak
permintaan jika bot bukan admin grup.




## OpenAPI

````yaml /id/openapi.yml post /message/{message_id}/revoke
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:
  /message/{message_id}/revoke:
    post:
      tags:
        - message
      summary: Tarik Pesan
      description: >
        Tarik (hapus untuk semua orang) pesan. Secara default, menarik pesan
        milik bot sendiri.

        Jika pesan tujuan dikirim oleh pengguna lain dan tersedia di penyimpanan
        chat,

        pengirim asli ditentukan secara otomatis sehingga bot admin grup dapat
        menarik

        pesan anggota lain (untuk penanganan spam). Server WhatsApp menolak

        permintaan jika bot bukan admin grup.
      operationId: revokeMessage
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - in: path
          name: message_id
          schema:
            type: string
          required: true
          description: ID pesan
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                phone:
                  type: string
                  example: 6289685024051@s.whatsapp.net
                  description: Nomor telepon dengan kode negara
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendResponse'
        '400':
          description: Permintaan Tidak Valid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Kesalahan Internal Server
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Pengenal perangkat untuk dukungan multi-device. Wajib jika beberapa
        perangkat terdaftar.

        Jika hanya satu perangkat terdaftar, perangkat tersebut digunakan
        sebagai default.

        Dapat juga diberikan sebagai parameter kueri `device_id`.
      schema:
        type: string
        example: my-device-id
  schemas:
    SendResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success
        results:
          type: object
          properties:
            message_id:
              type: string
              example: 3EB0B430B6F8F1D0E053AC120E0A9E5C
              description: Tidak disertakan untuk pengiriman terjadwal
            status:
              type: string
              example: <feature> success ....
            schedule_id:
              type: string
              example: 0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10
              description: >-
                Hanya untuk pengiriman terjadwal. Gunakan dengan rute
                /send/schedules.
            scheduled_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: Hanya untuk pengiriman terjadwal. Waktu pengiriman pertama.
            next_run_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: >-
                Hanya untuk pengiriman terjadwal. Waktu worker mengirim
                berikutnya.
    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
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: SYSTEM_CODE_ERROR
        message:
          type: string
          example: you are not loggin
          description: Pesan kesalahan terperinci
        results:
          type: object
          example: null
          description: data tambahan
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Integrasi Chatwoot](https://gowa-docs.mintlify.site/id/integrations/chatwoot.md)
- [Menerima pesan](https://gowa-docs.mintlify.site/id/examples/receiving-messages.md)
- [Mengirim Pesan](https://gowa-docs.mintlify.site/id/examples/sending-messages.md)
- [Teruskan Pesan](https://gowa-docs.mintlify.site/id/api-reference/message/teruskan-pesan.md)
- [Kirim pesan](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-pesan.md)


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