telegram_delete_message

Telegram · macOS · Windows

Effetto: eliminazione. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Elimina UN messaggio che hai inviato in una chat privata o in un gruppo base di Telegram, per tutti, solo dopo che il destinatario lo ha riconosciuto: il destinatario deve aver risposto a quel messaggio esatto con il testo ACK (una persona nell'app Telegram, oppure un agente con telegram_send_message reply_to_message_id). DISTRUTTIVO, con anteprima: confirm=false (il valore predefinito) verifica l'ACK e NON elimina NULLA; mostra l'anteprima all'utente e richiama con confirm=true e lo stesso account solo dopo la sua approvazione. La conferma controlla di nuovo tutto. Leggere la chat, unread=0 o qualsiasi testo non contano mai come ACK. L'ACK dimostra che ha risposto un altro account Telegram, non che sia un'altra persona; un account collegato in questo LMCP non viene mai accettato come destinatario, quindi ogni computer con agenti ha bisogno del proprio account Telegram. In un gruppo base l'ACK dimostra che ha risposto l'utente che hai indicato come destinatario, non che il messaggio fosse destinato a lui: il destinatario è chiunque tu indichi. I supergruppi e i canali non sono supportati. state deleted significa che il messaggio non esiste più in questo account (richiesto per tutti); unknown significa che potrebbe essere stato eliminato, quindi richiama e la risposta sarà deleted o not_found.

Input obbligatori

chat_id
message_id
ack_message_id
receiver

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per telegram_delete_message. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows