telegram_delete_message

Telegram · macOS · Windows

Efecto: eliminación. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Elimina UN mensaje que enviaste en un chat privado o un grupo básico de Telegram, para todos, solo después de que el receptor lo haya acusado: el receptor debe haber respondido a ese mensaje exacto con el texto ACK (una persona en la app de Telegram, o un agente con telegram_send_message reply_to_message_id). DESTRUCTIVA, con vista previa: confirm=false (el valor por defecto) comprueba el ACK y NO elimina NADA; muestra la vista previa al usuario y vuelve a llamar con confirm=true y la misma cuenta solo después de que la apruebe. La confirmación lo comprueba todo de nuevo. Leer el chat, unread=0 o cualquier texto nunca cuentan como ACK. El ACK demuestra que respondió otra cuenta de Telegram, no que sea otra persona; una cuenta vinculada en este LMCP nunca se acepta como receptor, así que cada equipo con agentes necesita su propia cuenta de Telegram. En un grupo básico el ACK demuestra que respondió el usuario que nombraste como receptor, no que el mensaje fuera para él: el receptor es quien tú nombres. No se admiten supergrupos ni canales. El estado deleted significa que el mensaje ya no existe en esta cuenta (solicitado para todos); unknown significa que puede haberse eliminado, así que vuelve a llamar y la respuesta será deleted o not_found.

Entradas obligatorias

chat_id
message_id
ack_message_id
receiver

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en 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"
}

Ejemplo documental

Ejemplo de documentación para telegram_delete_message. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows