teams_send_channel_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 canal do Microsoft Teams por meio do Graph API. Requer connect_m365_account com permissões Chat.ReadWrite / ChannelMessage.Send. team_id e channel_id devem vir de teams_list_teams/teams_list_channels. A primeira chamada retorna uma visualização; defina confirm=true para enviar.

Entradas obrigatórias

team_id
channel_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": {
    "channel_id": {
      "description": "Channel ID from teams_list_channels, or the channel's name",
      "type": "string"
    },
    "confirm": {
      "description": "Set true to send; false returns preview",
      "type": "boolean"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams, or the team's name",
      "type": "string"
    },
    "text": {
      "description": "Plain-text message body",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id",
    "text"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para teams_send_channel_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.

{
  "channel_id": "demo-channel-001",
  "confirm": false,
  "team_id": "demo-team-001",
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows