MCP Tools Reference: chatmcp.googleapis.com

Ferramenta: `list_messages`

Recupera mensagens de uma conversa especificada do Google Chat (espaço, mensagem direta (MD) ou MD em grupo). Permite filtrar por conversa, período e número de mensagens. Além disso, a próxima página de mensagens pode ser recuperada para permitir mais contexto. As mensagens particulares (visíveis apenas para um único usuário) são filtradas.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP list_messages.

Solicitação curl
curl --location 'https://chatmcp.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list_messages", "arguments": { // provide these details according to the tool MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

Solicitação curl

curl --location 'https://chatmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_messages",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para ListMessages RPC.

ListChatMessagesRequest

Representação JSON
{ "conversationId": string, "threadId": string, "pageSize": integer, "pageToken": string, "startTime": string, "endTime": string }

Campos
`conversationId`	`string` Obrigatório. O ID da conversa. Uma conversa pode ser um espaço, uma mensagem direta (MD) ou uma MD/Chat em grupo. Formato: spaces/{space}
`threadId`	`string` Opcional. O ID de uma conversa específica. Se fornecido, apenas as mensagens dessa conversa serão retornadas. Se omitido, as mensagens de todas as conversas serão consideradas. Formato: spaces/{space}/threads/{thread}
`pageSize`	`integer` Opcional. O número máximo de mensagens a serem retornadas. O serviço pode retornar um valor inferior a este. Se não for especificado, o padrão será 20. O valor máximo permitido é 50.
`pageToken`	`string` Opcional. Um token de página, recebido de uma chamada list_messages anterior. Forneça isso para recuperar a página subsequente.
`startTime`	`string` Opcional. Carimbo de data/hora ISO 8601 para filtrar mensagens. Somente as mensagens criadas após esse horário serão retornadas.
`endTime`	`string` Opcional. Carimbo de data/hora ISO 8601 para filtrar mensagens. Somente as mensagens criadas antes desse horário serão retornadas.

Esquema de saída

Mensagem de resposta para ListMessages RPC.

ListChatMessagesResponse

Representação JSON
{ "messages": [ { object (`ChatMessage`) } ], "nextPageToken": string }

Campos

Campos
`messages[]`	`object (ChatMessage)` Lista de mensagens recuperadas, em ordem cronológica inversa (mais recente primeiro).
`nextPageToken`	`string` Um token, que pode ser enviado como `page_token` em uma `ListMessagesRequest` subsequente para recuperar a próxima página de mensagens. Se esse campo estiver vazio, não haverá mais páginas.

messages[]

object (ChatMessage)

Lista de mensagens recuperadas, em ordem cronológica inversa (mais recente primeiro).

nextPageToken

string

Um token, que pode ser enviado como page_token em uma ListMessagesRequest subsequente para recuperar a próxima página de mensagens. Se esse campo estiver vazio, não haverá mais páginas.

ChatMessage

Representação JSON

Representação JSON
{ "messageId": string, "threadId": string, "plaintextBody": string, "sender": { object (`User`) }, "createTime": string, "threadedReply": boolean, "attachments": [ { object (`ChatAttachmentMetadata`) } ], "reactionSummaries": [ { object (`ReactionSummary`) } ] }

{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}

Campos
`messageId`	`string` Nome do recurso da mensagem. Formato: spaces/{space}/messages/{message}
`threadId`	`string` A conversa a que essa mensagem pertence. Esse parâmetro estará vazio se a mensagem não estiver em uma conversa. Formato: spaces/{space}/threads/{thread}
`plaintextBody`	`string` Corpo de texto simples da mensagem.
`sender`	`object (User)` O remetente da mensagem.
`createTime`	`string` Apenas saída. Carimbo de data/hora em que a mensagem foi criada.
`threadedReply`	`boolean` Indica se a mensagem é uma resposta de conversa.
`attachments[]`	`object (ChatAttachmentMetadata)` Anexos incluídos na mensagem.
`reactionSummaries[]`	`object (ReactionSummary)` O resumo das reações com emojis incluídas na mensagem.

Usuário

Representação JSON
{ "userId": string, "displayName": string, "email": string, "userType": enum (`UserType`) }

Campos
`userId`	`string` Nome do recurso de um usuário do Chat. Formato: users/{user}.
`displayName`	`string` O nome de exibição de um usuário do Chat.
`email`	`string` O endereço de e-mail do usuário. Esse campo só é preenchido quando o tipo de usuário é HUMAN.
`userType`	`enum (UserType)` O tipo de usuário.

ChatAttachmentMetadata

Representação JSON
{ "attachmentId": string, "filename": string, "mimeType": string, "source": enum (`Source`) }

Campos
`attachmentId`	`string` Nome do recurso do anexo. Formato: spaces/{space}/messages/{message}/attachments/{attachment}.
`filename`	`string` Nome do anexo.
`mimeType`	`string` Tipo de conteúdo (tipo MIME).
`source`	`enum (Source)` A origem do anexo.

Representação JSON
{ "emoji": string, "count": integer }

Campos

Campos
`emoji`	`string` A string Unicode do emoji ou o nome do emoji personalizado.
`count`	`integer` O número total de reações usando o emoji associado.

emoji

string

A string Unicode do emoji ou o nome do emoji personalizado.

count

integer

O número total de reações usando o emoji associado.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌