Intégrations WhatsApp & Mobile Money

Envoyer une facture par WhatsApp, suivre un paiement Wave ou Orange Money : GestSen peut s’interfacer avec ces services pour automatiser votre quotidien. Ces intégrations se configurent par entreprise, avec vos propres clés API. Ce chapitre explique ce qui est automatisable, ce qui est simulé, et les quotas à respecter.

Vidéo à venir

Configurer WhatsApp, Wave et Orange Money. La capture vidéo sera intégrée ici dès qu'elle sera disponible sur Cloudflare Stream.

Comprendre le principe : réel vs simulé

Avant toute chose, une précision essentielle :

• Sans configuration de clés API, GestSen simule les paiements Mobile Money. Vous enregistrez le moyen de paiement (Wave, Orange Money) pour la traçabilité, mais aucun appel réel n’est effectué vers le fournisseur.
• Avec configuration de clés API, GestSen peut échanger avec Wave (API directe) ou Orange Money (via PayTech) pour des flux réels.

Configurer WhatsApp via Twilio

WhatsApp permet d’envoyer automatiquement factures, reçus et rappels à vos clients.

1. Créez un compte sur twilio.com et activez WhatsApp Business.
2. Récupérez vos identifiants : Account SID, Auth Token, numéro From.
3. Dans GestSen, ouvrez Paramètres → Intégrations → WhatsApp.
4. Collez le SID, le Token et le numéro From, puis Enregistrer.
5. Vos credentials sont chiffrés (Laravel Crypt) en base — personne ne peut les lire en clair.

Ce qui se passe automatiquement

Une fois WhatsApp configuré, GestSen envoie :

• Reçu de vente au client après chaque encaissement.
• Facture par message WhatsApp quand vous touchez « Envoyer ».
• Rappel automatique chaque matin à 8h00 pour les factures en retard ou dues sous 3 jours.
• Récap mensuel le 1er de chaque mois sur votre propre numéro.

Respecter le quota WhatsApp

Twilio facture les messages. GestSen applique donc un quota mensuel :

• Plan Free (gratuit) : 20 messages / mois.
• Plan Pro (9 900 FCFA / mois) : 200 messages / mois.

Configurer Wave

Wave est le moyen de paiement Mobile Money le plus utilisé au Sénégal. Pour activer les flux réels :

1. Ouvrez Paramètres → Intégrations → Wave.
2. Collez vos clés API Wave (disponibles dans votre espace marchand Wave).
3. Enregistrez.

Sans ces clés, les paiements Wave sont simulés : GestSen enregistre simplement que le client a payé via Wave, sans vérifier la transaction. Avec les clés, l’application peut effectuer des appels réels à l’API Wave.

Configurer Orange Money via PayTech

Orange Money passe par l’agrégateur PayTech. La configuration est identique :

1. Créez un compte marchand sur PayTech.
2. Récupérez vos clés API PayTech.
3. Dans Paramètres → Intégrations → Orange Money, collez les clés.
4. Enregistrez.

Comme pour Wave, sans configuration, les paiements Orange Money sont simulés pour la traçabilité. Avec les clés, les appels deviennent réels via PayTech.

Webhooks entrants : paiements reçus

Wave et Orange Money peuvent notifier GestSen via des webhooks entrants (/webhooks/wave, /webhooks/orange-money) quand un paiement aboutit. Cela permet de marquer une facture comme payée automatiquement, dès que le client règle via Mobile Money.

Checklist

Avant de passer au chapitre suivant, vérifiez que vous avez :

• Compris la différence entre paiement simulé et paiement réel
• Configuré Twilio pour WhatsApp (si souhaité)
• Repéré où coller les clés Wave et Orange Money
• Noté le quota WhatsApp de votre plan

Prochaine étape

Pour aller plus loin dans l’automatisation, le chapitre suivant présente les clés API et webhooks sortants, qui permettent à un intégrateur de connecter GestSen à d’autres outils (comptabilité, ERP, tableurs).