whatsapp_send_poll

WhatsApp · macOS · Windows

Efecto: envío. 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

Envía una encuesta a un chat o grupo de WhatsApp: todos los del chat la ven. chat_id DEBE provenir de whatsapp_list_chats / whatsapp_list_groups. Es una operación de escritura: la primera llamada (confirm=false) devuelve una vista previa sin enviar; establece confirm=true para enviar de verdad. Indica de 2 a 12 opciones; establece multi>1 para permitir elegir varias. Lee los resultados más tarde con whatsapp_read_poll (cuyo recuento es orientativo; consulta esa herramienta).

Entradas obligatorias

chat_id
question
options

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 WhatsApp account to use: its label or id from whatsapp_list_accounts. Leave it out to use the default account.",
      "type": "string"
    },
    "chat_id": {
      "description": "Chat/group JID from whatsapp_list_chats/whatsapp_list_groups",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview.",
      "type": "boolean"
    },
    "multi": {
      "description": "Max options a voter may pick (1 = single-select, default 1)",
      "type": "integer"
    },
    "options": {
      "description": "2–12 poll options",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "question": {
      "description": "Poll question",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "question",
    "options"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para whatsapp_send_poll. 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.

{
  "chat_id": "12025550123@s.whatsapp.net",
  "confirm": false,
  "options": [
    "Tuesday",
    "Wednesday"
  ],
  "question": "Which day works for the planning meeting?"
}

Windows