Documentation développeur — API WhatsApp Geskap

Intégrez WhatsApp (et les services Meta) dans vos projets via une API HTTP simple : authentification, connexion du numéro, templates, envoi de messages, crédits, quotas, webhooks et connecteur MCP pour Claude.

Démarrage

• Introduction — Envoyez des messages template WhatsApp depuis votre propre numéro via une API HTTP simple.

Authentification

• Clés API & scopes — Authentification par clé Bearer sk_live_, affichée une seule fois, avec des scopes par clé.

Connexion WhatsApp

• Connecter votre numéro — Rattachez votre numéro WhatsApp Business à Meta Cloud API par Embedded Signup ou manuellement.

Templates

• Vue d'ensemble — Ce qu'est un template, pourquoi WhatsApp les impose, et le cycle de vie de l'approbation Meta.
• Types de templates — MARKETING, UTILITY, AUTHENTICATION : cas d'usage, tarif et règles d'activation.
• Créer un template — POST /v1/templates : corps, exemples, en-tête image, boutons, et soumission à Meta.
• Variables {{1}} / {{nom}} — Les 5 règles de variables : positionnel ou nommé, exemples requis, comptes exacts. La cause n°1 de rejet.
• Erreurs Meta fréquentes — Les rejets remontent l'erreur Facebook/Meta directement (#code). Table des rejets courants et corrections.
• Lister & supprimer — GET /v1/templates (statut Meta live) et DELETE /v1/templates/{name}.

Messages

• Envoyer un message — POST /v1/messages : envoyer un template approuvé, avec idempotence et remboursement sur échec.
• Statut de livraison — GET /v1/messages/{id} : suivre sent → delivered → read, ou failed.

Crédits & facturation

• Solde & tarification — GET /v1/balance et GET /v1/pricing : solde de tokens, seuil bas, tarif par catégorie, et lien vers la tarification Meta.
• Acheter des crédits — Recharge self-service : listez les packs et payez par carte via Stripe Checkout.

Quotas & limites

• Quotas & limites — Débit par seconde, quota quotidien, allow-list de templates, opt-in marketing, 429 + Retry-After.

Mode partenaire

• Mode partenaire — Modèle standard vs mode partenaire : qui possède le numéro, qui paie Meta, tarif dédié, et pourquoi AUTHENTICATION est réservé aux partenaires.

Webhooks

• Webhooks d'événements — Recevez message.status et message.inbound en temps réel, signés HMAC-SHA256. Vérifiez toujours la signature.

Connecteur Claude (MCP)

• Piloter WhatsApp depuis Claude — Ajoutez une URL dans Claude et envoyez vos templates en langage naturel — sans écrire une ligne de code.

Référence

• Erreurs & codes HTTP — Table des codes HTTP (401/403/400/402/404/429/502), format d'erreur JSON.
• Postman & Swagger — Collection Postman prête à l'emploi et référence interactive Swagger.