Passer au contenu principal
Ce guide détaille le parcours de session hébergée avec l’objectif whatsapp. Votre clé doit avoir Gérer les intégrations.

1. Préparer l’agent

Créez ou choisissez l’agent qui répondra sur le numéro du client (POST /agents ou GET /agents). Gardez son identifiant, AGI-XXXXX.

2. Créer la session quand le client clique sur « Connecter WhatsApp »

Enregistrez body.id avec le client concerné, puis redirigez le client vers body.url. Le lien est valable expires_in minutes (60 par défaut, 24 heures au maximum).

3. Le client connecte son numéro

Sur la page Shortext, le client se connecte à Facebook, choisit ou crée son portefeuille Meta Business et son compte WhatsApp Business, puis ajoute et vérifie son numéro. Shortext le renvoie ensuite vers :

4. Confirmer sur votre serveur

Affichez un état d’attente sur votre page de retour, et confirmez côté serveur :
  • écoutez hosted_session.completed / hosted_session.failed sur votre webhook (filtrez sur purpose si besoin), ou
  • appelez GET /hosted-sessions/{session_id}.
En cas de succès, result.channels liste les numéros connectés :
Enregistrez l’id de chaque canal pour le client : c’est le channel_id depuis lequel envoyer les messages. En cas de failed, affichez error et proposez de réessayer avec une nouvelle session.

5. Aller plus loin

  • Envoyez les premiers messages du client avec des modèles.
  • Déplacez le numéro vers un autre agent avec PUT /channels/whatsapp/{id}/agent.
  • Connectez une boîte mail de la même façon avec l’objectif mail.