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 um chat ou canal do Microsoft Teams. Requer que o Microsoft Teams esteja em execução e conectado (o token é lido dos cookies locais do Teams em cada chamada). O chat_id MUST vem de uma chamada teams_list_chats anterior – nunca fabrique ids. Esta é uma operação de gravação: a primeira chamada retorna uma visualização, a segunda chamada (com confirm=true) realmente envia. sent:true significa que a mensagem foi lida da conversa (entrega verificada) — confie no campo THAT, não em uma leitura de acompanhamento: teams_search_messages e teams_read_chat_messages leem o índice de sincronização local do próprio Teams, que pode atrasar um envio verificado em minutos (único caso observado: 3 min, #2285). Uma leitura de irmão com resultado zero logo após o envio é uma evidência NOT de que o envio falhou. Uma resposta com status “sent_unconfirmed” significa que o servidor aceitou o POST, mas a mensagem NOT pode ser verificada – diga ao usuário para abrir o próprio Teams e verificar antes de assumir que o destinatário foi notificado.

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": {
    "chat_id": {
      "description": "Thread id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<uuid>@thread.tacv2' for group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview without making any network call.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments in v1.",
      "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