MCP Tools Reference: chatmcp.googleapis.com

Strumento: send_message

Invia un messaggio di Google Chat a una conversazione.

Questo strumento utilizza come input un ID conversazione, un ID thread facoltativo e un testo del messaggio. Gli ID conversazione possono essere trovati utilizzando lo strumento search_conversations. Restituisce il messaggio creato.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP send_message.

Curl Request 
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
}'

Schema di input

Richiesta di invio di un messaggio a una conversazione di Google Chat.

SendMessageRequest

Rappresentazione JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Campi
conversationId

string

Obbligatorio. L'ID della conversazione (ad es. "spaces/AAAA...") a cui inviare il messaggio.
threadId

string

Facoltativo. L'ID del thread (ad es. "spaces/AAAA.../threads/BBBB...") a cui inviare il messaggio. Se non è impostato, il messaggio verrà inviato a un nuovo thread.
messageText

string

Obbligatorio. I contenuti principali del messaggio. La formattazione di base può essere aggiunta utilizzando un sottoinsieme di Markdown. Per informazioni su come formattare i messaggi, vedi Formattare i messaggi. È supportata la seguente formattazione:

  • Grassetto: *text*
  • Corsivo: _text_
  • Barrato: ~text~
  • Monospazio: text
  • Blocco monospazio:
```
line 1
line 2
```
  • Elenco puntato:
* item 1
* item 2
  • Citazione a blocco: > quoted text
  • Link ipertestuale: <url|display text>
  • Menziona utente: <users/{user_id}>

Schema di output

Risposta all'invio di un messaggio a una conversazione di Google Chat.

SendMessageResponse

Rappresentazione JSON 
{
  "message": {
    object (ChatMessage)
  }
}
Campi
message

object (ChatMessage)

Il messaggio inviato.

ChatMessage

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

string

Nome della risorsa del messaggio. Formato: spaces/{space}/messages/{message}
threadId

string

Il thread a cui appartiene questo messaggio. Questo campo sarà vuoto se il messaggio non è in thread. Formato: spaces/{space}/threads/{thread}
plaintextBody

string

Corpo del messaggio in testo normale.
sender

object (User)

Il mittente del messaggio.
createTime

string

Solo output. Timestamp di creazione del messaggio.
threadedReply

boolean

Indica se il messaggio è una risposta a un thread.
attachments[]

object (ChatAttachmentMetadata)

Allegati inclusi nel messaggio.
reactionSummaries[]

object (ReactionSummary)

Il riepilogo delle reazioni con emoji incluso nel messaggio.

Utente

Rappresentazione JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Campi
userId

string

Nome risorsa di un utente di Chat. Formato: users/{user}.
displayName

string

Il nome visualizzato di un utente di Chat.
email

string

L'indirizzo email dell'utente. Questo campo viene compilato solo quando il tipo di utente è HUMAN.
userType

enum (UserType)

Il tipo di utente.

ChatAttachmentMetadata

Rappresentazione JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Campi
attachmentId

string

Nome della risorsa dell'allegato. Formato: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Nome dell'allegato.
mimeType

string

Tipo di contenuti (tipo MIME).
source

enum (Source)

L'origine dell'allegato.

ReactionSummary

Rappresentazione JSON 
{
  "emoji": string,
  "count": integer
}
Campi
emoji

string

La stringa Unicode dell'emoji o il nome dell'emoji personalizzata.
count

integer

Il numero totale di reazioni che utilizzano l'emoji associata.

UserType

Il tipo di utente di Google Chat.

Enum
USER_TYPE_UNSPECIFIED Non specificato.
HUMAN Utente umano.
APP Utente dell'app.

Origine

L'origine dell'allegato.

Enum
SOURCE_UNSPECIFIED Riservato.
DRIVE_FILE Il file è un file di Google Drive.
UPLOADED_CONTENT Il file viene caricato su Chat.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ✅