telegram_delete_message

Telegram · macOS · Windows

Efeito: eliminação. 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

Apaga UMA mensagem que você enviou em uma conversa privada ou grupo básico do Telegram, para todos, somente depois que o destinatário a confirmou: o destinatário precisa ter respondido a essa mensagem exata com o texto ACK (uma pessoa no app do Telegram, ou um agente com telegram_send_message reply_to_message_id). DESTRUTIVO, com prévia: confirm=false (o padrão) verifica o ACK e NÃO apaga NADA; mostre a prévia ao usuário e chame de novo com confirm=true e a mesma conta somente depois que ele aprovar. O confirm verifica tudo de novo. Ler a conversa, unread=0 ou qualquer texto nunca contam como ACK. O ACK prova que outra conta do Telegram respondeu, não que seja outra pessoa; uma conta vinculada neste LMCP nunca é aceita como destinatária, então cada computador com agentes precisa da sua própria conta do Telegram. Em um grupo básico, o ACK prova que o usuário que você nomeou como destinatário respondeu, não que a mensagem era para ele: o destinatário é quem você nomear. Supergrupos e canais não são compatíveis. state deleted significa que a mensagem não existe mais nesta conta (solicitada para todos); unknown significa que ela pode ter sido apagada, então chame de novo e a resposta será deleted ou not_found.

Entradas obrigatórias

chat_id
message_id
ack_message_id
receiver

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"
    },
    "ack_message_id": {
      "description": "Id of the receiver's reply ACK to that message (from telegram_read_messages).",
      "type": "integer"
    },
    "chat_id": {
      "description": "Chat id from telegram_list_chats: user:… (private) or chat:… (basic group).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to delete. Without it, returns a preview and deletes nothing.",
      "type": "boolean"
    },
    "message_id": {
      "description": "Id of your own message to delete (from telegram_read_messages).",
      "type": "integer"
    },
    "receiver": {
      "description": "The receiver's user:<id>:<hash> id from telegram_list_chats. Only this user's ACK counts.",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "message_id",
    "ack_message_id",
    "receiver"
  ],
  "type": "object"
}

Exemplo documental

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

{
  "ack_message_id": 4022,
  "chat_id": "user:5550100123",
  "confirm": false,
  "message_id": 4021,
  "receiver": "user:5550100123:9f8e7d6c5b4a"
}

Windows