telegram_delete_message

Telegram · macOS · Windows

Wirkung: Löschen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Löscht EINE Nachricht, die Sie in einem privaten Telegram-Chat oder einer einfachen Gruppe gesendet haben, für alle, erst nachdem der Empfänger sie bestätigt hat: Der Empfänger muss auf genau diese Nachricht mit dem Text ACK geantwortet haben (ein Mensch in der Telegram-App oder ein Agent mit telegram_send_message reply_to_message_id). DESTRUKTIV, mit Vorschau: confirm=false (der Standard) prüft das ACK und löscht NICHTS; zeigen Sie die Vorschau dem Benutzer und rufen Sie erst nach dessen Zustimmung erneut mit confirm=true und demselben account auf. Das confirm prüft alles erneut. Das Lesen des Chats, unread=0 oder irgendein Text zählen nie als ACK. Das ACK beweist, dass ein anderes Telegram-Konto geantwortet hat, nicht, dass es eine andere Person ist; ein in diesem LMCP verknüpftes Konto wird nie als Empfänger akzeptiert, daher braucht jeder Computer mit Agenten ein eigenes Telegram-Konto. In einer einfachen Gruppe beweist das ACK, dass der als Empfänger genannte Benutzer geantwortet hat, nicht, dass die Nachricht für ihn gedacht war: Der Empfänger ist, wen Sie nennen. Supergruppen und Kanäle werden nicht unterstützt. state deleted bedeutet, dass die Nachricht in diesem Konto nicht mehr existiert (für alle angefordert); unknown bedeutet, dass sie gelöscht worden sein könnte, rufen Sie also erneut auf, und die Antwort lautet deleted oder not_found.

Erforderliche Eingaben

chat_id
message_id
ack_message_id
receiver

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für telegram_delete_message. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows