Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Add WhatsApp Cloud Channel

Installs and verifies the official Meta WhatsApp Business Cloud API channel adapter for a NanoClaw bot.

Web & APIIntermediate★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026

What it does

Wires the official Meta WhatsApp Business Cloud API into a NanoClaw install:

  • Copies whatsapp-cloud.ts and its registration test from the channels branch
  • Appends the one self-registration import to src/channels/index.ts
  • Installs @chat-adapter/whatsapp@4.29.0 at an exact pinned version (no ranges, no latest)
  • Runs pnpm run build plus a registration test that goes red if the barrel import or the dependency drifts
  • Interactively prompts for the four Meta values (Phone Number ID, permanent System User token, App Secret, Verify Token) and writes them to .env set-if-absent
  • Explains the shared webhook server on port 3000, the /webhook/whatsapp-cloud route, and ngrok / Cloudflare Tunnel exposure

Every mechanical step is expressed as an idempotent nc: directive, so the skill is safe to re-run, and upgrade notes cover the move from the old bare whatsapp key (webhook path and Chat SDK state namespace both change).

Who it's for

  • Developers building a WhatsApp support or personal-assistant bot on NanoClaw
  • Teams that want Meta's official API instead of the unofficial Baileys adapter
  • Anyone who installed the older adapter and lost messages after the webhook route moved
  • People who want a battle-tested troubleshooting checklist for webhook verification, token expiry, and the 24-hour reply window

Examples

  1. Fresh setup: ask "add the WhatsApp Cloud channel" — the agent copies the adapter, registers it, installs the pinned package, builds, tests, then collects your four Meta credentials into .env.
  2. Meta's "Verify and save" fails: walk the checklist — service running, WHATSAPP_VERIFY_TOKEN matching exactly, port 3000 publicly reachable at /webhook/whatsapp-cloud.
  3. Everything 401s after a day: you stored the ~24h temporary token; create a System User with whatsapp_business_messaging, mint a permanent token, and swap WHATSAPP_ACCESS_TOKEN.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/add-whatsapp-cloud folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-whatsapp-cloud/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/nanocoai/nanoclaw.git
  2. Create the skills folder: mkdir -p ~/.claude/skills
  3. Copy the skill in: cp -r nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/
  4. Enter the project and install dependencies: cd nanoclaw && pnpm install
  5. Start Claude Code from the project root and say: "add the WhatsApp Cloud channel".
  6. In Meta for Developers, create a Business-type app, add the WhatsApp product, and gather four values: Phone Number ID, a permanent System User access token, App Secret, and your chosen Verify Token — paste them into the prompts.
  7. For local development, expose port 3000 (ngrok http 3000) and set the Meta webhook URL to https://<your-public-url>/webhook/whatsapp-cloud, subscribing to the messages field.
  8. Confirm pnpm run build and the registration test pass, then run /manage-channels to attach the channel to an agent group.
View source on GitHub ↗License: MIT