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

# Solicitar historial de chat antiguo desde el teléfono

> Solicita al teléfono mensajes antiguos de un chat bajo demanda (lo que WhatsApp Web hace cuando se desplaza hacia arriba / "cargar mensajes antiguos"). La solicitud está anclada en el mensaje más antiguo actualmente almacenado localmente para ese chat, por lo que el chat debe tener al menos un mensaje almacenado. El teléfono responde de forma asincrónica con un evento de sincronización del historial que persiste en el almacenamiento del chat; este endpoint sólo confirma que la solicitud fue enviada, no devuelve los mensajes anteriores directamente.



## OpenAPI

````yaml /es/openapi.yml post /chat/{chat_jid}/history
openapi: 3.0.0
info:
  title: Multidispositivo API de WhatsApp
  version: 9.7.0
  description: >
    Esta API se utiliza para enviar whatsapp a través de API.


    El panel web es un proyecto separado (gowa-ui); el servidor descarga su
    último recurso de versión

    y lo sirve en `/` (o devuelve un banner JSON cuando

    APP_UI_ENABLED=false).


    Ámbito del dispositivo:

    - Envía `X-Device-Id` en todas las llamadas REST con ámbito dispositivo.

    - WebSocket: conectar a `/ws?device_id=<id>`.

    - WebSocket auth (cuando la autenticación básica está habilitada): los
    navegadores no pueden establecer un encabezado
      de autorización en conexiones WebSocket, así que también pase
      `&authorization=<base64(user:pass)>` en la cadena de consulta. Usa TLS en producciónformat@@0
      ya que la credencial es visible en la URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Conexión inicial al servidor de Whatsapp
  - name: device
    description: Gestión de dispositivos para soporte multidispositivo
  - name: user
    description: Obteniendo información
  - name: send
    description: Enviar mensaje (Texto/Imágen/Archivo/Video).
  - name: message
    description: Manipulación de mensajes (revocar/react/actualizar).
  - name: call
    description: Gestión de llamadas (rechazar llamadas entrantes)
  - name: chat
    description: Chats de chat y mensajería
  - name: group
    description: Ajuste de grupo
  - name: newsletter
    description: configuración del boletín de noticias
  - name: chatwoot
    description: Integración de Chatwoot para soporte al cliente
paths:
  /chat/{chat_jid}/history:
    post:
      tags:
        - chat
      summary: Solicitar historial de chat antiguo desde el teléfono
      description: >-
        Solicita al teléfono mensajes antiguos de un chat bajo demanda (lo que
        WhatsApp Web hace cuando se desplaza hacia arriba / "cargar mensajes
        antiguos"). La solicitud está anclada en el mensaje más antiguo
        actualmente almacenado localmente para ese chat, por lo que el chat debe
        tener al menos un mensaje almacenado. El teléfono responde de forma
        asincrónica con un evento de sincronización del historial que persiste
        en el almacenamiento del chat; este endpoint sólo confirma que la
        solicitud fue enviada, no devuelve los mensajes anteriores directamente.
      operationId: requestChatHistory
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - in: path
          name: chat_jid
          schema:
            type: string
          required: true
          description: >-
            Chat JID (por ejemplo, phone@s.whatsapp.net para individual o
            groupid@g.us para grupo). Los valores codificados por porcentaje
            (por ejemplo,%40g.us) son aceptados.
          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: >-
                    Número de mensajes antiguos a solicitar desde el teléfono.
                    Omitirlo, o enviar 0, para usar el valor predeterminado de
                    50.
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestChatHistoryResponse'
        '400':
          description: >-
            Solicitud incorrecta (por ejemplo, chat_jid, cuenta fuera de rango,
            o chat no tiene mensajes almacenados para anclar en)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Identificador de dispositivo para soporte multidispositivo. Requerido
        cuando se registran múltiples dispositivos.

        Si sólo se registra un dispositivo, se utilizará como el valor
        predeterminado.

        También se puede proporcionar como parámetro de consulta `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: Código de estado HTTP
        message:
          type: string
          example: field cannot be blank
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    ErrorUnauthorized:
      type: object
      properties:
        code:
          type: string
          example: 401
          description: Código de estado HTTP
        message:
          type: string
          example: Unauthorized access
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: Error
        message:
          type: string
          example: you are not loggin
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Integración de Chatwoot](https://gowa-docs.mintlify.site/es/integrations/chatwoot.md)
- [Manejo de medios](https://gowa-docs.mintlify.site/es/examples/media-handling.md)
- [Límites de envío](https://gowa-docs.mintlify.site/es/advanced/rate-limiting.md)
- [Autenticación](https://gowa-docs.mintlify.site/es/authentication.md)
- [Webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md)


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