MCP Tools Reference: chatmcp.googleapis.com

Ferramenta: send_message

Envia uma mensagem do Google Chat para uma conversa.

Essa ferramenta usa um ID de conversa, um ID de encadeamento opcional e um texto de mensagem como entradas. Os IDs de conversa podem ser encontrados usando a ferramenta search_conversations. Ela retorna a mensagem criada.

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

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

Esquema de entrada

Solicitação para enviar uma mensagem a uma conversa do Google Chat.

SendMessageRequest

Representação JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Campos
conversationId

string

Obrigatório. O ID da conversa (por exemplo, "spaces/AAAA...") para enviar a mensagem.
threadId

string

Opcional. O ID da conversa (por exemplo, "spaces/AAAA.../threads/BBBB...") para enviar a mensagem. Se não estiver definido, a mensagem será enviada para uma nova conversa.
messageText

string

Obrigatório. O conteúdo principal da mensagem. A formatação básica pode ser adicionada usando um subconjunto do Markdown. Para saber como formatar mensagens, consulte Formatar mensagens. Há suporte para a seguinte formatação:

  • Negrito:*text*
  • Itálico:_text_
  • Tachado:~text~
  • Monospace:text
  • Bloco monoespaçado:
```
line 1
line 2
```
  • Lista com marcadores:
* item 1
* item 2
  • Citação em bloco:> quoted text
  • Hiperlink:<url|display text>
  • Mencionar usuário: <users/{user_id}>

Esquema de saída

Resposta ao envio de uma mensagem para uma conversa do Google Chat.

SendMessageResponse

Representação JSON 
{
  "message": {
    object (ChatMessage)
  }
}
Campos
message

object (ChatMessage)

A mensagem enviada.

ChatMessage

Representação JSON 
{
  "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 esta mensagem pertence. Esse campo fica 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 em uma conversa.
attachments[]

object (ChatAttachmentMetadata)

Anexos incluídos na mensagem.
reactionSummaries[]

object (ReactionSummary)

O resumo das reações com emojis incluído 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.

ReactionSummary

Representação JSON 
{
  "emoji": string,
  "count": integer
}
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.

UserType

O tipo de usuário do Google Chat.

Tipos enumerados
USER_TYPE_UNSPECIFIED Não especificado.
HUMAN Usuário humano.
APP Usuário do app.

Origem

A origem do anexo.

Tipos enumerados
SOURCE_UNSPECIFIED Reservado.
DRIVE_FILE O arquivo é do Google Drive.
UPLOADED_CONTENT O arquivo é enviado para o Chat.

Anotações de ferramentas

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