Documentation de l'API
Nous vous donnons une API et vous construisez par-dessus. Exemples en cURL, Node.js, PHP et Python. Les exemples ici utilisent des placeholders (wc_live_…, conn_…) ; dans le panneau, ils sont remplis avec vos vraies données.
Spécification OpenAPI
L'API publique (/v1) dans un fichier OpenAPI 3.1 : importez-le dans Postman/Insomnia, générez un client dans votre langage ou donnez-le à un agent IA pour qu'il consomme l'API sans lire de HTML.
Premiers pas
Avant d'écrire une ligne de code, mieux vaut savoir ce que Meta va vous demander, c'est-à-dire la partie qui ne dépend pas de nous : un numéro à vous, un compte Facebook avec un portefeuille business, une carte dans votre compte Meta et — si vous voulez écrire en premier — un modèle approuvé. Rien de tout cela n'est payant ici et il n'est pas nécessaire de s'inscrire pour le lire. Ce sont six étapes courtes, dans l'ordre où elles se déroulent réellement.
Une fois votre compte créé, le panneau vous indique laquelle de ces six étapes il vous manque, avec l'état réel de votre numéro. Commencer.
- ① Avant de connecter — ce dont vous aurez besoin
- ② Pendant la connexion
- ③ Les démarches Meta, par ordre d'urgence
- ④ Ce qu'est un modèle (et pourquoi il existe)
- ⑤ Pour envoyer
- ⑥ Ce que facture Meta et ce que facture WAIA Connect
- ⑦ Migrating from another provider
Documentation technique en anglais. Les premiers pas sont en français ; la référence de l'API (endpoints, webhooks, erreurs) est en anglais.
Essentiel
- Authentication GET /v1/connections
- Send a text message POST /v1/messages
- Send media (image · document · audio · video) POST /v1/messages
- Receive messages by webhook
- Authenticate the webhook: static header vs signature
- Verify the signature
- Check a message's status GET /v1/messages/:id
- Mark a message as read (and show "typing…") POST /v1/messages/read
- Download inbound media GET /v1/media/:mediaId
- Receive the Coexistence conversation history GET /v1/connections/:id/history
Complet
- Send a template POST /v1/messages
- Send a template with a file in its header POST /v1/messages
- Templates with an image, a document and buttons POST /v1/messages
- Create templates with an image, document and buttons POST /v1/templates/media
- Carousel templates (cards with an image or video) POST /v1/templates
- Create, list and sync templates POST /v1/templates
- Connections and their health GET /v1/connections
- Email notices and the Notices inbox GET /v1/notices
- Hosted onboarding (your customer connects their number) POST /v1/onboarding-links
- Webhooks with the API (and the one born with the onboarding) POST /v1/webhooks
- Integrator journey: onboarding and webhooks 100 % by API GET /v1/onboarding-links/{id}
- Onboarding link intro page: full or minimal PATCH /v1/onboarding-links/{id}
- Automatic help on the signup screen PUT /v1/branding
- Your customers' sign-up cases and «Handled» GET /v1/onboarding-cases
- Templates proposed by your customer POST /v1/template-links
- Usage and limits GET /v1/usage
- Rate limits (per number, per account, per key) POST /v1/messages
- Catalog shopping carts
- Edited and deleted messages
- The 26 event types with their payload
- The full error catalog
- Idempotency, retries and delivery order
Guides
- Connecter votre WhatsApp à WAIA Connect (Coexistence), pas à pas
- WhatsApp dans n8n : le workflow complet de service client, gratuit
- Receive WhatsApp in Supabase with an Edge Function
- Connect WhatsApp to Google Sheets (Apps Script, no coding)
Sécurité et données
Quelque chose ne colle pas ? Écrivez-nous votre question ou demandez un devis.