WhatsApp pour le support client via l'API : cas pratique pour les éditeurs

Intégrer WhatsApp dans un support client via l'API Business, c'est remplacer un canal lent (email) et coûteux (téléphone) par un canal que vos utilisateurs finaux utilisent déjà au quotidien. Pour un éditeur de plateforme helpdesk, CRM ou SaaS, cela se traduit par un nouveau canal entrant et sortant, géré programmatiquement, sans interface manuelle.

Voici comment ce flux fonctionne concrètement, de la réception du premier message jusqu'à la clôture du ticket.

Anatomie d'un ticket support sur WhatsApp API

Quand un client envoie un message WhatsApp à votre numéro dédié, Meta transmet l'événement à votre webhook en temps réel. Votre plateforme reçoit un payload JSON structuré contenant :

• L'identifiant du numéro expéditeur (WAID)
• Le contenu du message (texte, image, document, audio)
• Le timestamp et le message ID
• Le statut de lecture si l'utilisateur l'a activé

À partir de là, votre logique métier prend le relais : création ou mise à jour du ticket, assignation à un agent, déclenchement d'un bot de qualification, etc.

Un point critique : la fenêtre de service de 24 heures. Dès qu'un utilisateur vous envoie un message, vous disposez de 24 heures pour répondre librement. Passé ce délai, vous devez utiliser un template approuvé par Meta. Votre plateforme doit gérer ce timer par ticket — c'est une contrainte à coder dès la conception de l'intégration.

Flux concret : de la réception au ticket résolu

Voici le flux typique implémenté par les éditeurs de helpdesk qui s'appuient sur l'API WhatsApp Business de Whakup :

Étape 1 — Réception du webhook

POST /webhook/whatsapp
{
  "object": "whatsapp_business_account",
  "entry": [{
    "changes": [{
      "value": {
        "messages": [{ "from": "336XXXXXXXX", "text": { "body": "Mon colis est bloqué" } }]
      }
    }]
  }]
}

Étape 2 — Qualification automatique Votre bot envoie un message interactif (liste ou boutons) pour qualifier la demande : type de problème, numéro de commande, urgence. Ce message passe en session ouverte — pas de template requis.

Étape 3 — Assignation à un agent Le ticket est créé dans votre outil interne avec le WAID comme identifiant. L'agent répond via votre interface, qui appelle l'API messages avec le WAID comme destinataire.

Étape 4 — Clôture et CSAT À la résolution, votre système envoie un template de satisfaction client (catégorie Utility, ~0,0336 €/msg pour les numéros FR). L'utilisateur répond par un bouton de notation.

Étape	Type de message	Coût indicatif (FR)
Qualification bot	Message libre (session)	Inclus dans la conversation
Réponse agent	Message libre (session)	Inclus dans la conversation
Relance après 24h	Template Utility	~0,0336 €
Enquête CSAT	Template Utility	~0,0336 €

Gestion du multi-agent et du multi-numéro

Un éditeur qui sert plusieurs clients (marque A, marque B) doit isoler les conversations par WABA (WhatsApp Business Account). L'architecture multi-tenant de Whakup permet d'associer un numéro dédié par client sans partager les conversations entre comptes.

Points d'architecture à anticiper :

• Routing par numéro entrant : le webhook reçoit le phone_number_id qui identifie le numéro destinataire. C'est ce champ qui permet de router vers le bon tenant.
• Gestion des statuts de message : les webhooks message_status (sent, delivered, read, failed) doivent alimenter l'interface agent pour afficher l'état de chaque message.
• Rate limits : Meta impose des limites de messagerie par niveau de qualité du numéro. Pour un support à volume élevé, surveillez le quality_rating via l'API ou les webhooks de qualité décrits dans ce guide.

Pour comprendre les niveaux de messagerie et leur impact sur le volume de tickets traitables, consultez notre article sur les limites de messagerie WhatsApp API.

Métriques à exposer dans votre dashboard éditeur

Un support WhatsApp API bien intégré doit tracer au minimum :

• Taux de résolution dans la fenêtre 24h : indicateur clé pour limiter les coûts de templates
• Temps de première réponse (FRT) : mesuré depuis le timestamp du webhook entrant
• Taux de délivrance des templates : ratio delivered/sent sur les messages hors session
• Score qualité du numéro : renvoyé par l'API Meta, à surveiller pour éviter la suspension
• Coût par ticket : somme des conversations facturées / nombre de tickets fermés

Ces métriques différencient une intégration artisanale d'un vrai canal support géré. Elles sont aussi un argument commercial fort pour vos clients finaux.

FAQ

Peut-on utiliser WhatsApp API pour un support 100 % automatisé (sans agent humain) ?

Oui, à condition de gérer correctement la fenêtre de 24h et les cas de sortie de bot. Meta n'impose pas d'agent humain dans le flux. Cependant, certaines catégories de templates (marketing) ne sont pas autorisées dans une conversation initiée par un utilisateur — seuls les messages Utility et Authentication sont recommandés dans ce contexte.

Comment gérer les pièces jointes envoyées par les clients (photos de produit, captures d'écran) ?

Les messages entrants de type image, document ou audio sont transmis via le webhook avec un media_id. Vous devez appeler l'API Media de Meta pour télécharger le fichier avant qu'il n'expire (environ 30 jours). Votre plateforme doit stocker ces médias dans votre propre infrastructure.

L'API WhatsApp supporte-t-elle les transferts entre agents (handoff) ?

L'API elle-même ne gère pas le concept d'agent — c'est votre couche applicative qui orchestre les assignations. Le WAID client reste constant, ce qui permet à n'importe quel agent d'écrire dans la même conversation sans rupture côté utilisateur.

Faut-il un template approuvé pour envoyer le premier message à un client qui n'a pas écrit ?

Oui. Si c'est votre plateforme qui initie la conversation (outbound), vous devez utiliser un template approuvé par Meta, quelle que soit la catégorie. La session libre de 24h ne s'ouvre qu'après que le client a envoyé un message en premier.

---

Pour déployer ce flux dans votre plateforme sans gérer vous-même la certification Meta, découvrez l'API WhatsApp Business Whakup : REST + webhooks, embedded signup, hébergement EU, à partir de 0,0088 €/msg (hors frais Meta). Vos clients peuvent envoyer leurs premiers messages en moins d'une journée.