whatsapp_send_poll

WhatsApp · macOS · Windows

Effetto: invio. Stato: disponibilità condizionata.

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

macOS

Scopo

Invia un sondaggio a una chat/gruppo WhatsApp: tutti i membri della chat lo vedono. chat_id DEVE provenire da whatsapp_list_chats / whatsapp_list_groups. È un'operazione di scrittura: la prima chiamata (confirm=false) restituisce un'anteprima senza inviare; imposta confirm=true per inviare davvero. Indica da 2–12 opzioni; imposta multi>1 per consentire di sceglierne più d'una. Leggi i risultati in seguito con whatsapp_read_poll (il cui conteggio è indicativo: vedi quello strumento).

Input obbligatori

chat_id
question
options

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 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"
}

Esempio documentale

Esempio di documentazione per whatsapp_send_poll. 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.

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

Windows