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

# Obtener mensajes de un chat específico

> Recuperar mensajes de una conversación de chat específica con opciones de filtrado



## OpenAPI

````yaml /es/openapi.yml get /chat/{chat_jid}/messages
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}/messages:
    get:
      tags:
        - chat
      summary: Obtener mensajes de un chat específico
      description: >-
        Recuperar mensajes de una conversación de chat específica con opciones
        de filtrado
      operationId: getChatMessages
      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
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            maximum: 100
          description: Número máximo de mensajes a devolver
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
          description: Número de mensajes a omitir (para paginación)
        - name: start_time
          in: query
          schema:
            type: string
            format: date-time
          description: Filtrar mensajes de esta marca de tiempo (formato ISO 8601)
        - name: end_time
          in: query
          schema:
            type: string
            format: date-time
          description: Filtrar mensajes hasta esta marca de tiempo (formato ISO 8601)
        - name: media_only
          in: query
          schema:
            type: boolean
            default: false
          description: Devolver sólo mensajes con contenido multimedia
        - name: is_from_me
          in: query
          schema:
            type: boolean
          description: >-
            Filtrar mensajes por remitente (verdadero para mensajes enviados por
            ti, falso para mensajes recibidos). Cuando tanto media_only=true
            como isFromMe=false son proporcionados, media_only tiene prioridad y
            devolverá todos los mensajes multimedia independientemente del
            remitente.
        - name: search
          in: query
          schema:
            type: string
          description: Buscar mensajes por texto de contenido
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatMessagesResponse'
        '400':
          description: Solicitud incorrecta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '404':
          description: Chat no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorNotFound'
        '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:
    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: 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
    ErrorNotFound:
      type: object
      properties:
        code:
          type: string
          example: 404
          description: Código de estado HTTP
        message:
          type: string
          example: Chat not found
          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
    ChatMessage:
      type: object
      properties:
        id:
          type: string
          example: 3EB0B430B6F8F1D0E053AC120E0A9E5C
          description: ID del mensaje
        chat_jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: JID de chat al que pertenece este mensaje
        sender_jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: Sender JID
        sender_display_name:
          type: string
          example: Saved Contact
          description: >-
            Etiqueta de remitente legible por seres humanos resuelta
            dinámicamente cuando se produce esta respuesta, no almacenada con el
            mensaje. Para otros remitentes, prefiere el nombre completo del
            contacto guardado, luego el nombre del contacto almacenado, el
            nombre de empresa, la parte del usuario JID y el JID crudo. Para la
            cuenta activa, prefiere el nombre de la pantalla del dispositivo
            (volviendo al nombre push de cuenta almacenada), cuenta JID parte de
            usuario, cuenta JID, parte de usuario del remitente JID y JID del
            remitente. Por lo tanto, un renombrado de contacto puede cambiar la
            etiqueta devuelta para mensajes históricos. `sender_jid` sigue
            siendo el identificador de remitente estable.
        content:
          type: string
          example: Hello, how are you?
          description: Contenido del texto del mensaje
        timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Marca de tiempo del mensaje
        is_from_me:
          type: boolean
          example: false
          description: Si este mensaje fue enviado por el usuario actual
        media_type:
          type: string
          example: image
          nullable: true
          description: >-
            Tipo de medio (imagen, video, audio, documento, etc.). El valor
            `call` indica un registro de llamada entrante almacenado.
        reactions:
          type: array
          description: Reacciones de Emoji adjuntas a este mensaje
          items:
            $ref: '#/components/schemas/ChatReaction'
        call_metadata:
          type: string
          example: '{"call_id":"ABC","auto_rejected":false}'
          description: >-
            Cadena JSON con detalles de llamada cuando media_type es `call`.
            Omitido cuando no es aplicable (coincide con Go json omitempty).
        referral_metadata:
          type: string
          example: '{"ctwa_clid":"clid_123","source_app":"whatsapp"}'
          description: >-
            Cadena JSON con los detalles de referencia / atribución de anuncios
            Meta cuando el mensaje se originó a partir de un anuncio
            Click-to-WhatsApp. Omitido cuando no es aplicable (coincide con Go
            json omitempty).
        context_metadata:
          type: string
          example: '{"replied_to_id":"AC625C65EA7143E71D784176C4A90A93"}'
          description: >-
            Cadena JSON que contiene el ID del mensaje replicado cuando se
            conoce el contexto de respuesta. Capturado desde mensajes en
            directo, enviados y sincronizados con el historial. Omitido cuando
            no hay un contexto de respuesta disponible, incluyendo registros
            almacenados hasta que sean reingeridos con contexto.
        filename:
          type: string
          example: photo.jpg
          nullable: true
          description: Nombre de archivo original para los mensajes multimedia
        url:
          type: string
          example: https://media.example.com/file.jpg
          nullable: true
          description: URL del archivo multimedia
        file_length:
          type: integer
          example: 1024768
          nullable: true
          description: Tamaño del archivo en bytes para los mensajes multimedia
        created_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Fecha de creación de registros
        updated_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Registrar fecha de última actualización
    Chat:
      type: object
      properties:
        jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: Identificador JID de chat
        name:
          type: string
          example: John Doe
          description: Nombre de pantalla del chat
        last_message_time:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Marca de tiempo del último mensaje
        ephemeral_expiration:
          type: integer
          example: 0
          description: >-
            Tiempo de expiración del mensaje efemeral en segundos (0 =
            deshabilitado)
        created_at:
          type: string
          format: date-time
          example: '2024-01-10T08:00:00Z'
          description: Marca de tiempo de creación de chat
        updated_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: Última actualización del chat
        archived:
          type: boolean
          example: false
          description: Si el chat está archivado
    ChatReaction:
      type: object
      properties:
        emoji:
          type: string
          example: 👍
          description: Emoji usado en la reacción
        sender_jid:
          type: string
          example: 628123456789@s.whatsapp.net
          description: JID del usuario que reaccionó
        sender_display_name:
          type: string
          example: Saved Contact
          description: >-
            Etiqueta de remitente legible por seres humanos se resolvió
            dinámicamente cuando se produce esta respuesta, no se almacena con
            la reacción. Para otros remitentes, prefiere el nombre completo del
            contacto guardado, luego el nombre del contacto almacenado, el
            nombre de empresa, la parte del usuario JID y el JID crudo. Para la
            cuenta activa, prefiere el nombre de la pantalla del dispositivo
            (volviendo al nombre push de cuenta almacenada), cuenta JID parte de
            usuario, cuenta JID, parte de usuario del remitente JID y JID del
            remitente. Por lo tanto, un renombrado de contacto puede cambiar la
            etiqueta devuelta para las reacciones históricas. `sender_jid` sigue
            siendo el identificador de remitente estable.
        is_from_me:
          type: boolean
          example: false
          description: Si la reacción fue realizada por el usuario actual
        timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:31:00Z'
          description: Cuando la reacción fue recibida
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Obtener lista de chats](https://gowa-docs.mintlify.site/es/api-reference/chat/obtener-lista-de-chats.md)
- [Marcar un mensaje de audio como reproducido](https://gowa-docs.mintlify.site/es/api-reference/message/marcar-un-mensaje-de-audio-como-reproducido.md)
- [Recibiendo mensajes](https://gowa-docs.mintlify.site/es/examples/receiving-messages.md)
- [Obtener configuración de webhook del dispositivo](https://gowa-docs.mintlify.site/es/api-reference/device/obtener-configuración-de-webhook-del-dispositivo.md)
- [Anclar o quitar un chat](https://gowa-docs.mintlify.site/es/api-reference/chat/anclar-o-quitar-un-chat.md)


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