telegram_delete_message

Telegram · macOS · Windows

Effet: suppression. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Supprime UN message que vous avez envoyé dans une discussion privée Telegram ou un groupe de base, pour tout le monde, seulement après que le destinataire l’a acquitté : le destinataire doit avoir répondu à ce message précis avec le texte ACK (une personne dans l’app Telegram, ou un agent avec telegram_send_message reply_to_message_id). DESTRUCTIF, avec aperçu : confirm=false (la valeur par défaut) vérifie l’ACK et ne supprime RIEN ; montrez l’aperçu à l’utilisateur et rappelez avec confirm=true et le même compte seulement après son approbation. Le confirm vérifie tout de nouveau. Lire la discussion, unread=0 ou n’importe quel texte ne comptent jamais comme un ACK. L’ACK prouve qu’un autre compte Telegram a répondu, pas qu’il s’agit d’une autre personne ; un compte associé dans ce LMCP n’est jamais accepté comme destinataire, donc chaque ordinateur avec des agents a besoin de son propre compte Telegram. Dans un groupe de base, l’ACK prouve que l’utilisateur que vous avez nommé comme destinataire a répondu, pas que le message lui était destiné : le destinataire est celui que vous nommez. Les supergroupes et les canaux ne sont pas pris en charge. L’état deleted signifie que le message n’existe plus dans ce compte (demandé pour tout le monde) ; unknown signifie qu’il a peut-être été supprimé, rappelez donc l’outil et la réponse sera deleted ou not_found.

Entrées requises

chat_id
message_id
ack_message_id
receiver

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour telegram_delete_message. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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

Windows