wangjunxiao/nanoclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
211d2b587785c7b401dd9c6199c464bd5850e349
nanoclaw/.claude/skills/add-whatsapp-cloud-v2/SKILL.md
meeech 211d2b5877 docs: convert all skill instructions from npm to pnpm 
Batch update 62 files across .claude/skills/ — SKILL.md, REMOVE.md,
and script files. Conversions: npm run -> pnpm run, npm install ->
pnpm install, npx -> pnpm exec/dlx, npm uninstall -> pnpm uninstall,
package-lock.json -> pnpm-lock.yaml, shebangs updated.
2026-04-17 09:22:45 +03:00

2.4 KiB
Raw Blame History

name, description
name description
add-whatsapp-cloud-v2 Add WhatsApp Business Cloud API channel to NanoClaw v2 via Chat SDK. Official Meta API.

Add WhatsApp Cloud API Channel

Connect NanoClaw to WhatsApp via the official Meta WhatsApp Business Cloud API.

Pre-flight

Check if src/channels/whatsapp-cloud.ts exists and the import is uncommented in src/channels/index.ts. If both are in place, skip to Credentials.

Install

pnpm install @chat-adapter/whatsapp

Uncomment the WhatsApp Cloud API import in src/channels/index.ts:

import './whatsapp-cloud.js';

Build:

pnpm run build

Credentials

  1. Go to Meta for Developers and create an app (type: Business).
  2. Add the WhatsApp product.
  3. Go to WhatsApp > API Setup:
    • Note the Phone Number ID (not the phone number itself).
    • Generate a permanent System User access token with whatsapp_business_messaging permission.
  4. Go to WhatsApp > Configuration:
    • Set webhook URL: https://your-domain/webhook/whatsapp.
    • Set a Verify Token (any random string you choose).
    • Subscribe to webhook fields: messages.
  5. Copy the App Secret from Settings > Basic.

Configure environment

Add to .env:

WHATSAPP_ACCESS_TOKEN=your-system-user-access-token
WHATSAPP_PHONE_NUMBER_ID=your-phone-number-id
WHATSAPP_APP_SECRET=your-app-secret
WHATSAPP_VERIFY_TOKEN=your-verify-token

Sync to container: mkdir -p data/env && cp .env data/env/env

Next Steps

If you're in the middle of /setup, return to the setup flow now.

Otherwise, run /manage-channels to wire this channel to an agent group.

Channel Info

  • type: whatsapp-cloud
  • terminology: WhatsApp Cloud API supports 1:1 conversations only (no group chats). Each conversation is with a phone number.
  • how-to-find-id: The platform ID is the Phone Number ID from the Meta Business dashboard (not the phone number itself). Find it under WhatsApp > API Setup.
  • supports-threads: no
  • typical-use: Interactive 1:1 chat -- direct messages only
  • default-isolation: Same agent group if you're the only person messaging the bot. Each additional person who messages gets their own conversation automatically, but they share the agent's workspace and memory -- use a separate agent group if you need information isolation between different contacts.