WhatsApp Bridge
SkillCommunicationAdd WhatsApp as a chat channel for the agent, routing inbound WhatsApp messages into the chat engine and replies back out. Use when the user wants to talk to the bot over WhatsApp, set up a WhatsApp number, or bridge WhatsApp into the existing multi-platform chat interface.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the WhatsApp Bridge skill
What this skill tells your AI
The instructions your AI receives, as published by thesmokedev/taskchad-os in optional-skills/communication/whatsapp-bridge/SKILL.md and read by ahel’s review.
Wire WhatsApp into the existing chat interface as one more channel adapter. The
framework already abstracts Telegram/Slack/Discord (see .claude/sections/02_*);
this adds a WhatsApp adapter behind the same interface — it does not fork the
engine.
Provider
Use the WhatsApp Cloud API (Meta) or an equivalent gateway (e.g. Twilio for WhatsApp). Both deliver inbound messages via webhook and accept outbound sends via REST.
Required .env values:
WHATSAPP_PHONE_NUMBER_ID=
WHATSAPP_ACCESS_TOKEN=
WHATSAPP_VERIFY_TOKEN= # for webhook handshake
WHATSAPP_ALLOWED_NUMBERS= # comma-separated allowlist
Adapter contract
Implement the channel adapter to match the existing chat interface:
- Inbound — verify the webhook signature, drop senders not in
WHATSAPP_ALLOWED_NUMBERS, normalize the payload to the engine's message shape, and hand it to the router. - Outbound — render the engine's reply to WhatsApp's message format and POST it to the Cloud API.
Security
- Enforce
WHATSAPP_ALLOWED_NUMBERSon every inbound message — mirror theTELEGRAM_ALLOWED_USER_IDSallowlist pattern. Unknown senders are dropped, not answered. - Outbound sends are mutations: route them through the
chat.sendcapability gate with an audit trail. Never call the WhatsApp API directly from a tool. - Verify the webhook
X-Hub-Signature-256HMAC before trusting any payload.
Signals
- GitHub stars
- 23
- Forks
- 5
- Last commit
- Sep 2026
ahel review
S4info
community integration — published by thesmokedev, not whatsapp
Automated review, not a security audit. Ruleset v1+k2.
Advanced
- Catalog kind
- skill
- Gateway key
whatsapp-bridge- Source
- github.com/thesmokedev/taskchad-os