原始内容
WhatsApp Cloud API — Agent Skill
The most comprehensive WhatsApp Cloud API reference skill for AI coding assistants. Based entirely on official Meta documentation from developers.facebook.com.
Installation
npx skills add https://github.com/bellopushon/whatsapp-cloud-api --skill whatsapp-cloud-api
What's Included
| Topic | File | Description |
|---|---|---|
| Core API | SKILL.md |
Quick reference, common patterns, best practices |
| Messaging | references/MESSAGING.md |
All message types: text, media, location, contacts, reactions |
| Webhooks | references/WEBHOOKS.md |
Incoming messages, status updates, webhook verification |
| Templates | references/TEMPLATES.md |
Template categories, sending with variables, lifecycle |
| Conversations | references/CONVERSATIONS.md |
24h window, pricing categories, service window |
| Coexistence | references/COEXISTENCE.md |
Business App + Cloud API on one number, onboarding, sync webhooks |
| Media | references/MEDIA.md |
Upload, download, supported formats, size limits |
| Interactive | references/INTERACTIVE.md |
Buttons, lists, products, flows |
| Phone Numbers | references/PHONE-NUMBERS.md |
E.164 format, phone number IDs, verification |
| Error Codes | references/ERROR-CODES.md |
Common errors, rate limits, retry strategies |
How It Works
This skill uses progressive disclosure to minimize token usage:
- Level 1 — Only the skill name and description are loaded at startup (~100 tokens)
- Level 2 — The SKILL.md body loads when the agent detects WhatsApp-related work (~4500 tokens)
- Level 3 — Reference files load on-demand only when the agent needs specific details (0 tokens until accessed)
Compatibility
Works with any AI coding assistant that supports the Agent Skills specification:
- Claude Code
- Cursor
- Windsurf
- GitHub Copilot
Source
All API specifications, endpoints, payload formats, and examples are sourced from the official Meta WhatsApp Business Platform documentation at developers.facebook.com/docs/whatsapp.
Author
Bello Sánchez — GitHub
License
MIT