Configuration WhatsApp
WhatsApp est le canal que les membres lisent vraiment. Des taux d'ouverture au-delà de 95 % sont typiques, et la plupart de notre base d'utilisateurs rapporte un meilleur engagement sur WhatsApp qu'en e-mail ou SMS. GCM prend en charge trois manières différentes de brancher un compte WhatsApp, chacune avec ses propres compromis.
Cette page couvre la configuration des identifiants du fournisseur. Pour utiliser WhatsApp une fois connecté, voir le guide de messagerie WhatsApp.
Choisir un fournisseur
Trois options, avec des profils de coût et de complexité très différents :
| Fournisseur | Ce que c'est réellement | Configuration | Coût | Idéal pour |
|---|---|---|---|---|
| WACRM (basé WAHA) | Votre vrai compte WhatsApp, contrôlé via l'API web de WAHA | faible — scanner un QR | faible | la plupart des églises |
| WhatsApp Official | L'API Business de Meta directement | élevée | par message après le palier gratuit | gros volume, modèles uniquement |
| smsmobileapi WhatsApp | Un relais via le WhatsApp de votre téléphone | faible | inclus avec SMS | régions où les autres sont limitées |
TIP
Nous recommandons WACRM pour presque tout le monde. Ne basculez sur Official que lorsque vous avez vraiment besoin de messages modèles en dehors de la fenêtre de service client de 24 heures à grande échelle.
Option 1 — WACRM (basé WAHA)
WACRM exécute WAHA (l'API HTTP WhatsApp) au-dessus d'une session téléphonique. Vous scannez un QR code depuis un téléphone qui a le compte WhatsApp de votre église, et à partir de là GCM peut envoyer et recevoir sur ce compte via la plateforme WAHA.
Allez dans Settings → Channels → WhatsApp, choisissez WACRM (WAHA) comme fournisseur, et saisissez :
- API key — émise par WACRM (
https://wa.locatecrm.com). - API base — par défaut
https://wa.locatecrm.com/v1; ne changez que si votre revendeur l'héberge ailleurs. - Default session ID — la session WACRM qui possède le téléphone lié.
- Webhook secret — facultatif, signe les webhooks entrants vers GCM.
Lier votre téléphone
Dans Settings → WhatsApp devices, cliquez sur Link a device. WACRM affiche un QR code ; ouvrez WhatsApp sur le téléphone de l'église, allez dans Appareils liés → Lier un appareil, et scannez-le. Le statut passe à working en moins de dix secondes.
Une session liée reste active jusqu'à ce que vous vous déconnectiez depuis la liste des appareils liés du téléphone. Nous surveillons la santé de la session — si WACRM rapporte que la session est tombée, le canal WhatsApp se désactive automatiquement et nous envoyons un e-mail aux admins.
Envoi en masse
WACRM a son propre moteur de cadence qui répartit les envois en masse sur plusieurs heures pour éviter les heuristiques anti-spam de Meta. Vous pouvez envoyer à 5 000 membres en un clic ; WACRM les met en file automatiquement et nous affichons le statut queued dans les journaux de messages jusqu'à ce que chacun soit livré.
Option 2 — WhatsApp Official (Business API)
C'est l'API cloud officielle de Meta. La configuration est nettement plus impliquée — mais vous obtenez un débit plus élevé, des messages modèles et la légitimité d'un badge d'entreprise vérifiée.
Il vous faut :
- Un compte Meta Business Manager.
- Une entreprise vérifiée (passeport / documents d'entreprise).
- Un numéro de téléphone WhatsApp Business qui n'est pas enregistré sur un WhatsApp personnel.
- La Cloud API activée dans votre app Meta.
Puis dans GCM :
- Access token — token longue durée du Business System User de Meta.
- Phone number ID — l'ID numérique que Meta attribue à votre numéro d'entreprise.
- Business account ID — le WABA ID.
- App secret — utilisé pour vérifier les signatures des webhooks entrants.
- Default template name / language — utilisé lors de l'envoi en dehors de la fenêtre de service client de 24 heures.
La fenêtre de 24 heures
Meta n'autorise les messages au format libre que dans les 24 heures suivant le dernier message du destinataire. En dehors de cette fenêtre, vous ne pouvez envoyer que des messages modèles pré-approuvés.
GCM le détecte automatiquement : si un membre ne vous a pas envoyé de message dans les 24 heures, nous basculons sur le modèle que vous avez configuré dans default_template_name. Si aucun modèle n'est configuré, l'envoi est rejeté avec outside_24h_window. Vous le verrez dans le journal des messages — ce n'est pas un bug, c'est la règle de Meta.
Webhook entrant
Après avoir enregistré les identifiants, copiez l'URL du webhook que GCM vous montre (/channel-webhook?provider=whatsapp_official) et collez-la dans la configuration des Webhooks de votre app Meta. Utilisez le token de vérification que GCM affiche. Une fois que Meta confirme, les messages entrants, les mises à jour de statut et les accusés de réception affluent tous dans GCM.
Option 3 — smsmobileapi WhatsApp
Un service relais qui utilise le WhatsApp de votre propre téléphone. Même configuration que leur service SMS : une seule clé API alimente à la fois les envois SMS et WhatsApp, facturés ensemble.
- API key — depuis votre tableau de bord smsmobileapi.
Compromis : c'est limité par le débit du téléphone sur lequel vous avez installé leur app. Correct pour des envois de moins de 1 000 messages, pénible aux gros volumes.
Fonctionnalités par canal
Une fois un fournisseur configuré, Settings → Channels → WhatsApp vous permet de régler :
- Media support — désactivez si votre fournisseur ne prend pas en charge les images / PDF sortants.
- Max recipients per bulk — par défaut 500, peut être abaissé si vous voulez un découpage forcé.
- Merge tokens — activer la personnalisation du style
{{first_name}}dans les modèles. - Two-way conversation routing — les messages entrants créent des conversations auxquelles le personnel peut répondre.
Tester la connexion
Dans Settings → Channels → WhatsApp, cliquez sur Send test message. Nous envoyons un message « Hello from GCM » au téléphone principal de l'admin de l'organisation. S'il arrive en moins de 30 secondes, c'est bon. Sinon, vérifiez :
- Le journal d'activité du fournisseur (tableau de bord WACRM, outil de test de l'API de Meta, historique smsmobileapi).
- Le téléphone est toujours allumé, en ligne, et la session est
working. - Le destinataire n'a pas bloqué le numéro d'expéditeur.
Quand les identifiants cassent
Le mode de défaillance le plus courant : quelqu'un redémarre le téléphone de l'église et oublie de le reconnecter. La session WAHA tombe, les envois commencent à échouer. Nous enverrons un e-mail aux admins après 5 échecs consécutifs — relinkez le téléphone dans Settings → WhatsApp devices pour récupérer.
Références croisées
- Messagerie WhatsApp — comment envoyer réellement une fois configuré.
- Conversations — gérer les réponses entrantes.
- Configuration SMS — le secours texte à moindre coût.