Directory
‹ Back to apps

wuapi-skills

Agent skills for wuapi, a WhatsApp API for developers: act on a linked number, link numbers by QR or pairing code, send over REST, receive events with signed Webhooks or Streams, manage chats, groups and channels, and run a platform with one project per customer.

What’s inside

10 skills
  • Skillact-on-whatsappAct on a user's own WhatsApp number through wuapi (REST at https://api.wuapi.dev). Use when an assistant must operate that number for the user rather than write an application: store an organization API key as WUAPI_API_KEY and never print it, tell an organization key from a project key and send the Wuapi-Project header, pick the sending account from GET /v1/accounts, retry account_not_ready while reconnecting, stop on 402 free_limit_reached, honor 429 Retry-After, resolve a group or contact and ask when several match, confirm the exact text and recipients, send with POST /v1/messages and an Idempotency-Key, and poll GET /v1/messages/{id} until sent or delivered. Also the short endpoint map for media, reactions, chats, groups, channels, stories, uploads, webhooks, incoming webhooks and projects, plus the MCP server, CLI and TypeScript and Rust SDKs.
  • Skillchats-contacts-profileChats, contacts, the account's own profile and calls in wuapi. Use when writing code that lists an account's chats or reads their unread, pinned, archived or muted state, sends read receipts, shows typing, archives, pins, mutes, marks or deletes chats, sets disappearing timers, uses WhatsApp Business labels, lists the account's address book, checks which numbers have WhatsApp, looks up contacts, pictures or business profiles, follows a contact's presence, blocks or unblocks, changes the account's name, about, picture or privacy settings, resolves contact links, or sees and rejects incoming calls.
  • Skillgroups-and-channelsManage WhatsApp groups, communities and channels through a wuapi account. Use when writing code that lists, creates or edits groups, adds, removes, promotes or demotes participants, handles join requests and invite links, sets group pictures or admin-only settings, builds communities with subgroups, or follows, reads, reacts to, creates and posts to WhatsApp channels.
  • Skilllink-accountConnect a WhatsApp number to wuapi as a linked device, by QR code or by 8-character pairing code, and keep it connected. Use when writing code that creates accounts, shows a QR code or pairing code to a phone owner, waits for an account to become ready, picks the proxy location (the country and city the number's traffic exits from), handles disconnects, or reconnects, logs out or deletes an account.
  • Skillprojects-and-invitationsBuild a platform on wuapi where each of your customers links their own WhatsApp number. Use when writing code that creates projects (one per customer or environment), addresses them by id or ext:<externalId>, issues project-scoped API keys, sends the Wuapi-Project header, sets up per-project webhook endpoints, suspends or limits a project, exports per-project usage for rebilling, sends invitations (the hosted, white-label page where someone else links their number), or sets the organization's branding.
  • Skillreceive-streamsReceive wuapi events live with Streams when the code has no public HTTPS endpoint for Webhooks. Use when a client must get inbound WhatsApp messages, delivery and read receipts or account status changes as they happen without exposing a URL (local development, a desktop or CLI app, a worker behind NAT, an agent), when choosing between Webhooks and Streams, when handling Last-Event-ID resume and reset frames, or when someone asks to poll wuapi for new events.
  • Skillreceive-webhooksReceive wuapi events on an HTTPS endpoint. Use when writing a webhook handler for wuapi, creating or updating webhook endpoints, verifying the Wuapi-Signature header, handling inbound WhatsApp messages, delivery and read receipts, account status changes, poll votes, calls, group and chat changes, or the chat history synced after linking; also when building an AI agent that answers incoming WhatsApp messages.
  • Skillsend-messageSend WhatsApp messages through wuapi and act on sent messages. Use when writing code that sends text, media, voice notes, documents, stickers, locations, contact cards, polls or calendar events; replies, mentions, view-once or disappearing messages; forwards a received or sent message to other chats; edits, deletes, stars or reacts to a message; votes in a poll; posts a story or a channel post; or reads, views, replies or reacts to a contact's story. Also covers the queued lifecycle, the Idempotency-Key header, pacing and send errors.
  • Skillwuapi-cliUse the wuapi command line (`npx @wuapidev/cli`) to log in, link a WhatsApp number through a link the person opens, run the project's code with the key, send a message and call any wuapi API method from a terminal or an agent's shell. Use when setting up wuapi in a project, when the WUAPI_API_KEY variable is missing, when the user asks to link a number or send a test from the terminal, when configuring the wuapi MCP server, or when an agent needs to read or change wuapi data without writing code.
  • Skillwuapi-rulesFoundational rules for any code that calls wuapi, the WhatsApp API for developers (REST at api.wuapi.dev, npm package `@wuapidev/sdk`). Always load it before writing or reviewing wuapi code; it covers what wuapi is and is not, auth and the WUAPI_API_KEY variable, the naming and identity conventions, projects and the Wuapi-Project header, the error shape and codes, pagination, the Idempotency-Key header, rate limit headers, per-number pacing, choosing Webhooks or Streams for receiving events, webhook signing and where the full docs live.