whatsapp_send_poll

WhatsApp · macOS · Windows

Effet: envoi. É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

Envoie un sondage à une discussion/un groupe WhatsApp — tous les membres de la discussion le voient. chat_id DOIT provenir de whatsapp_list_chats / whatsapp_list_groups. C’est une opération d’écriture : le premier appel (confirm=false) renvoie un aperçu sans envoyer ; définissez confirm=true pour envoyer réellement. Donnez 2 à 12 options ; définissez multi>1 pour permettre d’en choisir plusieurs. Lisez les résultats plus tard avec whatsapp_read_poll (dont le décompte est indicatif — voir cet outil).

Entrées requises

chat_id
question
options

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

Exemple documentaire

Exemple de documentation pour whatsapp_send_poll. 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.

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

Windows