telegram_send_message

Telegram · 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 do Telegram da sua própria conta para uma conversa. Operação de GRAVAÇÃO com visualização: a primeira chamada (confirm=false) retorna uma visualização e NÃO envia NADA; mostre-a ao usuário e chame novamente com confirm=true somente depois que ele aprovar. O chat_id DEVE vir de telegram_list_chats — nunca invente um. Uma mensagem por chamada; sem envio em massa.

Entradas obrigatórias

chat_id
message

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 linked Telegram account to use: its label or id from telegram_list_accounts. Leave it out to use the default account.",
      "type": "string"
    },
    "chat_id": {
      "description": "Chat id from telegram_list_chats.",
      "type": "string"
    },
    "chat_name": {
      "description": "The chat's name as telegram_list_chats showed it, echoed in the preview so the user sees who receives it.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview.",
      "type": "boolean"
    },
    "message": {
      "description": "Text to send (max 4096 characters).",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "message"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para telegram_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": "5550100123",
  "confirm": false,
  "message": "Can we review the launch checklist on Tuesday?"
}

Windows