Skip to content
Documentation Wasel

03 — Onboarding WhatsApp

1. Objectif métier

Section titled “1. Objectif métier”

Rendre le canal WhatsApp pleinement exploitable pour l’équipe: envoi, réception, traçabilité et stabilité.

Succès attendu:

  • canal lié au bon compte,
  • numéro opérationnel,
  • événements entrants bien reçus,
  • tests réels validés (sortant + entrant).

Ce module est critique: sans onboarding complet, le support peut sembler actif alors que des messages se perdent.

2. Qui utilise ce module (admin/operator)

Section titled “2. Qui utilise ce module (admin/operator)”
  • admin: réalise l’onboarding, vérifie les statuts, gère la correction si liaison partielle.
  • operator: confirme que les conversations remontent correctement et que la réponse est possible en condition réelle.

3. Prérequis

Section titled “3. Prérequis”

Préparer avant de lancer l’onboarding:

  • organisation active,
  • accès au compte WhatsApp Business du client,
  • numéro à connecter validé,
  • responsable métier désigné pour valider les tests.

Préparer un plan de test simple:

  • 1 numéro interne pour test,
  • 1 message sortant court,
  • 1 réponse entrante depuis ce numéro,
  • 1 capture de preuve (heure + résultat).

Contrainte importante:

  • pour certains onboardings, la synchronisation initiale (contacts/historique) doit être déclenchée rapidement après connexion.

4. Procédure pas-à-pas (orientée actions produit)

Section titled “4. Procédure pas-à-pas (orientée actions produit)”
  1. Lancer la connexion WhatsApp depuis l’espace d’intégrations.
  • Finaliser l’autorisation jusqu’au retour dans la plateforme.
  1. Vérifier l’identité du compte lié.
  • Vérifier le compte business affiché.
  • Vérifier que le numéro relié est le bon.
  1. Vérifier l’état d’onboarding.
  • Cible de fin: état completed.
  • Si état partiel (linked ou linked_no_webhook), ne pas passer en production.
  1. Vérifier l’activation des événements entrants.
  • Sans réception des événements, l’inbox sera incomplète.
  1. Exécuter le test sortant.
  • Envoyer un message de test au numéro interne.
  • Vérifier réception côté téléphone.
  1. Exécuter le test entrant.
  • Répondre depuis le téléphone test.
  • Vérifier apparition en conversation côté équipe.
  1. Vérifier la traçabilité complète.
  • Le message sortant et entrant doivent être visibles dans le fil.
  • L’opérateur doit pouvoir prendre et traiter la conversation.
  1. Si le canal est partiellement relié, lancer la procédure de correction d’onboarding.
  • Refaire ensuite le cycle complet de tests.
  1. Clôturer l’onboarding avec preuve.
  • Capturer état final + heure des tests + validation admin/opérateur.

5. Scénarios concrets (minimum 2)

Section titled “5. Scénarios concrets (minimum 2)”

  • Scénario A (onboarding direct réussi):

    • liaison terminée,
    • état completed,
    • test entrant/sortant validé en moins de 15 minutes.

  • Scénario B (liaison partielle):

    • état linked_no_webhook,
    • correction relancée,
    • second test validé,
    • passage production seulement après validation complète.

  • Scénario C (historique initial à récupérer):

    • onboarding business app,
    • synchronisation initiale déclenchée,
    • suivi des premières heures pour confirmer la remontée de données.

6. Erreurs fréquentes et résolution

Section titled “6. Erreurs fréquentes et résolution”

  • Problème: canal “lié” mais conversations entrantes absentes.

  • Résolution: vérifier activation réception événements, puis relancer test entrant.

  • Problème: mauvais compte ou mauvais numéro relié.

  • Résolution: reprendre la liaison avec le bon compte avant tout lancement.

  • Problème: statut bloqué en état partiel.

  • Résolution: lancer la correction d’onboarding, puis revalider de bout en bout.

  • Problème: équipe pense que c’est “ok” sans test réel.

  • Résolution: imposer la règle “pas de go-live sans test entrant + sortant”.

7. Bonnes pratiques et limites

Section titled “7. Bonnes pratiques et limites”
  • Faire l’onboarding avec un admin + un opérateur connectés en même temps.
  • Utiliser toujours un numéro de test interne disponible immédiatement.
  • Éviter de modifier compte, numéro et paramètres dans la même session.
  • Maintenir une surveillance quotidienne du canal pendant la première semaine.

Limites:

  • un état partiel peut fonctionner en apparence mais casser des flux critiques,
  • certaines synchronisations initiales ne sont pas instantanées,
  • en cas d’échec de synchronisation initiale, une action corrective rapide est nécessaire.

8. Référence rapide (champs/statuts/modes)

Section titled “8. Référence rapide (champs/statuts/modes)”

États d’onboarding observés:

  • unlinked: pas encore relié,
  • linked: liaison faite mais vérifications complémentaires à finir,
  • linked_no_webhook: liaison incomplète (événements non confirmés),
  • completed: prêt pour exploitation,
  • verified / subscribed: états intermédiaires possibles selon parcours.

Checklist de validation finale:

  • bon compte business,
  • bon numéro,
  • réception événements active,
  • test sortant réussi,
  • test entrant réussi,
  • traçabilité visible dans inbox.

9. Liens vers modules liés

Section titled “9. Liens vers modules liés”