Documentation
Espace: platform
Documentation
platform
Documentation Risala
Guide complet d'installation, exploitation et diagnostic.
1) Prérequis Meta
- Créer une app Meta et activer WhatsApp Business Platform.
- Récupérer: Phone Number ID, WhatsApp Business Account ID.
- Générer un token permanent (System User) avec permissions WhatsApp.
2) Configuration Risala
- Ouvrir WhatsApp > renseigner les IDs + token + verify token.
- Configurer le webhook avec l'URL de callback Risala et le verify token.
- Lancer un test template ou texte depuis la modale de test.
3) Inbox & conformité
- En dehors de la fenêtre 24h: envoi libre bloqué, template obligatoire.
- Statuts de livraison: envoyé, délivré, lu, échec.
- Inbox hybride IA/agent avec reprise manuelle possible.
4) Coexistence
- Mode manuel toujours disponible.
- Mode embedded activable si votre compte Meta est éligible.
- Diagnostiquez l'état via la section WhatsApp Coexistence.
Guide WhatsApp complet
Configuration
- 1. Renseigner `Phone Number ID`, `WABA ID`, `Token permanent`, `Verify token`.
- 2. Vérifier le webhook Meta avec l'URL générée par Risala.
- 3. Tester l'envoi depuis "Tester la connexion".
Inbox & conformité
- 1. Messages libres autorisés uniquement dans la fenêtre 24h.
- 2. Hors 24h: utiliser un template approuvé Meta.
- 3. États message: envoyé, délivré, lu, échec.
Checklist mise en production
- Vérifier les volumes persistants (`postgres`, `redis`, `media`) avant chaque rebuild.
- Lancer le preflight Unraid (backup DB + test écriture Redis).
- Déployer puis exécuter un envoi test (template + message libre dans fenêtre 24h).
- Vérifier réception webhook (messages entrants + statuts envoyés/délivrés/lus).
- Valider import contacts (petit CSV puis import massif via job).
Troubleshooting rapide
Erreur "jeton invalide"
Contrôler le token permanent Meta, les permissions System User et la validité du Phone Number ID/WABA ID.
Import CSV en échec
Vérifier Redis (pas de `MISCONF`) et utiliser le mode import fichier pour les gros volumes.
Message bloqué hors 24h
Envoyer un template approuvé Meta depuis la conversation.
Coexistence embedded indisponible
Activer le feature flag serveur et vérifier l'éligibilité du compte Meta.
En cas d'erreur, vérifiez d'abord: token Meta, webhook vérifié, fenêtre 24h, permissions du rôle utilisateur.