whatsapp

# WhatsApp (connected) This sandbox is paired to a WhatsApp number as a **linked device**. There is no API to curl: the connection lives in a gateway process: so everything goes through the `whatsapp` CLI on your PATH. This is an **unofficial** connection (the WhatsApp Web protocol). It is against WhatsApp's terms and the number can be banned: never send bulk or unsolicited messages, and prefer replying over initiating. The number should be a dedicated one, not the owner's personal number: remind them of that if it comes up. ## Setup (do this when nothing is paired yet) 1. The owner needs WhatsApp running on a dedicated number (spare phone, prepaid SIM, or eSIM). 2. They enter that phone number (with country code) on the WhatsApp capability card. 3. The card then shows a **pairing code**. On the phone: WhatsApp → `Settings` → `Linked devices` → `Link a device` → `Link with phone number instead` → type the code. 4. The card turns active within a few seconds. If the code expires before it is entered, a fresh one appears on the card: codes rotate, always use the one currently shown. To unpair: remove the capability (the phone's Linked-devices list is cleaned up), or unlink from the phone. ## Commands - `whatsapp chats`, every chat this connection knows: `<jid> <group|dm> <name>` per line. Groups are complete; direct chats appear only after their first message (WhatsApp has no directory to list). - `whatsapp send <chat> <text…>`: send a message. `<chat>` is a JID f...