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

# Ambil pesan dari chat tertentu

> Ambil pesan dari percakapan chat tertentu dengan opsi pemfilteran



## OpenAPI

````yaml /id/openapi.yml get /chat/{chat_jid}/messages
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:
  /chat/{chat_jid}/messages:
    get:
      tags:
        - chat
      summary: Ambil pesan dari chat tertentu
      description: Ambil pesan dari percakapan chat tertentu dengan opsi pemfilteran
      operationId: getChatMessages
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - in: path
          name: chat_jid
          schema:
            type: string
          required: true
          description: >-
            JID chat (misalnya phone@s.whatsapp.net untuk individu atau
            groupid@g.us untuk grup). Nilai dengan percent-encoding (misalnya
            groupid%40g.us) diterima.
          example: 6289685028129@s.whatsapp.net
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            maximum: 100
          description: Jumlah maksimal pesan yang dikembalikan
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
          description: Jumlah pesan yang dilewati (untuk paginasi)
        - name: start_time
          in: query
          schema:
            type: string
            format: date-time
          description: Filter pesan mulai dari timestamp ini (format ISO 8601)
        - name: end_time
          in: query
          schema:
            type: string
            format: date-time
          description: Filter pesan hingga timestamp ini (format ISO 8601)
        - name: media_only
          in: query
          schema:
            type: boolean
            default: false
          description: Hanya kembalikan pesan dengan konten media
        - name: is_from_me
          in: query
          schema:
            type: boolean
          description: >-
            Filter pesan berdasarkan pengirim (true untuk pesan yang Anda kirim,
            false untuk pesan yang diterima). Jika media_only=true dan
            isFromMe=false diberikan bersamaan, media_only diprioritaskan dan
            akan mengembalikan semua pesan media tanpa memandang pengirim.
        - name: search
          in: query
          schema:
            type: string
          description: Cari pesan berdasarkan teks konten
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatMessagesResponse'
        '400':
          description: Permintaan Tidak Valid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '401':
          description: Tidak Terautentikasi
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '404':
          description: Chat Tidak Ditemukan
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorNotFound'
        '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:
    ChatMessagesResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success get chat messages
        results:
          type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/ChatMessage'
            pagination:
              type: object
              properties:
                limit:
                  type: integer
                  example: 50
                offset:
                  type: integer
                  example: 0
                total:
                  type: integer
                  example: 1250
            chat_info:
              $ref: '#/components/schemas/Chat'
    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
    ErrorUnauthorized:
      type: object
      properties:
        code:
          type: string
          example: 401
          description: Kode Status HTTP
        message:
          type: string
          example: Unauthorized access
          description: Pesan kesalahan terperinci
        results:
          type: object
          example: null
          description: data tambahan
    ErrorNotFound:
      type: object
      properties:
        code:
          type: string
          example: 404
          description: Kode Status HTTP
        message:
          type: string
          example: Chat not found
          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
    ChatMessage:
      type: object
      properties:
        id:
          type: string
          example: 3EB0B430B6F8F1D0E053AC120E0A9E5C
          description: ID pesan
        chat_jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: JID chat tempat pesan ini berada
        sender_jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: JID pengirim
        sender_display_name:
          type: string
          example: Saved Contact
          description: >-
            Label pengirim yang mudah dibaca, ditentukan secara dinamis saat
            respons ini dibuat dan tidak disimpan bersama pesan. Untuk pengirim
            lain, urutan prioritasnya adalah nama lengkap kontak tersimpan, lalu
            push name kontak tersimpan, nama bisnis, bagian pengguna JID, dan
            JID mentah. Untuk akun aktif, urutan prioritasnya adalah nama
            tampilan perangkat (dengan fallback ke push name akun tersimpan),
            bagian pengguna JID akun, JID akun, bagian pengguna JID pengirim,
            dan JID pengirim mentah. Karena itu, perubahan nama kontak dapat
            mengubah label yang dikembalikan untuk pesan historis. `sender_jid`
            tetap menjadi pengenal pengirim yang stabil.
        content:
          type: string
          example: Hello, how are you?
          description: Isi teks pesan
        timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Timestamp pesan
        is_from_me:
          type: boolean
          example: false
          description: Apakah pesan ini dikirim oleh pengguna saat ini
        media_type:
          type: string
          example: image
          nullable: true
          description: >-
            Jenis media (image, video, audio, document, dll.). Nilai `call`
            menunjukkan log panggilan masuk yang tersimpan.
        reactions:
          type: array
          description: Reaksi emoji yang melekat pada pesan ini
          items:
            $ref: '#/components/schemas/ChatReaction'
        call_metadata:
          type: string
          example: '{"call_id":"ABC","auto_rejected":false}'
          description: >-
            String JSON berisi detail panggilan saat media_type bernilai `call`.
            Tidak disertakan jika tidak berlaku (sesuai json omitempty Go).
        referral_metadata:
          type: string
          example: '{"ctwa_clid":"clid_123","source_app":"whatsapp"}'
          description: >-
            String JSON berisi detail rujukan/atribusi Meta Ads saat pesan
            berasal dari iklan Click-to-WhatsApp. Tidak disertakan jika tidak
            berlaku (sesuai json omitempty Go).
        context_metadata:
          type: string
          example: '{"replied_to_id":"AC625C65EA7143E71D784176C4A90A93"}'
          description: >-
            String JSON berisi ID pesan yang dibalas saat konteks balasan
            diketahui. Direkam dari pesan langsung, pesan terkirim, dan pesan
            sinkronisasi riwayat. Tidak disertakan jika konteks balasan tidak
            tersedia, termasuk baris lama yang tersimpan hingga baris tersebut
            dimasukkan kembali beserta konteksnya.
        filename:
          type: string
          example: photo.jpg
          nullable: true
          description: Nama file asli untuk pesan media
        url:
          type: string
          example: https://media.example.com/file.jpg
          nullable: true
          description: URL file media
        file_length:
          type: integer
          example: 1024768
          nullable: true
          description: Ukuran file dalam byte untuk pesan media
        created_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Timestamp pembuatan rekaman
        updated_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Timestamp pembaruan terakhir rekaman
    Chat:
      type: object
      properties:
        jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: Pengenal JID chat
        name:
          type: string
          example: John Doe
          description: Nama tampilan chat
        last_message_time:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Timestamp pesan terakhir
        ephemeral_expiration:
          type: integer
          example: 0
          description: Waktu kedaluwarsa pesan sementara dalam detik (0 = dinonaktifkan)
        created_at:
          type: string
          format: date-time
          example: '2024-01-10T08:00:00Z'
          description: Timestamp pembuatan chat
        updated_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Timestamp pembaruan terakhir chat
        archived:
          type: boolean
          example: false
          description: Apakah chat diarsipkan
    ChatReaction:
      type: object
      properties:
        emoji:
          type: string
          example: 👍
          description: Emoji yang digunakan dalam reaksi
        sender_jid:
          type: string
          example: 628123456789@s.whatsapp.net
          description: JID pengguna yang memberikan reaksi
        sender_display_name:
          type: string
          example: Saved Contact
          description: >-
            Label pengirim yang mudah dibaca, ditentukan secara dinamis saat
            respons ini dibuat dan tidak disimpan bersama reaksi. Untuk pengirim
            lain, urutan prioritasnya adalah nama lengkap kontak tersimpan, lalu
            push name kontak tersimpan, nama bisnis, bagian pengguna JID, dan
            JID mentah. Untuk akun aktif, urutan prioritasnya adalah nama
            tampilan perangkat (dengan fallback ke push name akun tersimpan),
            bagian pengguna JID akun, JID akun, bagian pengguna JID pengirim,
            dan JID pengirim mentah. Karena itu, perubahan nama kontak dapat
            mengubah label yang dikembalikan untuk reaksi historis. `sender_jid`
            tetap menjadi pengenal pengirim yang stabil.
        is_from_me:
          type: boolean
          example: false
          description: Apakah reaksi diberikan oleh pengguna saat ini
        timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:31:00Z'
          description: Waktu reaksi diterima
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Ambil daftar chat](https://gowa-docs.mintlify.site/id/api-reference/chat/ambil-daftar-chat.md)
- [Minta riwayat chat yang lebih lama dari ponsel](https://gowa-docs.mintlify.site/id/api-reference/chat/minta-riwayat-chat-yang-lebih-lama-dari-ponsel.md)
- [Menerima pesan](https://gowa-docs.mintlify.site/id/examples/receiving-messages.md)
- [Ambil status koneksi perangkat](https://gowa-docs.mintlify.site/id/api-reference/device/ambil-status-koneksi-perangkat.md)
- [Ambil informasi grup dari tautan undangan](https://gowa-docs.mintlify.site/id/api-reference/group/ambil-informasi-grup-dari-tautan-undangan.md)


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