MCP Tools Reference: chatmcp.googleapis.com

Strumento: send_message

Invia un messaggio chat di Google Chat a una conversazione con la formattazione Markdown.

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.

Richiesta 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
}'

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 può essere aggiunta utilizzando Markdown standard (tieni presente che le tabelle NON sono supportate). È supportata la seguente formattazione:

  • Grassetto: **text**
  • Corsivo:*text* o _text_
  • Barrato: ~~text~~
  • Monospazio: text
  • Blocco monospazio:
```
line 1
line 2
```
  • Elenco puntato:
* item 1
* item 2
  • Elenco ordinato:
1. item 1
2. item 2
  • Citazione a blocco: > quoted text
  • Link ipertestuale: [label](url)
  • Menzionare un utente: utilizza un tag HTML autoconclusivo chat-user con gli attributi data-email="user@example.com" o data-user="users/USER_ID". Se è noto, preferisci l'attributo data-user con USER_ID; in caso contrario, utilizza l'attributo data-email con l'email dell'utente. Se utilizzi l'attributo data-user, assicurati di includere il prefisso users/ visualizzato in altri valori restituiti dello strumento. Nota: sono consentite massimo 10 menzioni per messaggio. È severamente vietato menzionare tutti gli utenti (ad es. utilizzando @all o un tag HTML con users/all).
  • Emoji personalizzate:utilizza un tag HTML auto-chiudente chat-emoji con gli attributi data-custom-emoji="customEmojis/abc" o data-emoji-name=":xyz:".

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 utilizzando la formattazione Markdown.
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: ✅