Configuration de WhatsApp
Argonautas prend en charge la messagerie WhatsApp bidirectionnelle. Une fois connecté, les messages WhatsApp des invités apparaissent dans votre boîte de réception unifiée aux côtés des e-mails, SMS et messages OTA. Ce guide couvre le processus complet de configuration, les exigences relatives aux modèles de messages et le dépannage.
Aperçu
L'API WhatsApp Business est la base de la communication professionnelle via WhatsApp. Contrairement à l'application WhatsApp grand public, l'API Business permet à votre équipe de gérer les conversations depuis une boîte de réception partagée, d'envoyer des messages modèles et d'automatiser les réponses — le tout sans lier le canal à un seul téléphone. Argonautas se connecte à votre compte WhatsApp Business pour gérer l'approvisionnement des numéros, le routage et la livraison des messages.
Prérequis
Avant de commencer, assurez-vous d'avoir les éléments suivants :
| Prérequis | Détails |
|---|---|
| Numéro WhatsApp Business | Un numéro de téléphone enregistré (ou pouvant être enregistré) avec WhatsApp Business. Il peut s'agir d'un nouveau numéro ou d'un numéro existant — mais il ne doit pas être actuellement utilisé avec l'application WhatsApp grand public. |
| Compte fournisseur de messagerie | Un compte actif chez notre fournisseur de messagerie WhatsApp, avec accès API. Votre clé API doit avoir ces autorisations : Channels Sending and Receiving, Contacts API Access, Numbers API Access, Template Management, Webhook Subscription Management, Channels Viewer, Conversations API Access. Contactez le support si vous avez besoin d'aide pour obtenir des identifiants. |
| Facebook Business Manager | Un compte Meta Business vérifié lié à votre profil WhatsApp Business. L'API WhatsApp Business nécessite une vérification Meta. |
| Accès administrateur à Argonautas | Vous avez besoin de privilèges d'administrateur pour configurer les canaux de messagerie dans Paramètres. |
Connexion de votre numéro
Étape 1 : Configurer les identifiants du fournisseur
- Accédez à Paramètres > Messagerie dans Argonautas.
- Dans la section WhatsApp, cliquez sur Connecter WhatsApp.
- Saisissez votre Clé API et votre ID d'espace de travail. Ils se trouvent dans le tableau de bord de votre fournisseur de messagerie, sous Paramètres API.
- Cliquez sur Vérifier la connexion pour confirmer que les identifiants sont valides.
Étape 2 : Sélectionner votre numéro
Une fois les identifiants vérifiés, Argonautas interroge votre espace de travail de messagerie pour trouver les numéros WhatsApp disponibles :
- Une liste des numéros enregistrés apparaît dans la fenêtre modale de connexion.
- Sélectionnez le numéro que vous souhaitez connecter.
- Cliquez sur Connecter.
Le système crée automatiquement le connecteur de canal et les abonnements webhook nécessaires. Vous n'avez pas besoin de configurer manuellement les webhooks.
[Capture d'écran : La fenêtre modale Connecter WhatsApp montrant les identifiants vérifiés et une liste de numéros disponibles à connecter.]
Étape 3 : Vérifier la connexion
Après la connexion, la section WhatsApp dans Paramètres > Messagerie affiche :
- Statut : Connecté (indicateur vert)
- Numéro : Votre numéro WhatsApp Business connecté
- ID du canal : L'identifiant du canal (utile pour les demandes d'assistance)
Pour confirmer que tout fonctionne de bout en bout, envoyez un message de test (voir Test ci-dessous).
Modèles de messages
L'API WhatsApp Business nécessite des modèles de messages pré-approuvés pour initier des conversations avec les clients. Vous pouvez répondre librement dans un délai de 24 heures après le dernier message du client, mais démarrer une nouvelle conversation ou envoyer un message après l'expiration de ce délai nécessite un modèle.
Règles relatives aux modèles
- Les modèles doivent être soumis à Meta pour approbation via notre fournisseur de messagerie.
- L'approbation prend généralement 24 à 48 heures.
- Les modèles peuvent inclure des variables dynamiques (par exemple, nom de l'invité, date d'arrivée, nom de la propriété) qui sont remplies au moment de l'envoi.
- Les modèles doivent respecter les politiques de contenu de Meta — pas de contenu promotionnel dans les modèles utilitaires, pas d'informations trompeuses.
Modèles courants pour la gestion de propriétés
| Nom du modèle | Cas d'utilisation | Exemple de contenu |
|---|---|---|
| Confirmation de réservation | Envoyé lorsqu'une nouvelle réservation est confirmée | "Bonjour , votre réservation à du au est confirmée." |
| Informations pré-arrivée | Envoyé 1 à 2 jours avant l'arrivée | "Bienvenue ! Voici vos instructions d'arrivée pour ..." |
| Suivi post-départ | Envoyé après le départ | "Merci d'avoir séjourné à . Nous espérons que vous avez apprécié votre visite." |
| Rappel de paiement | Envoyé lorsque le solde est dû | "Bonjour , un paiement de est dû pour votre prochain séjour." |
Les modèles sont gérés dans Paramètres > Messagerie > Modèles. Créez le contenu du modèle dans Argonautas, et il est soumis à Meta pour approbation.
Tester la connexion
Après la configuration, vérifiez que les messages circulent correctement dans les deux sens :
- Test entrant : Envoyez un message WhatsApp depuis un téléphone personnel vers votre numéro Business connecté. Le message devrait apparaître dans la Boîte de réception d'Argonautas en quelques secondes.
- Test sortant : Depuis la Boîte de réception, répondez au message de test. La réponse devrait arriver sur le téléphone personnel sous forme de message WhatsApp provenant de votre numéro Business.
- Test de modèle : Si vous avez des modèles approuvés, utilisez la fonction de composition pour envoyer un message modèle à un numéro de test. Vérifiez que le modèle s'affiche correctement avec les variables remplies.
Si une étape échoue, consultez la section de dépannage ci-dessous.
Dépannage
Les messages n'arrivent pas dans la Boîte de réception
Vérifiez la configuration du webhook. Argonautas enregistre automatiquement les webhooks lors de la configuration. Si les webhooks ont été accidentellement supprimés, déconnectez et reconnectez le canal WhatsApp dans Paramètres > Messagerie pour les réenregistrer.
Vérifiez les autorisations de la clé API. La clé API doit inclure les autorisations "Channels Sending and Receiving" et "Webhook Subscription Management". Des autorisations manquantes empêcheront la livraison des messages.
Vérifiez le tableau de bord de votre fournisseur. Confirmez que le canal apparaît comme actif. Si le fournisseur signale des échecs de livraison, le problème est en amont d'Argonautas.
Échec des messages sortants
Délai de 24 heures expiré. Si plus de 24 heures se sont écoulées depuis le dernier message du client, vous devez utiliser un modèle approuvé pour réinitier la conversation. Les messages libres seront rejetés par WhatsApp.
Modèle non approuvé. Vérifiez le statut d'approbation du modèle dans Paramètres > Messagerie > Modèles. Les modèles en attente ou rejetés ne peuvent pas être envoyés.
Numéro non vérifié. Si la vérification de votre compte Meta Business est incomplète, WhatsApp peut restreindre l'envoi de messages sortants. Terminez la vérification dans Meta Business Manager.
La connexion apparaît comme déconnectée
Clé API expirée ou révoquée. Générez une nouvelle clé API dans le tableau de bord de votre fournisseur et mettez-la à jour dans Paramètres > Messagerie.
Problème d'espace de travail. Vérifiez que l'ID de l'espace de travail est correct et que l'espace de travail est actif. Le fournisseur nécessite occasionnellement une ré-authentification après des changements de facturation ou de forfait.
Reconnectez le canal. Si les identifiants sont corrects mais que la connexion reste inactive, déconnectez le canal WhatsApp et reconnectez-le. Cela réenregistre tous les connecteurs et webhooks.
Messages livrés mais pas de reçus de lecture
Les reçus de lecture (deux coches bleu-vert) dépendent des paramètres de confidentialité WhatsApp du destinataire. Si un invité a désactivé les reçus de lecture sur son téléphone, les messages apparaîtront comme livrés (deux coches grises) mais jamais comme lus. Il s'agit d'un comportement normal de WhatsApp et non d'un problème système.
Concepts clés
- Délai de 24 heures — Règle de WhatsApp qui permet des réponses libres uniquement dans les 24 heures suivant le dernier message du client. Après cela, seuls les modèles approuvés peuvent être envoyés.
- Modèle de message — Un format de message pré-approuvé requis pour initier des conversations ou envoyer des messages en dehors du délai de 24 heures.
- Webhook — Un rappel HTTP automatisé utilisé pour envoyer (push) les messages entrants à Argonautas en temps réel.
Questions courantes
Puis-je utiliser mon numéro WhatsApp existant ? Oui, mais le numéro doit être migré vers l'API WhatsApp Business. Cela signifie qu'il ne fonctionnera plus avec les applications WhatsApp grand public ou WhatsApp Business. La migration est gérée via votre fournisseur de messagerie et Meta Business Manager.
Combien de numéros WhatsApp puis-je connecter ? Vous pouvez connecter un numéro WhatsApp par entreprise dans Argonautas. Si vous gérez plusieurs marques ou entreprises, chacune peut avoir son propre numéro.
Les invités doivent-ils enregistrer mon numéro pour me contacter ? Non. Les invités peuvent envoyer un message directement à votre numéro WhatsApp Business. Cependant, enregistrer votre numéro facilite la recherche et la prise de contact pour les invités.
Que se passe-t-il si le fournisseur de messagerie subit une panne ? Les messages WhatsApp entrants et sortants seront retardés jusqu'à la résolution de la panne. Les messages sont mis en file d'attente et livrés une fois la connectivité rétablie. Contactez le support pour des mises à jour d'état en temps réel.
Puis-je envoyer des messages WhatsApp aux invités ayant réservé via Airbnb ? Seulement si vous avez le numéro de téléphone de l'invité et qu'il a initié une conversation WhatsApp avec vous (ou si vous avez un modèle approuvé pour le contacter). Les politiques de confidentialité des OTA peuvent limiter la disponibilité des numéros de téléphone.
Liens connexes
- Guide de messagerie — La boîte de réception unifiée et la gestion des conversations.
- Configuration SMS — Connexion des canaux SMS.
- Paramètres : Messagerie — Toutes les options de configuration des canaux de messagerie.