telegram_delete_message

Telegram · macOS · Windows

Effect: verwijderen. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Verwijdert ÉÉN bericht dat je in een privéchat of basisgroep van Telegram hebt verstuurd, voor iedereen, pas nadat de ontvanger het heeft bevestigd: de ontvanger moet op dat exacte bericht hebben geantwoord met de tekst ACK (een mens in de Telegram-app, of een agent met telegram_send_message reply_to_message_id). DESTRUCTIEF, met een voorbeeld: confirm=false (de standaard) controleert de ACK en verwijdert NIETS; toon het voorbeeld aan de gebruiker en roep pas opnieuw aan met confirm=true en hetzelfde account nadat die akkoord is. De confirm controleert alles opnieuw. Het lezen van de chat, unread=0 of enige tekst telt nooit als ACK. De ACK bewijst dat een ander Telegram-account heeft geantwoord, niet dat het een ander persoon is; een account dat in deze LMCP is gekoppeld, wordt nooit als ontvanger geaccepteerd, dus elke computer met agents heeft een eigen Telegram-account nodig. In een basisgroep bewijst de ACK dat de gebruiker die je als ontvanger noemde heeft geantwoord, niet dat het bericht voor hem bedoeld was: de ontvanger is wie jij noemt. Supergroepen en kanalen worden niet ondersteund. state deleted betekent dat het bericht niet meer bestaat in dit account (aangevraagd voor iedereen); unknown betekent dat het mogelijk is verwijderd, dus roep opnieuw aan en het antwoord is deleted of not_found.

Vereiste invoer

chat_id
message_id
ack_message_id
receiver

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor telegram_delete_message. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows