---
slug: "whatsapp-cloud-api"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/bellopushon/whatsapp-cloud-api@main/README.md"
repo: "https://github.com/bellopushon/whatsapp-cloud-api"
source_file: "README.md"
branch: "main"
---
# 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](https://developers.facebook.com/docs/whatsapp/cloud-api).

## Installation

```bash
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:

1. **Level 1** — Only the skill name and description are loaded at startup (~100 tokens)
2. **Level 2** — The SKILL.md body loads when the agent detects WhatsApp-related work (~4500 tokens)
3. **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](https://developers.facebook.com/docs/whatsapp/cloud-api).

## Author

**Bello Sánchez** — [GitHub](https://github.com/bellopushon)

## License

MIT