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 »
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.failedsur votre webhook (filtrez surpurposesi besoin), ou - appelez
GET /hosted-sessions/{session_id}.
result.channels liste les numéros connectés :
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.