Canaux

Un canal est le pont entre GCM et un fournisseur de messagerie — WAHA pour WhatsApp, Twilio pour SMS, Resend pour l'e-mail, Web Push pour les navigateurs, in-app pour la cloche de notification. La page Canaux (barre latérale → Canaux, également accessible depuis Paramètres) liste chaque catégorie de canal, vous permet de choisir un fournisseur par catégorie et stocke les identifiants nécessaires à l'envoi.

C'est du territoire administrateur — la configuration des canaux affecte la boîte de réception de chaque membre, donc la page est protégée par isAdmin.

Ouvrir la page Canaux

Cliquez sur Canaux dans la barre latérale. Vous verrez une carte par catégorie de canal — WhatsApp, SMS, E-mail, Push, In-app. Chaque carte affiche :

• Le nom du canal et une icône.
• Un badge Configuré / Non configuré.
• Un interrupteur Activé — basculez-le une fois que vous avez sauvegardé les identifiants.
• Un bouton Configurer qui déploie le formulaire d'identifiants en ligne.

Configurer un canal

Cliquez sur Configurer sur le canal que vous voulez connecter. La carte se déploie pour afficher un sélecteur de fournisseur (s'il y a plus d'un fournisseur pour cette catégorie) et un formulaire d'identifiants.

Sélecteur de fournisseur

Chaque catégorie de canal prend en charge un ou plusieurs fournisseurs :

Canal	Options de fournisseur
WhatsApp	WAHA (recommandé) · WhatsApp Cloud API (Meta)
SMS	Twilio · smsmobileapi
E-mail	Resend · SMTP · Plateforme par défaut
Push	Web Push (natif au navigateur, pas de tiers)
In-app	Intégré (pas de tiers)

Le fournisseur par défaut est marqué « (par défaut) » dans la liste déroulante. Vous pouvez changer de fournisseur plus tard en rouvrant le formulaire de configuration et en en choisissant un autre — les identifiants sont stockés par fournisseur, donc revenir en arrière ne perd pas votre config.

Formulaire d'identifiants

Le formulaire est construit dynamiquement à partir du config_schema du fournisseur. Chaque fournisseur déclare les champs dont il a besoin (clé d'API, point de terminaison, identifiant d'expéditeur, etc.) et le formulaire affiche les entrées correspondantes. Les champs requis sont marqués d'un astérisque rouge.

Quelques motifs courants :

WhatsApp via WAHA :

• URL de session — https://your-waha.example.com
• Jeton d'API
• Une étape de scan QR à la première sauvegarde pour apparier le compte WhatsApp

WhatsApp Cloud API :

• ID du numéro de téléphone (depuis Meta)
• Jeton d'accès permanent
• ID du compte business
• Jeton de vérification webhook

Twilio SMS :

• Account SID
• Auth token
• Expéditeur — soit un numéro de téléphone Twilio, soit un ID d'expéditeur alphanumérique où c'est pris en charge

smsmobileapi :

• Clé d'API
• Libellé d'expéditeur

Resend (pour l'e-mail) :

• Clé d'API
• Surcharge optionnelle du domaine d'origine

SMTP (pour l'e-mail) :

• Hôte, port, nom d'utilisateur, mot de passe
• Bascule TLS/SSL

Les champs de mot de passe et de jeton sont masqués par défaut. Cliquez sur l'icône d'œil pour révéler pendant que vous collez, puis refermez avant de sauvegarder.

Sauvegarder la configuration

Cliquez sur Sauvegarder la configuration. Les identifiants sont écrits dans org_channel_config (une ligne par organisation, par canal, indexée par (organization_id, channel_id)) et le toast confirme. La colonne d'identifiants est jsonb ; les valeurs sont stockées chiffrées au repos dans Supabase. Elles n'apparaissent jamais dans le navigateur après la sauvegarde — la prochaine fois que vous ouvrez le formulaire, les champs sensibles s'affichent comme •••• jusqu'à ce que vous cliquiez pour révéler.

Activer le canal

Sauvegarder les identifiants n'active pas automatiquement le canal. Basculez l'interrupteur Activé dans l'en-tête de la carte pour rendre le canal sélectionnable dans le compositeur de messages, les nœuds de flux de travail et la configuration des rappels.

TIP

Vous pouvez configurer un canal sans l'activer — utile pour préparer une configuration de staging que vous activerez plus tard. Les canaux désactivés n'apparaissent nulle part ailleurs dans l'application.

Comment les canaux sont utilisés en aval

Une fois qu'un canal est configuré et activé, il apparaît dans :

• Envoyer un message — le sélecteur de canal dans le compositeur.
• Flux de travail — le nœud d'action « Envoyer une notification ».
• Rappels — la liste de cases à cocher de canal pour les rappels d'événements.
• E-mails système — réinitialisations de mot de passe, liens magiques, e-mails de bienvenue (canaux e-mail uniquement).

Si un canal est désactivé, le compositeur le masque ; les nœuds de flux de travail qui le référencent se mettent en pause avec une erreur « canal non disponible » plutôt que d'échouer silencieusement.

Plusieurs fournisseurs par catégorie

Vous pouvez avoir plus d'un fournisseur configuré par catégorie — par exemple, deux fournisseurs SMS (national via Twilio, international via smsmobileapi). L'edge function send-message choisit le premier fournisseur qui prend en charge le pays du destinataire ; vous pouvez aussi surcharger par envoi en choisissant le fournisseur manuellement dans le compositeur.

Limites de plan

Les paliers de plan plafonnent le nombre de destinataires auxquels vous pouvez envoyer dans un envoi en masse :

Plan	Destinataires max par envoi en masse
Starter	100
Growth	1 000
Network	10 000
Unlimited	aucun plafond

Les limites de débit par seconde sont appliquées au niveau du fournisseur — voir l'aperçu des canaux de messagerie pour les détails sur la façon dont WACRM répartit automatiquement les envois en masse sur plusieurs jours quand vous dépassez les quotas quotidiens du fournisseur.

Ce qui est sauvegardé où

• channels — catalogue au niveau plateforme des catégories de canaux (en lecture seule pour les organisations).
• channel_providers — catalogue au niveau plateforme des fournisseurs par canal, avec config_schema.
• org_channel_config — lignes par organisation : (organization_id, channel_id, provider_id, credentials, is_enabled). La RLS est scopée par current_org_id().

Tester un canal

Le formulaire de configuration n'inclut pas (encore) d'envoyeur de test intégré. Pour vérifier, envoyez un message de test depuis la page Envoyer un message — choisissez le canal, adressez-le à votre propre téléphone ou e-mail et vérifiez la livraison. Si quelque chose échoue, les journaux de messagerie (Paramètres → Journaux de données → Messagerie) affichent la réponse exacte du fournisseur.

Pièges courants

« WhatsApp dit Configuré mais les messages n'arrivent jamais. » Votre session WAHA a probablement expiré. Re-scannez le QR depuis le tableau de bord WAHA. Les sessions meurent quand WhatsApp Web fait tourner l'authentification, ce qui peut arriver toutes les quelques semaines.

« Twilio rejette tous mes envois. » Twilio exige soit un numéro d'expéditeur vérifié, soit un ID alphanumérique enregistré pour le pays de destination. Consultez la console Twilio pour les erreurs d'expéditeur non enregistré — celles-ci n'apparaissent pas aussi clairement dans les journaux de GCM.

« J'ai configuré Resend mais les e-mails passent toujours par Plateforme par défaut. » Le sélecteur de fournisseur dans Paramètres → E-mail est séparé de la page Canaux pour l'e-mail. L'e-mail a une configuration dédiée parce que certaines organisations font passer l'e-mail par leur propre SMTP tandis que les autres canaux restent par défaut. Définissez le fournisseur d'e-mail dans Paramètres → E-mail.

Étapes suivantes

• E-mail + notifications — le fournisseur d'e-mail vit sur son propre onglet.
• Rappels — choisissez quels canaux envoient les rappels d'événements.
• Aperçu de la messagerie — envoyez réellement des messages une fois les canaux connectés.