---
title: "messageQuery"
description: >
  从聊天应用或消息系统中检索指定会话的消息列表。这些消息通过 [messageSend](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/mutations/message-send.md) 接口发送。调用本接口前需确保已通过 [conversationCreate](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/mutations/conversation-create.md) 接口创建会话。
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/queries/message-query'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/queries/message-query.md'
---
# messageQuery

从聊天应用或消息系统中检索指定会话的消息列表。这些消息通过 [messageSend](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/mutations/message-send.md) 接口发送。调用本接口前需确保已通过 [conversationCreate](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/mutations/conversation-create.md) 接口创建会话。

- **Required Scopes:** `unauthenticated_read_message`
- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Query

## Required Permissions

* `unauthenticated_read_message`

接口访问需要令牌，具体如何获取令牌参考：[身份认证](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md)。

## Arguments

* `input`

  [MessageQueryInput!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/inputs/message-query-input.md)

  用于查询消息列表的输入字段。

## Returns

* `messages`

  [[Message]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/objects/message.md)

  消息列表

## Examples

### 查询消息

从聊天应用程序或消息系统中检索指定会话的消息列表（这些消息通过 [messageSend](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/mutations/message-send.md) 接口发送）。调用本接口前需确保已通过 [conversationCreate](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/mutations/conversation-create.md) 接口创建会话。

**Request:**

```json


query MessageQuery {
    messageQuery(
        input: { conversationId: "gid://shopline/Conversation/******403588", direction: "down", pageSize: 10 }
    ) {
        messages {
            conversationId
            storeId
            userId
            content
            contentAttachmentUrl
            messageType
            createAt
            sendErrorCode
            senderType
            sendStatus
            id
        }
    }
}

```

**Response:**

```json
{
  "data": {
    "messageSend": {
      "message": {
        "senderType": "USER",
        "content": "demoString",
        "conversationId": "gid://shopline/Conversation/******403588",
        "createTime": null,
        "id": null,
        "messageType": "TEXT",
        "sendErrorCode": "",
        "storeId": "******2170",
        "userId": "gid://shopline/ThirdUser/******5235111",
        "contentAttachmentUrl": "",
        "sendStatus": "SEND_SUCCESS"
      },
      "userErrors": []
    }
  }
}
```

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes)。