# Documentation de l'API WhatsApp Business

URL: https://wa.genuka.com/docs
Language: French

> La WhatsApp Business Platform officielle via une API REST, sans passer par Meta vous-même.

Genuka WA vous donne accès à la **WhatsApp Business Platform officielle de Meta** à travers une
API REST simple. Vous n'avez ni compte développeur Meta à créer, ni dossier de fournisseur à
déposer auprès de Meta, ni jeton d'accès à faire tourner : Genuka est Meta Tech Provider et porte
cette complexité à votre place. La vérification d'entreprise Meta n'est pas requise pour démarrer ;
c'est elle qui, en pratique, ouvre les codes OTP et des plafonds d'envoi plus hauts
([détails](https://wa.genuka.com/docs/guides/without-meta-verification)).

## Ce que vous pouvez faire

* [Envoyer des messages](https://wa.genuka.com/docs/messages): Texte, médias, boutons, listes, formulaires — et des templates approuvés pour joindre un
  client hors de la fenêtre de 24 h.
* [Recevoir des événements](https://wa.genuka.com/docs/webhooks): Messages entrants, accusés de livraison et de lecture, statuts de templates, désinscriptions
  marketing.
* [Automatiser vos campagnes](https://wa.genuka.com/docs/campaigns): Diffusez un template à une liste de contacts et suivez chaque envoi jusqu'à la lecture.
* [Intégrer en TypeScript](https://wa.genuka.com/docs/library): `@genuka/whatsapp` fournit des builders typés qui refusent les payloads invalides avant
  l'appel réseau.

## Les deux règles à connaître avant de commencer

WhatsApp n'est pas un canal d'envoi libre. Deux contraintes structurent toute intégration, et il
vaut mieux les rencontrer ici que dans vos logs de production.

> [!WARNING]
> **La fenêtre de service de 24 heures**
>
> Vous pouvez envoyer un message libre — texte, image, boutons — uniquement dans les **24 heures**
> qui suivent le dernier message reçu de ce contact. Passé ce délai, seul un **template approuvé**
> par Meta sera délivré. Toute autre tentative échoue avec l'erreur `131047`.

> [!NOTE]
> **L'opt-in est obligatoire**
>
> Vous ne pouvez écrire qu'à des personnes qui ont accepté d'être contactées. Un utilisateur peut
> se désinscrire des messages marketing à tout moment ; vous en êtes notifié par webhook et
> l'envoi doit cesser immédiatement.

## Par où commencer

Si vous découvrez la plateforme, suivez le [démarrage rapide](https://wa.genuka.com/docs/quickstart) : compte, numéro
connecté, premier message, en une dizaine de minutes.

Si vous intégrez depuis du code existant, allez directement à
l'[authentification](https://wa.genuka.com/docs/authentication) puis à l'[envoi de messages](https://wa.genuka.com/docs/messages).

## Guides, comparatifs et codes d'erreur

* [Guides](https://wa.genuka.com/docs/guides): Un cas d'usage par page : codes OTP, notifications de commande, campagnes, webhooks,
  coexistence, tarifs Meta en Afrique.
* [Comparatifs](https://wa.genuka.com/docs/compare): Genuka WA face à Twilio, 360dialog, WATI et aux API WhatsApp non officielles.
* [Codes d'erreur](https://wa.genuka.com/docs/errors): Les codes d'erreur de Meta (131047, 131026, 130429…), un par page : ce que chacun signifie,
  s'il faut réessayer.

## Pour les agents IA et les outils

* **Serveur MCP** : `@genuka/whatsapp-mcp` donne à Claude, Cursor ou VS Code l'accès à vos
  numéros, templates et campagnes. Installation dans [API WhatsApp pour agents IA](https://wa.genuka.com/docs/guides/ai-agents).
* **[/llms.txt](https://wa.genuka.com/llms.txt)** : l'index de toute la documentation pour les modèles de langage, et
  [/llms-full.txt](https://wa.genuka.com/llms-full.txt) pour toutes les pages en un seul fichier.
* **Markdown de chaque page** : ajoutez `.mdx` à son URL, par exemple
  [/docs/quickstart.mdx](https://wa.genuka.com/docs/quickstart.mdx).
* **[/openapi.json](https://wa.genuka.com/openapi.json)** : l'API REST décrite en OpenAPI 3.1.
* **[/pricing.md](https://wa.genuka.com/pricing.md)** : les forfaits et leurs limites, en Markdown.
