Gestion des soldes, Sender IDs et numéros WhatsApp par espace

L'architecture multi-tenant d'EnvoiSMS.ma garantit que les ressources sensibles (expéditeurs, numéros WhatsApp Business et crédits d'envoi) sont strictement cloisonnées et protégées contre tout usage non autorisé.

1. Gestion des soldes et modes de facturation

Chaque espace de travail peut fonctionner selon deux modes budgétaires :

Mode Solde Partagé (Shared Balance)

• Principe : L'espace puise dans le solde prépayé du compte parent sans plafond strict.
• Avantage : Zéro friction opérationnelle. Si votre compte principal dispose de 5 000 MAD, tous vos espaces en mode partagé peuvent envoyer des messages sans nécessiter d'allocations manuelles répétées.
• Suivi précis : Le tableau de bord comptabilise la dépense cumulée (balance_spent) par espace, vous permettant de refacturer vos clients avec exactitude à la fin du mois.

Mode Budget Alloué (Allocated Budget Cap)

• Principe : Le propriétaire alloue un plafond budgétaire fixe (ex. 1 000 MAD) à un espace.
• Sécurité anti-dépassement : Une vérification atomique en base de données empêche tout dépassement. Lorsque (balance_allocated - balance_spent) atteint 0, les envois s'interrompent avec le code 402 WORKSPACE_BALANCE_EXHAUSTED, sans impacter les autres espaces ni le compte principal.
• Récupération du budget (Reclaim) : Le propriétaire peut réajuster le budget alloué à la baisse jusqu'au montant consommé ou repasser en mode partagé pour libérer les fonds non utilisés.

2. Exclusivité et assignation des Sender IDs

Au Maroc, les Sender IDs alphanumériques (jusqu'à 11 caractères) sont approuvés au niveau de l'organisation par l'ANRT et les opérateurs locaux (Maroc Telecom, Inwi, Orange).

• Sender ID par défaut : Chaque espace créé dispose automatiquement de l'expéditeur de confiance EnvoiSMS (routage local opérateur DH Trust) pour permettre des tests et des envois immédiats.
• Assignation exclusive : Lorsqu'un Sender ID personnalisé (ex. MONENTREPRISE) est assigné à un espace, il devient immédiatement indisponible pour les autres espaces du même compte. Cette règle évite qu'un collaborateur n'envoie par erreur des messages au nom d'une autre marque.
• Libération dans le pool : Si un projet se termine, le propriétaire peut libérer le Sender ID en un clic dans Paramètres › Espaces de travail pour le réassigner à un autre espace.

3. Clés API et intégrations par espace de travail

Pour intégrer un site e-commerce (WooCommerce, Shopify, Prestashop) ou un CRM externe :

• Chaque clé API (sk_live_...) générée dans un espace est nativement liée à cet espace de travail.
• Zéro configuration d'en-tête : Vos serveurs et plugins appellent simplement https://api.envoisms.ma/v1/messages avec leur clé API en Bearer token. La plateforme résout automatiquement l'espace de travail correspondant, utilise ses expéditeurs approuvés et déduit le solde approprié sans nécessiter d'en-tête HTTP supplémentaire.
• Protection contre les incohérences : Si un appel externe tente de spécifier un en-tête X-Workspace-Id ne correspondant pas à la clé API, la passerelle refuse la requête avec l'erreur 403 API_KEY_WORKSPACE_MISMATCH.