API WhatsApp pour les agences de communication : tutoriel 2026

Connecter l'API WhatsApp Business à la stack technique d'une agence de communication prend moins d'une journée si vous suivez les bonnes étapes. Ce tutoriel détaille le processus complet : création du compte, onboarding client via embedded signup, envoi du premier message et gestion des webhooks en production.

Étape 1 : choisir son accès BSP et créer son compte

L'API WhatsApp Business n'est pas accessible directement via Meta pour la majorité des acteurs. Il faut passer par un BSP (Business Solution Provider) ou un Meta Tech Provider certifié. Cette étape est critique : le BSP conditionne la qualité de l'infrastructure, les tarifs et le niveau de support.

Ce qu'il faut vérifier avant de signer :

• Hébergement des données en Europe (obligation RGPD)
• Support de l'embedded signup pour onboarder les clients sans friction
• Architecture multi-tenant avec isolation des données par client
• Documentation API complète et sandbox de test disponible
• Tarifs transparents, sans frais cachés sur le volume

Une fois le compte BSP ouvert, vous recevez vos credentials API : un token d'authentification et l'URL de base de l'API REST.

Pour comparer les options disponibles, consultez notre comparatif des meilleurs BSP WhatsApp en France.

Étape 2 : onboarder un client via l'embedded signup

L'embedded signup est le mécanisme qui permet à votre client final de connecter son numéro WhatsApp Business directement depuis votre interface, sans passer par le Business Manager Meta.

Déroulé du processus :

1. Intégrez le widget embedded signup dans votre interface (code fourni par votre BSP).
2. Le client clique sur "Connecter WhatsApp" dans votre tableau de bord.
3. Il s'authentifie avec son compte Facebook Business.
4. Il enregistre ou transfère son numéro de téléphone professionnel.
5. Il vérifie le numéro par SMS ou appel.
6. Le numéro est opérationnel sous 5 à 15 minutes.

L'agence reçoit automatiquement les credentials associés à ce nouveau numéro via webhook ou callback. Aucune intervention manuelle n'est nécessaire de votre côté.

Point d'attention : un numéro déjà enregistré sur l'application WhatsApp Business standard doit d'abord être dissocié avant de pouvoir être intégré via API.

Étape 3 : créer et soumettre un template

Les messages proactifs (envoyés en dehors d'une conversation ouverte par le client) doivent utiliser des templates approuvés par Meta. Voici comment créer et soumettre un template via l'API.

Requête de création de template (exemple REST) :

POST /v1/templates
Authorization: Bearer {YOUR_TOKEN}
Content-Type: application/json

{
  "name": "confirmation_rdv",
  "category": "UTILITY",
  "language": "fr",
  "components": [
    {
      "type": "BODY",
      "text": "Bonjour {{1}}, votre rendez-vous du {{2}} à {{3}} est confirmé."
    },
    {
      "type": "FOOTER",
      "text": "Répondez STOP pour vous désinscrire."
    }
  ]
}

Meta examine les templates sous 24 heures en moyenne. Une fois approuvé, le template est disponible pour tous les envois proactifs sur ce numéro.

Les catégories de templates (MARKETING, UTILITY, AUTHENTICATION) ont un impact direct sur la facturation. Apprenez à choisir la bonne catégorie dans notre article sur les catégories de templates WhatsApp.

Étape 4 : envoyer le premier message et configurer les webhooks

Envoi d'un message avec template :

POST /v1/messages
Authorization: Bearer {YOUR_TOKEN}
Content-Type: application/json

{
  "to": "33612345678",
  "type": "template",
  "template": {
    "name": "confirmation_rdv",
    "language": { "code": "fr" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Marie" },
          { "type": "text", "text": "15 août 2026" },
          { "type": "text", "text": "14h30" }
        ]
      }
    ]
  }
}

La réponse contient un message_id qui permet de suivre le statut de livraison.

Configuration des webhooks :

Les webhooks permettent de recevoir en temps réel les événements liés aux messages :

Événement	Description
message.sent	Message accepté par les serveurs WhatsApp
message.delivered	Message livré sur l'appareil du destinataire
message.read	Message lu par le destinataire
message.failed	Échec de livraison (numéro invalide, etc.)
message.received	Message entrant d'un utilisateur

Configurez l'URL de votre endpoint dans votre dashboard BSP. Votre endpoint doit répondre en HTTP 200 sous 10 secondes, sinon le webhook sera rejoué.

FAQ

Combien de temps faut-il pour envoyer le premier message via l'API ?

En partant de zéro avec Whakup, le premier message peut être envoyé en moins d'une journée : création du compte (30 minutes), onboarding du numéro via embedded signup (15 minutes), création d'un template (24 heures d'approbation Meta), envoi du premier message (quelques minutes). Sans l'attente d'approbation du template, la mise en route technique prend moins de 2 heures.

Peut-on tester l'API sans connecter un vrai numéro client ?

Oui. Les BSP sérieux proposent un environnement sandbox avec un numéro de test. Cela permet de valider les appels API, les webhooks et le format des templates avant la mise en production.

Comment l'agence isole-t-elle les données de chaque client ?

L'architecture multi-tenant attribue à chaque client un identifiant unique (account_id ou phone_number_id). Tous les appels API incluent cet identifiant, ce qui garantit que les messages, templates et statistiques d'un client ne sont jamais accessibles depuis un autre compte.

Que se passe-t-il si un webhook échoue ?

La plupart des BSP implémentent un mécanisme de retry avec backoff exponentiel : le webhook est renvoyé plusieurs fois à intervalles croissants (ex. : 1 min, 5 min, 30 min). Si l'endpoint reste indisponible trop longtemps, les événements peuvent être perdus. Il est recommandé de logguer tous les webhooks entrants dans une file d'attente durable.

---

Ce tutoriel couvre les étapes fondamentales pour démarrer avec l'API WhatsApp dans un contexte agence. Pour une vision complète des capacités de l'API et de l'écosystème BSP, consultez notre guide complet de l'API WhatsApp Business.

Prêt à intégrer WhatsApp dans votre offre agence ? Démarrez avec l'API WhatsApp de Whakup et connectez votre premier client en moins d'une journée.