teams_send_message

Microsoft Teams · macOS · Windows

Efeito: envio. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Envia uma mensagem de texto para uma conversa do Microsoft Teams como uma conta corporativa ou escolar do Microsoft 365 conectada (connect_m365_account), pelo Microsoft 365. O chat_id PRECISA vir de teams_list_chats da mesma conta — nunca invente ids. Esta é uma operação de gravação: a primeira chamada retorna uma prévia que diz quem está na conversa (ou que não foi possível lê-los: chat_unresolved), a segunda chamada (com confirm=true) envia de fato. Mostre ao usuário esses participantes antes de confirmar, sobretudo quando participants_state não é "resolved" ou has_external_members é true. sent:true significa que a Microsoft aceitou a mensagem; teams_search_messages lê o índice de pesquisa da Microsoft, que pode atrasar em relação a um envio, então uma pesquisa sem resultados logo após o envio NÃO é prova de que o envio falhou.

Entradas obrigatórias

chat_id
text

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "chat_id": {
      "description": "Chat id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<id>@thread.v2' for a group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview and sends nothing: the preview reads who is in the chat (`chat`: title, participants, participant_count, participants_state, has_external_members), or says chat_unresolved when that could not be read.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments.",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para teams_send_message. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "chat_id": "demo-chat-001",
  "confirm": false,
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows