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

# Minta riwayat chat yang lebih lama dari ponsel

> Meminta pesan yang lebih lama dari suatu chat ke ponsel sesuai kebutuhan (seperti yang dilakukan WhatsApp Web saat Anda menggulir ke atas / "muat pesan yang lebih lama"). Permintaan menggunakan pesan tertua yang saat ini tersimpan secara lokal untuk chat tersebut sebagai acuan, sehingga chat harus sudah memiliki setidaknya satu pesan tersimpan. Ponsel merespons secara asinkron dengan event sinkronisasi riwayat yang disimpan ke penyimpanan chat; endpoint ini hanya mengonfirmasi bahwa permintaan telah dikirim, dan tidak langsung mengembalikan pesan yang lebih lama.



## OpenAPI

````yaml /id/openapi.yml post /chat/{chat_jid}/history
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}/history:
    post:
      tags:
        - chat
      summary: Minta riwayat chat yang lebih lama dari ponsel
      description: >-
        Meminta pesan yang lebih lama dari suatu chat ke ponsel sesuai kebutuhan
        (seperti yang dilakukan WhatsApp Web saat Anda menggulir ke atas / "muat
        pesan yang lebih lama"). Permintaan menggunakan pesan tertua yang saat
        ini tersimpan secara lokal untuk chat tersebut sebagai acuan, sehingga
        chat harus sudah memiliki setidaknya satu pesan tersimpan. Ponsel
        merespons secara asinkron dengan event sinkronisasi riwayat yang
        disimpan ke penyimpanan chat; endpoint ini hanya mengonfirmasi bahwa
        permintaan telah dikirim, dan tidak langsung mengembalikan pesan yang
        lebih lama.
      operationId: requestChatHistory
      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
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                count:
                  type: integer
                  default: 50
                  minimum: 0
                  maximum: 500
                  example: 50
                  description: >-
                    Jumlah pesan yang lebih lama untuk diminta dari ponsel.
                    Abaikan, atau kirim 0, untuk menggunakan nilai default 50.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestChatHistoryResponse'
        '400':
          description: >-
            Permintaan Tidak Valid (misalnya chat_jid tidak diisi, count di luar
            rentang, atau chat tidak memiliki pesan tersimpan sebagai acuan)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '401':
          description: Tidak Terautentikasi
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '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:
    RequestChatHistoryResponse:
      type: object
      properties:
        status:
          type: integer
          example: 200
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: History sync requested successfully
        results:
          type: object
          properties:
            status:
              type: string
              example: requested
            chat_jid:
              type: string
              example: 6289685028129@s.whatsapp.net
            requested_count:
              type: integer
              example: 50
            anchor_message_id:
              type: string
              example: 3EB0C767D82B0A0D1234
            anchor_timestamp:
              type: string
              format: date-time
              example: '2026-05-16T08:00:00Z'
    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
    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

- [Menerima pesan](https://gowa-docs.mintlify.site/id/examples/receiving-messages.md)
- [Sinkronkan riwayat pesan ke Chatwoot](https://gowa-docs.mintlify.site/id/api-reference/chatwoot/sinkronkan-riwayat-pesan-ke-chatwoot.md)
- [Integrasi Chatwoot](https://gowa-docs.mintlify.site/id/integrations/chatwoot.md)
- [Ambil pesan dari chat tertentu](https://gowa-docs.mintlify.site/id/api-reference/chat/ambil-pesan-dari-chat-tertentu.md)
- [Batas Pengiriman](https://gowa-docs.mintlify.site/id/advanced/rate-limiting.md)


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