# Comptes d'agence ## Que sont les comptes d'agence ? Les comptes d'agence vous permettent de gérer plusieurs comptes clients depuis un tableau de bord unique. Au lieu de vous connecter à des comptes séparés pour chaque client, vous bénéficiez d'une vue centralisée où vous pouvez créer des sous-comptes, surveiller des campagnes, allouer des crédits et basculer instantanément entre vos clients. Cette fonctionnalité est conçue pour les agences marketing, les consultants et les revendeurs qui gèrent l'application pour le compte de plusieurs entreprises. ::: walkthrough agency-accounts ::: Les deux pages qui permettent cela — **Comptes secondaires** et **Mode SaaS** — ont chacune leur propre place dans la barre latérale plutôt que d'être dissimulées dans les Paramètres. Cette page est une vue d'ensemble ; les mécanismes quotidiens se trouvent dans la [Gestion des comptes secondaires](sub-accounts.md). --- ## Système de crédits partagés L'une des différences majeures entre les comptes d'agence et les comptes classiques réside dans le fonctionnement des crédits : - **Les crédits sont partagés** entre votre compte d'agence et tous les sous-comptes. - Lorsqu'un sous-compte utilise des crédits (pour des réponses IA, des campagnes, etc.), les crédits sont déduits du solde de votre agence. - Les sous-comptes ne voient pas le solde de crédits — ils ne voient que leur propre utilisation. En tant qu'agence, vous gérez le pool de crédits global. **Exemple :** Vous disposez de 1 000 crédits sur votre compte d'agence. Le client A envoie une campagne à 50 contacts (50 crédits). Le robot IA du client B répond à 30 conversations (30 crédits). Votre solde restant est de 920 crédits. --- ## Création de sous-comptes ::: master-only
La page Sous-comptes dans la v2, montrant les six tuiles de statistiques (Sous-comptes, Avec problèmes, Campagnes actives, Campagnes en pause, Alloué aux clients, Non alloué), la barre de recherche et une ligne de client dans le tableau

La page Sous-comptes : les tuiles de statistiques en haut (les deux de droite divisent votre réserve de crédits entre ce qui est déjà utilisé par les limites des clients et ce qui reste disponible), un bouton Ajouter un compte et un raccourci vers le Mode SaaS.

::: 1. Cliquez sur **Sous-comptes** dans la barre latérale principale — il s'agit d'une page dédiée, située juste au-dessus de **Paramètres**. 2. Cliquez sur le bouton vert **Ajouter un compte** (en haut à droite). 3. Remplissez les informations de votre client dans la fenêtre modale en 3 étapes : compte (nom, e-mail), entreprise (nom de l'entreprise, adresse, description) et fonctionnalités. ::: master-only
La fenêtre modale Ajouter un sous-compte à l'étape Compte, montrant la progression en 3 étapes (Compte, Entreprise, Fonctionnalités) avec les champs prénom, nom et e-mail

La fenêtre modale Ajouter un sous-compte. Trois étapes : Compte → Entreprise → Fonctionnalités. L'e-mail que vous saisissez devient l'adresse de connexion du client.

::: 4. Cliquez sur **Créer un compte**. Un écran de confirmation affiche le mot de passe de connexion généré — copiez-le avant de fermer. Le client le reçoit également par e-mail. Procédure complète : [Gestion des sous-comptes — Créer un sous-compte](sub-accounts.md#creating-a-sub-account). --- ## Présenter une démonstration en direct à un client potentiel Avant qu'un client ne s'inscrive, vous pouvez lui offrir un aperçu en direct de l'assistant de chat fonctionnant sur son propre site web, sans aucune installation requise de sa part. Utilisez le **Lien de démonstration client**. > **Actuellement indisponible.** La section **Lien de démonstration client** de la version précédente de l'application ne fait pas partie de l'écran Gérer du widget de chat aujourd'hui, les étapes ci-dessous ne peuvent donc pas encore être effectuées. Elles sont conservées ici pour décrire le fonctionnement du lien de démonstration. **Comment ça marche :** vous collez l'adresse du site web du client, et la plateforme génère un lien partageable. Lorsque le client ouvre ce lien, il voit son propre site web avec votre widget de chat flottant par-dessus — entièrement fonctionnel et prêt à discuter. Rien ne change sur son site web réel, et il n'a pas besoin de toucher au code. L'aperçu réside entièrement sur votre lien. **Comment y accéder :** ouvrez **Paramètres → Canaux → Canaux**, cliquez sur la carte **Widget de chat**, trouvez la section **Lien de démonstration client**, tapez ou collez l'adresse du site web du client (par exemple `theirbusiness.com`), et cliquez sur **Copier le lien de démonstration**. Envoyez ensuite ce lien au client par le moyen de votre choix — e-mail, WhatsApp, message, n'importe où. ::: master-only
Paramètres → Canaux → Page Canaux montrant la carte du widget de chat du site Web avec un bouton Gérer

Paramètres → Canaux → Canaux : la carte Widget de chat du site Web est le point d'entrée pour la configuration du widget.

::: ::: master-only
La fenêtre modale Gérer le widget de chat, montrant les paramètres d'apparence et un panneau de prévisualisation en direct — elle ne contient pas de section Lien de démonstration client

La fenêtre modale Gérer aujourd'hui : sections Apparence, Comportement, Capture de prospects, et Canaux et intégrations, mais pas de lien de démonstration client.

::: Quelques points à noter : - Certains sites web ne permettent pas d'être affichés à l'intérieur d'une autre page (un paramètre de sécurité de leur côté). Lorsque cela se produit, le lien de démonstration fonctionne toujours : il affiche un cadre d'aperçu propre avec l'adresse du site web, et l'assistant de chat est toujours entièrement fonctionnel pour être testé. L'expérience de conversation est identique ; seul l'arrière-plan du site web diffère. - La démonstration utilise votre configuration de widget réelle, donc tous les messages que le client envoie pendant le test vous parviennent comme n'importe quelle autre conversation via le widget de chat. --- ## Identifiants de connexion client Lorsque vous créez un sous-compte : - Le client reçoit un e-mail et un mot de passe qu'il peut utiliser pour se connecter à son propre compte, sur votre page de connexion en marque blanche. - Donner aux clients un accès de connexion est **optionnel** — vous pouvez tout gérer en leur nom si vous préférez. - Si le client se connecte, il voit son propre tableau de bord avec ses campagnes, ses contacts et ses discussions. Il ne voit pas votre tableau de bord d'agence ni les autres sous-comptes. - Le solde de crédits est masqué pour les sous-comptes puisque vous gérez le pool de crédits partagé. --- ## Basculer entre les sous-comptes Il existe deux façons de basculer vers le compte d'un client : **Le sélecteur de compte, depuis n'importe où :** 1. En haut de la barre latérale, cliquez sur **Changer de compte**. ::: master-only
Le menu déroulant Changer de compte ouvert dans la barre latérale, montrant un champ de recherche pour les comptes secondaires

Le menu déroulant Changer de compte, ouvert depuis n'importe où dans la barre latérale. Cette agence n'a pas encore de comptes secondaires, la liste est donc vide — une fois que vous en aurez créé un, il apparaîtra ici, consultable par nom ou par e-mail.

::: 2. Recherchez le sous-compte par nom ou par e-mail, ou faites défiler la liste. 3. Cliquez dessus. Le tableau de bord se recharge sous l'identité de ce sous-compte. **Depuis la page Sous-comptes :** 1. Dans la barre latérale, cliquez sur **Sous-comptes**. 2. Trouvez le sous-compte dans la liste. Sur cette ligne, cliquez sur le menu **Plus** (icône à trois points tout à droite). 3. Cliquez sur **Se connecter en tant qu'utilisateur**. Quoi qu'il en soit, lorsque vous êtes dans un sous-compte, le sélecteur dans la barre latérale devient orange et affiche **Assistance : **. Cliquez dessus et choisissez **Retour à mon agence** pour revenir à votre propre tableau de bord. La barre orange **Assistance** en haut de la page propose la même option de sortie ; cliquez sur son **×** pour masquer la barre pour le reste de votre visite si vous avez besoin d'espace. Si le client a activé l'authentification à deux facteurs, son code ne vous sera pas demandé : vous vous êtes déjà connecté en tant que vous-même, et le code serait envoyé au client, pas à vous. --- ## Suivi de la consommation de crédits En tant qu'agence, vous pouvez suivre la consommation de crédits sur l'ensemble des sous-comptes : - **Tuiles de statistiques sur la page Sous-comptes** — agrègent le nombre de campagnes actives/en pause et le nombre de sous-comptes rencontrant des problèmes. - **Suivi par sous-compte** — combien de crédits chaque sous-compte utilise, accessible depuis le menu **Plus** de cette ligne. - **Détails de l'utilisation des crédits** — une vue dédiée par sous-compte montrant les crédits achetés, les crédits consommés, le solde restant, l'utilisation par motif, les meilleures campagnes par dépense, et un tableau de transactions filtrable. ::: master-only
La page Sous-comptes dans la v2, montrant les six tuiles de statistiques : Sous-comptes, Avec problèmes, Campagnes actives, Campagnes en pause, Alloué aux clients, Non alloué

Les tuiles de statistiques en haut de la page Sous-comptes — une vue d'ensemble de la santé des campagnes pour tous les clients, ainsi que la part de votre réserve de crédits déjà utilisée par les limites de dépenses des clients (Alloué aux clients / Non alloué). Le menu Plus sur chaque ligne (non illustré — nécessite au moins un sous-compte) est l'endroit où se trouvent le suivi des crédits par compte et les détails de l'utilisation des crédits.

::: Cette visibilité vous aide à comprendre vos coûts, à identifier les clients à forte consommation et à définir une tarification appropriée pour vos services. --- ## Revente de crédits (alias Mode SaaS) La revente de crédits vous permet de vendre des crédits à vos sous-comptes selon votre propre tarification, créant ainsi une source de revenus pour votre agence. Toute cette section se trouve dans une page dédiée de la barre latérale appelée **Mode SaaS** — la même fonctionnalité que vous connaissez peut-être sous le nom de « Revente de crédits », son appellation standard dans l'industrie. Elle est disponible sur le forfait **Agence** et est protégée par le drapeau de fonctionnalité **marque blanche**. Si votre forfait inclut la marque blanche — ce qui est le cas pour tous les niveaux d'offres à vie qui le mentionnent — la revente est déjà à vous : vous n'êtes pas limité à la gestion de l'application pour vos clients, vous pouvez vendre des forfaits sous votre propre marque, à vos propres prix, via votre propre compte Stripe ou PayPal. Rien de plus à acheter. ### Comment ça fonctionne 1. **Ouvrez le Mode SaaS** — cliquez sur son entrée dans la barre latérale principale (elle se situe à côté des Sous-comptes, près du bas du menu), ou cliquez sur le bouton **Mode SaaS** en haut de la page des Sous-comptes. 2. **Activez la revente de crédits pour un sous-compte** dans sa fenêtre modale **Modifier** (page Sous-comptes → menu **Plus** de la ligne → **Modifier** → **Gestion des crédits**) en faisant passer le mode de Manuel à Revente. La revente n'est proposée qu'une fois que votre agence dispose de la marque blanche sur son forfait. 3. **Définissez votre tarification** — définissez des forfaits de crédits et un prix par crédit que vos sous-comptes verront lorsqu'ils achèteront des crédits. 4. **Application d'un prix minimum** — la plateforme impose un prix minimum par crédit pour garantir une tarification durable sur l'ensemble de la plateforme. 5. **Les sous-comptes achètent des crédits** via votre propre page de paiement, propulsée par le fournisseur de paiement que vous connectez — Stripe, PayPal, ou les deux. Les paiements vont directement sur votre propre compte auprès de ce fournisseur. 6. **Les crédits sont livrés automatiquement** au sous-compte après l'achat. Les crédits arrivent dans le solde acheté du client, et le même nombre de crédits est déduit de votre réserve d'agence — cette déduction représente votre coût de vente, tandis que le paiement du client va sur votre propre compte de paiement. ### Économie des crédits Lorsqu'un client achète des crédits, ces crédits sont ajoutés au solde propre du client, et le même nombre de crédits est **déduit de votre réserve d'agence**. L'argent du client est versé sur votre compte Stripe ; la déduction de la réserve est votre coût de plateforme pour la vente. Votre profit est la différence entre le prix que vous avez fixé et le coût de ces crédits pour vous — c'est aussi la raison pour laquelle le prix minimum par crédit existe (vous ne pouvez pas fixer un prix inférieur au coût de crédit de la plateforme). Assurez-vous que votre réserve est suffisante : le paiement nécessite que votre réserve d'agence contienne au moins autant de crédits que le pack acheté. Si, au moment du paiement, votre réserve ne peut toujours pas couvrir l'achat, la plateforme débite automatiquement la carte de votre agence enregistrée pour la recharger — et si ce débit automatique échoue, le paiement du client est remboursé et aucun crédit n'est livré. **Exemple :** Vous vendez 150 crédits pour 25 $. Les 150 crédits sont ajoutés au solde du client, les 25 $ sont versés sur votre compte Stripe, et 150 crédits sont déduits de votre réserve d'agence. Si ces crédits de réserve vous ont coûté 15 $, votre marge sur la vente est de 10 $. Les crédits achetés couvrent **tout ce que le client dépense** : les réponses de l'IA, les outils, les suivis, ainsi que les coûts WhatsApp hors IA (location de numéro et, à partir du 1er octobre 2026, les frais de messagerie de l'opérateur). Tout est prélevé en priorité sur le solde acheté par le client ; votre réserve d'agence ne couvre que ce que ce solde ne peut pas couvrir. Il n'y a pas de majoration distincte par client sur les coûts WhatsApp (le champ **Tarif client** ne modifie que le prix des actions de l'IA Max et Mini), donc si vous revendez via WhatsApp, intégrez ces coûts dans vos forfaits. Le SMS ne fait pas partie de ces coûts : le SMS fonctionne toujours via un compte Twilio que vous connectez vous-même, Twilio vous facture donc directement et aucun crédit n'est impliqué. ### Que se passe-t-il lorsque le solde d'un client atteint zéro Les dépenses d'un client revendeur restent isolées des crédits qu'il a achetés **tant que son allocation mensuelle est de zéro**. Sans allocation, dès que son solde acheté atteint zéro, **le bot IA cesse de répondre pour ce sous-compte** — il ne bascule pas sur votre réserve d'agence — et le client doit acheter un autre forfait ou pack de crédits via votre page de paiement pour reprendre. C'est la coupure stricte qui empêche l'utilisation d'un client d'épuiser le solde de votre agence. Si le sous-compte a toujours une **Allocation mensuelle** définie (voir [Modes de gestion des crédits](sub-accounts.md#credit-management-modes)), cette allocation continue d'être créditée chaque mois et est prélevée sur votre réserve exactement comme en mode manuel, de sorte que le client continue d'utiliser le service après l'épuisement de ses crédits achetés. Réglez l'allocation à zéro dans la fenêtre modale **Modifier** du sous-compte si vous souhaitez un comportement de type « paiement à l'usage » pur. (Le SMS vous est facturé directement par Twilio dans tous les cas, il n'y a donc aucun frais de crédit impliqué.) ### Le flux d'inscription en libre-service L'objectif de la revente de crédits est que vous n'ayez **pas** à gérer les inscriptions manuellement. Le flux se présente comme suit : 1. Vous publiez un lien de paiement (dans un e-mail, sur votre site web, dans une publicité). 2. Un nouveau client clique dessus, paie, et un sous-compte est créé automatiquement. (Si le forfait inclut un essai gratuit, il commence sans rien payer — le prélèvement s'effectue automatiquement à la fin de l'essai.) 3. Le client reçoit un e-mail de connexion avec un mot de passe temporaire. 4. Il se connecte, suit le processus d'intégration et prend le relais. Vous n'intervenez que s'il a besoin d'aide — les recharges de facturation, les tentatives de paiement, etc., fonctionnent toutes en pilote automatique. Il existe trois façons de configurer cela : **Stripe** (recommandé, entièrement intégré), **PayPal** (également entièrement intégré, et la réponse habituelle lorsque Stripe n'est pas disponible là où vous vous trouvez), ou un **Fournisseur de paiement personnalisé** (tout autre système que vous utilisez déjà — nécessite un peu de travail d'intégration). --- ### Configuration de la revente de crédits ::: master-only
Assistant de configuration du Mode SaaS, étape 1 sur 5 : Créer un compte Stripe, avec les boutons Ouvrir Stripe et J'ai un compte et une alternative de fournisseur de paiement personnalisé

L'assistant de configuration du Mode SaaS (étape 1 sur 5). Stripe est le chemin standard ; la case en bas propose la voie du fournisseur de paiement personnalisé si Stripe n'est pas disponible dans votre pays.

::: 1. Cliquez sur **Mode SaaS** dans la barre latérale principale. 2. Si c'est votre première visite, vous arriverez dans l'assistant de configuration. Choisissez l'un des trois chemins : - **J'ai un compte / Connecter Stripe** — recommandé. Voir [Option 1 : Connecter Stripe](#option-1-connect-stripe) ci-dessous. - **Utiliser un fournisseur de paiement personnalisé à la place** — pour tout autre fournisseur de paiement que vous souhaitez gérer vous-même. Voir [Option 2 : Fournisseur de paiement personnalisé](#option-2-custom-payment-provider) ci-dessous. - **Connecter PayPal à la place** — intégré comme Stripe, avec l'argent arrivant sur votre compte PayPal Business. Voir [Option 3 : Connecter PayPal](#option-3-connect-paypal) ci-dessous. > Stripe est la voie de la moindre résistance. Si Stripe n'est pas disponible dans votre pays, ou si vos clients préfèrent simplement PayPal, connectez PayPal — il est tout aussi intégré et ne nécessite aucun travail d'intégration. Gardez la voie du fournisseur de paiement personnalisé pour un système de facturation que vous possédez déjà et que vous souhaitez conserver (Mollie, Paddle, GoCardless, votre propre backend, etc.). Vous pouvez connecter Stripe et PayPal en même temps. Vos clients obtiennent alors un bouton pour chacun et choisissent celui qu'ils préfèrent. --- ### Option 1 : Connecter Stripe C'est le chemin recommandé. La plateforme gère le paiement, la création de compte et la livraison des crédits pour vous — il vous suffit de donner les clés à Stripe. #### Étape 1 — Créer une clé API Stripe restreinte 1. Dans l'assistant du mode SaaS, vous serez invité à saisir votre **Stripe Secret Key**. 2. Ouvrez votre tableau de bord Stripe dans un nouvel onglet → **Developers** → **API keys** → **Create restricted key**. 3. Donnez un nom à la clé (par ex. *DM Champ Reselling*) et accordez les autorisations suivantes : - **Checkout Sessions** → Write - **Products** → Write - **Prices** → Write - **Subscriptions** → Write (étiquette l'abonnement de chaque client afin que les renouvellements — et les essais gratuits convertis en abonnements payants — créditent le bon compte, et permet à la plateforme de vérifier le niveau des abonnés actifs avant que vous ne le supprimiez) - **Customers** → Write, **Setup Intents** → Read et **Customer portal** → Write (utilisé lorsqu'un client enregistre une carte pour la recharge automatique ou gère son abonnement) - **Account** → Read - **Webhook Endpoints** → Write (permet à la plateforme de vérifier que votre webhook est enregistré avec les bons événements et de le corriger pour vous si ce n'est pas le cas — voir [Vérification de l'état du webhook](#webhook-health-check) ci-dessous) 4. Cliquez sur **Create key**, puis copiez la clé. > **Déjà connecté avec moins d'autorisations ?** Vous n'avez pas besoin d'une nouvelle clé. Dans Stripe, ouvrez **Developers → API keys**, cliquez sur votre clé restreinte existante, cochez les autorisations manquantes et enregistrez — la plateforme les prendra en compte lors de la prochaine requête. Le symptôme révélateur d'une clé à laquelle il manque **Subscriptions** est l'erreur *"Could not verify if this tier has active subscribers"* lorsque vous essayez de supprimer un niveau de tarification. 5. Collez-la dans l'assistant et cliquez sur **Save & Continue**. #### Étape 2 — Enregistrer le webhook Stripe 1. L'assistant vous montre une **URL de webhook**. Copiez-la. 2. Dans Stripe → **Développeurs** → **Webhooks** → **Ajouter un endpoint**. 3. Collez l'URL du webhook comme destination. 4. Pour les événements, sélectionnez **`checkout.session.completed`** (achats initiaux), **`invoice.paid`** (renouvellements, et le premier prélèvement après la fin d'un essai gratuit — sans cela, le renouvellement d'un client est facturé dans Stripe mais ses crédits ne sont pas rechargés), **`customer.subscription.updated`** (changements de plan effectués dans le portail client Stripe — sans cela, un client qui effectue une mise à niveau conserve son ancienne allocation jusqu'à ce que vous corrigiez manuellement) et **`customer.subscription.deleted`** (annulations — sans cela, un client qui annule dans Stripe continue d'apparaître comme abonné ici). 5. Stripe affiche un **secret de signature** pour le nouveau webhook. Copiez-le et collez-le dans l'assistant, puis cliquez sur **Enregistrer et continuer**. ##### Vérification de l'état du webhook Dès que vous enregistrez le secret de signature, et une fois par jour par la suite, la plateforme utilise votre clé Stripe pour vérifier que votre point de terminaison de webhook est activé et abonné aux quatre événements. Si des événements sont manquants et que votre clé dispose de l'autorisation **Webhook Endpoints → Write**, ils sont ajoutés automatiquement pour vous. Si la plateforme ne peut pas corriger le problème (aucun point de terminaison trouvé, point de terminaison désactivé, la clé ne dispose pas de l'autorisation, ou Stripe rejette la clé car elle a expiré ou a été révoquée), le tableau de bord du mode SaaS affiche un avertissement **"Webhook needs attention"** vous indiquant exactement quoi faire. Corrigez-le rapidement : tant que l'avertissement est affiché, les renouvellements de vos clients sont toujours facturés dans Stripe, mais leurs crédits ne sont pas rechargés. #### Étape 3 — Configurer les niveaux de tarification 1. Définissez les forfaits de crédits que vos clients peuvent acheter (jusqu'à 20 niveaux — par ex. *Starter — 1 000 crédits / 29 $* , *Pro — 5 000 crédits / 99 $*), et éventuellement les fonctionnalités que chaque niveau débloque. - **Besoin du même forfait sur deux rythmes de facturation — disons mensuel et annuel ?** Configurez-le une fois, puis cliquez sur l'icône **Dupliquer** (à côté de l'icône corbeille sur le niveau) au lieu de le reconstruire. La copie reprend tous les paramètres de l'original — crédits, prix, fonctionnalités, limites, essai — avec *(copie)* ajouté à son étiquette, et n'est pas encore publiée : changez sa **Facturation** pour Annuel, ajustez le prix et l'étiquette, puis enregistrez, et il obtient son propre produit et prix Stripe. La copie est toujours ajoutée à la **fin** de votre liste de Forfaits à dessein : vos liens de paiement et votre code d'intégration pointent vers les forfaits par leur position dans la liste (voir [Étape 4 — Partagez vos liens de paiement](#step-4--share-your-payment-links)), donc rien de ce que vous avez déjà mis sur votre site web ne bouge. 2. Choisissez comment le forfait est facturé avec le sélecteur **Facturation** : **Mensuel**, **Annuel** ou **Tous les N semaines**. Sur Mensuel, rien ne change — le prix que vous saisissez est facturé chaque mois. Sur **Annuel**, le prix que vous saisissez est le prix pour une **année entière**, tandis que le champ **Crédits par mois** signifie exactement cela — les crédits que le client obtient **par mois**. Donc *1 000 crédits / 290 $ / Annuel* signifie qu'un client vous paie 290 $ une fois par an et reçoit 1 000 crédits chaque mois. Leur allocation est accordée mois par mois — le premier mois lors de l'achat, puis automatiquement chaque mois après, avec le compteur qui se réinitialise à chaque renouvellement annuel — plutôt que douze mois de crédits déposés le premier jour. Cela compte pour votre réserve : une vente annuelle ne retire pas une année de crédits d'un coup. Si le client annule, les allocations mensuelles s'arrêtent. **Tous les N semaines** est pour tout autre rythme : choisissez-le et saisissez les **Semaines entre les paiements** (1 à 52) — *toutes les 4 semaines*, par exemple, ce qui fait 13 paiements par an au lieu de 12. Sur un forfait de type hebdomadaire, le prix et les crédits s'appliquent tous deux **par période de facturation** : un forfait *1 000 crédits / 29 $ / toutes les 4 semaines* facture 29 $ toutes les quatre semaines et accorde 1 000 crédits toutes les quatre semaines. Changer le rythme de facturation d'un forfait enregistré crée un nouveau prix dans votre Stripe, donc les abonnés existants restent sur ce pour quoi ils se sont inscrits. 3. Donnez au forfait un **essai gratuit** si vous le souhaitez. **Essai gratuit (jours)** prend n'importe quelle valeur de 1 à 90 — laissez à **0** pour aucun essai — et **Crédits d'essai** définit combien de crédits le client reçoit au départ (par défaut, il s'agit des crédits mensuels du forfait, et vous pouvez les réduire — jusqu'à un minimum de 1, car un compte d'essai sans aucun crédit ne pourrait pas terminer sa propre configuration). Avec un essai défini, un nouveau client n'est **pas facturé à l'inscription** : il reçoit les crédits d'essai le premier jour et peut utiliser le forfait immédiatement. Lorsque la période d'essai se termine, Stripe facture automatiquement le prix du forfait et le client passe à l'allocation mensuelle complète à partir de ce moment-là. Quelques points à garder à l'esprit : - **Les crédits d'essai proviennent de votre réserve d'agence**, exactement comme n'importe quels autres crédits de forfait. Un essai généreux sur un forfait que vous promouvez largement représente un coût réel, alors définissez le nombre délibérément plutôt que de le laisser à l'allocation mensuelle complète. - **Un essai est pour les nouvelles inscriptions.** Une inscription via votre lien de paiement ou votre paiement intégré obtient l'essai exactement tel qu'il est configuré sur le forfait. Un sous-compte qui existe déjà — créé par vous, précédemment abonné, ou ayant déjà bénéficié d'un essai — achetant depuis sa propre page de Facturation est facturé immédiatement, sans second essai. Un client qui annule pendant l'essai n'est jamais facturé et conserve les crédits d'essai restants. - **Carte ou pas de carte — c'est vous qui décidez.** Par défaut, l'essai demande toujours au client une carte à l'inscription, et Stripe la facture lorsque l'essai se termine. Désactivez **Exiger une carte pour démarrer l'essai** et le paiement saute complètement l'étape de la carte : le client commence juste avec un e-mail. S'il n'a pas ajouté de carte au moment où l'essai se termine, le forfait s'arrête simplement — son sous-compte est marqué comme annulé, aucun crédit supplémentaire n'est accordé, et il conserve ce qui reste des crédits d'essai. Un essai sans carte convertit moins automatiquement qu'un essai avec carte enregistrée, il est donc utile de rappeler au client d'ajouter sa carte avant la fin. - **Expiration stricte après l'essai — récupérez les crédits inutilisés.** À côté de l'interrupteur de carte se trouve **Expiration stricte après l'essai** : *lorsque l'essai se termine sans mise à niveau, les crédits d'essai inutilisés reviennent dans votre réserve et le compte du client est verrouillé jusqu'à ce qu'il s'abonne.* Laissez-le désactivé (par défaut) et rien ne change par rapport au paragraphe ci-dessus — le forfait est annulé, aucun crédit supplémentaire n'est accordé, et le client conserve les crédits d'essai restants, donc son IA continue de répondre jusqu'à épuisement. Activez-le et, au moment où un essai se termine sans mise à niveau, les crédits d'essai inutilisés retournent **dans votre réserve d'agence** et le compte du client est verrouillé : l'envoi et les réponses de l'IA s'arrêtent et il voit *« Votre essai gratuit est terminé. Contactez votre fournisseur pour continuer. »* Seul ce qu'il n'a pas dépensé revient — un essai qu'il a réellement utilisé vous coûte ce qu'il a utilisé. Le verrouillage se lève tout seul dès qu'il achète un forfait, et vous pouvez le lever ou le modifier vous-même depuis la fenêtre modale **Modifier** du sous-compte, en utilisant les mêmes [contrôles de blocage](sub-accounts.md#blocking-pausing-a-sub-account) que pour un client qui prend du retard sur ses paiements. (Un blocage que vous avez déjà placé manuellement n'est jamais touché par tout cela — votre raison pour le faire prévaut sur la nôtre.) L'expiration stricte fonctionne sur les essais avec carte requise et sans carte ; sur un essai sans carte, le paiement indique à l'acheteur dès le départ que son forfait **et** tous les crédits d'essai restants se terminent automatiquement après l'essai à moins qu'il n'ajoute un moyen de paiement. 4. Le groupe **Canaux** contient la **Limite de canaux** du forfait — un nombre, pas un interrupteur, fonctionnant exactement comme les sièges d'équipe et la limite d'Agents IA. Choisissez **Non défini** (par défaut — le forfait ne gère pas le nombre, donc ce que le compte possède déjà reste tel quel), **Illimité**, ou **Personnalisé** avec le nombre exact de canaux de messagerie que les clients sur ce forfait peuvent avoir connectés en même temps — y compris **0**, pour les forfaits où vous connectez et gérez les canaux vous-même. La limite est appliquée lorsqu'un client s'abonne et rafraîchie à chaque renouvellement, et une limite que vous avez définie manuellement sur un sous-compte spécifique (dans sa fenêtre modale Modifier) n'est jamais écrasée par un renouvellement. Elle contrôle *combien* de canaux, pas *lesquels* — c'est le groupe suivant. Le compte est par **connexion**, pas par type de canal : chaque numéro WhatsApp prend un emplacement à lui tout seul (WhatsApp Web et l'API Business de la même manière), tandis qu'Instagram et Messenger arrivent via la même connexion de page Meta et occupent ensemble un seul emplacement. Un client à sa limite voit un message clair lorsqu'il essaie de connecter un autre canal ; reconnecter un canal qu'il possède déjà n'est jamais bloqué. 5. À l'intérieur de la liste des fonctionnalités de chaque niveau, vous trouverez également un groupe **Types de canaux** listant les types de canaux qu'un client peut recevoir — Widget de chat, API WhatsApp Business, WhatsApp Web, Instagram, Facebook Messenger, Telegram, LINE, Viber, E-mail, SMS et iMessage. Les types de canaux sont activés par défaut à moins que vous n'en désactiviez certains, vous pouvez donc réserver des canaux spécifiques pour des niveaux supérieurs — disons, un forfait de démarrage uniquement widget et l'API WhatsApp Business à partir de votre niveau Pro. Les clients sur un niveau qui exclut un canal le voient verrouillé sur leur page Canaux avec une note pour mettre à niveau. 6. La liste des fonctionnalités contient également un groupe **Équipe**, afin que chaque forfait puisse définir sa propre allocation de sièges d'équipe. Un sélecteur, **Sièges d'équipe**, décide à la fois si les clients sur le forfait obtiennent des membres d'équipe et combien : choisissez **Non inclus** (par défaut — les clients sur ce forfait ne peuvent pas inviter de coéquipiers), l'un des préréglages (3 / 5 / 10 / Illimité), ou **Personnalisé** avec n'importe quel nombre exact — Starter avec 3 sièges, Professionnel avec 10, Entreprise illimité, ou ce qui correspond à votre tarification. L'allocation est appliquée automatiquement lorsqu'un client s'abonne et rafraîchie à chaque renouvellement, il n'y a donc rien à définir manuellement par client. Deux choses à savoir : **Non défini** signifie que les membres d'équipe sont inclus mais que le forfait ne gère pas le nombre — toute limite de sièges que le compte possède déjà est laissée telle quelle — et une limite de sièges que vous avez définie manuellement sur un sous-compte spécifique (dans sa fenêtre modale Modifier ou via l'API) n'est jamais écrasée par un renouvellement, donc les exceptions ponctuelles survivent aux cycles de facturation. Il y a aussi un groupe **Productivité** (Tâches, Résumés quotidiens, Bibliothèque multimédia IA) si vous souhaitez les réserver pour des forfaits supérieurs. 7. Le groupe **Contacts & Agents IA** contient la **Limite d'Agents IA** du forfait — un nombre, pas un interrupteur, fonctionnant exactement comme les sièges d'équipe. Choisissez **Non défini** (par défaut — le forfait ne gère pas le nombre, donc ce que le compte possède déjà reste tel quel), **Illimité**, ou **Personnalisé** avec le nombre exact d'agents IA que les clients sur ce forfait peuvent avoir — y compris **0**, pour les forfaits où vous construisez et gérez les agents vous-même et où les clients ne devraient pas créer les leurs. La limite est appliquée lorsqu'un client s'abonne et rafraîchie à chaque renouvellement, et une limite que vous avez définie manuellement sur un sous-compte spécifique (dans sa fenêtre modale Modifier) n'est jamais écrasée par un renouvellement. Un client à sa limite voit un message clair lorsqu'il essaie de créer ou de dupliquer un agent ; copier un agent dans un sous-compte depuis votre côté agence n'est jamais bloqué par cela. 8. Le groupe **Crédits inutilisés** décide de ce qui arrive aux crédits restants d'un client lorsque le forfait se renouvelle. **Garder au maximum** est le nombre de mois d'allocation qu'un client sur ce forfait peut reporter : à chaque renouvellement, son solde inutilisé est réduit à au plus ce nombre de fois l'allocation mensuelle, puis les nouveaux crédits s'ajoutent par-dessus — `1` en garde l'équivalent d'un mois, `0.5` la moitié d'un mois, `0` ne reporte rien. **Expirer les crédits inutilisés après** est un nombre de jours : les crédits qui sont restés inutilisés aussi longtemps sont supprimés lors du premier renouvellement après avoir atteint cet âge, et comme la dépense est toujours déduite des crédits les plus anciens en premier, un client qui utilise son allocation chaque mois n'en perd jamais. Laissez les deux vides — le défaut, et ce que chaque forfait que vous vendez déjà conserve — et rien n'est plafonné ou expiré. Il vaut la peine de les définir sur un forfait bon marché ou à prix d'essai, où un client qui utilise à peine le produit accumule un solde dont votre réserve est responsable. Une valeur définie sur un sous-compte spécifique l'emporte sur celle du forfait, vous pouvez donc toujours faire une exception pour un seul client. Voir [Plafonner ce qui est reporté](sub-accounts.md#capping-what-rolls-over). 9. Définissez le **prix par crédit** — c'est ce que les clients paient pour les recharges ponctuelles. 10. Cliquez sur **Enregistrer & Continuer**. > **Les contacts sont une fonctionnalité oui/non, pas un nombre.** Le même groupe **Contacts et agents IA** contient **Contacts illimités** en tant qu'élément simple activé/désactivé, et il n'y a délibérément aucun champ pour saisir un nombre de contacts. Le désactiver ne vous donne pas de limite de contacts à définir — donc, sauf si vous avez une raison spécifique, laissez-le activé. Les trois limites que vous pouvez exprimer sous forme de nombre réel sont la **Limite de canaux**, la **Limite d'agents IA** et les **Sièges d'équipe**, chacune avec Non défini / Illimité / Personnalisé. > **Il n'y a pas de plafond par forfait pour les campagnes ou les diffusions.** Les agents sont l'élément à limiter si vous souhaitez garder un niveau de démarrage restreint — utilisez la **Limite d'agents IA** ci-dessus. > **Les niveaux sont des abonnements, pas des achats uniques.** Chaque niveau de tarification est un abonnement récurrent — facturé chaque mois, une fois par an ou toutes les N semaines selon son sélecteur **Facturation** — et il reste actif jusqu'à ce que le client annule. Les plans mensuels et annuels accordent l'allocation de crédits **chaque mois** ; un plan de type hebdomadaire l'accorde **chaque période de facturation**. Pour les recharges ponctuelles, utilisez l'option de montant personnalisé par crédit. Comme les niveaux sont des abonnements actifs, un niveau qui possède encore des abonnés actifs ne peut pas être supprimé — annulez ou migrez ces clients d'abord. > ⚠️ **La liste des fonctionnalités du niveau prévaut à chaque renouvellement.** Lorsqu'un client s'abonne à un niveau, et à chaque renouvellement, ses fonctionnalités sont réinitialisées exactement sur ce que ce niveau inclut. Donc, si vous activez une fonctionnalité supplémentaire pour un client depuis **Modifier le sous-compte**, ajoutez-la également à son niveau — sinon elle sera désactivée lors de son prochain renouvellement. (Les achats de crédits ponctuels personnalisés n'affectent pas les fonctionnalités.) #### Vendre un forfait sur un domaine en marque blanche spécifique Si vous gérez plus d'un [domaine en marque blanche](white-labeling.md#up-to-three-white-labels), chaque niveau dispose d'un sélecteur **Vendu sur** (qui n'apparaît qu'une fois que vous avez deux domaines ou plus). Laissez-le sur **Domaine principal** et rien ne change. Choisissez l'un de vos autres domaines — par exemple, votre domaine Lead Finder — et : - La **page de paiement** de ce niveau adopte l'image de marque du domaine, et après le paiement, l'acheteur est redirigé vers ce domaine, et non vers votre domaine principal. - Le sous-compte de l'acheteur est **automatiquement attribué à ce domaine**, de sorte que ses e-mails et son image de marque de connexion suivent ce domaine dès le premier jour (la même attribution que celle que vous pouvez définir manuellement dans le sélecteur **Marque blanche** du sous-compte). - Les clients connectés sur ce domaine voient une carte **Forfaits** sur leur page Crédits listant uniquement les forfaits vendus à cet endroit, avec un bouton de mise à niveau — ainsi, un client sur votre domaine Lead Finder peut s'abonner sans jamais voir votre marque principale. Les forfaits vendus sur votre domaine principal n'apparaissent jamais sur vos autres domaines, et inversement. Si vous [définissez ultérieurement un autre domaine comme domaine principal](white-labeling.md#changing-which-domain-is-main), chaque forfait qui était sur le **domaine principal** est épinglé au domaine sur lequel il était réellement vendu, de sorte que rien ne change pour les clients qui y effectuent des achats. Vous arriverez sur un écran **Tout est prêt !** avec une liste de vérification (compte Stripe connecté, niveaux de tarification configurés, webhook enregistré) et une astuce pour tester avec la carte de test Stripe `4242 4242 4242 4242`. À partir de là, **Voir le tableau de bord** vous mènera au tableau de bord du Mode SaaS. #### Clients changeant de plan Si vous permettez aux clients de gérer eux-mêmes leur abonnement depuis le portail client Stripe, ils peuvent passer d'un plan à l'autre par eux-mêmes. Voici l'impact sur leurs crédits. - **La mise à niveau en cours de cycle les recharge immédiatement.** Un client sur le plan Starter (100 crédits par mois) qui passe au plan Professional (1 000 par mois) au 10e jour reçoit la différence — 900 crédits — immédiatement, puis les 1 000 complets à partir de leur prochain renouvellement. Stripe facture la différence de prix pour le reste de la période ; les crédits sont prélevés de votre réserve, comme toujours. - **Le déclassement ne retire jamais de crédits.** Tout ce qui a déjà été accordé au client lui reste acquis, et rien ne revient dans votre réserve. La plus petite allocation s'applique à partir de leur prochain renouvellement. - **Passer d'un plan à l'autre à plusieurs reprises ne permet pas de gagner l'allocation deux fois.** La plateforme mémorise l'allocation la plus élevée dont la période actuelle du client a déjà été financée ; ainsi, Starter → Professional → Starter → Professional au cours d'un même mois ne distribue la différence de 900 crédits qu'une seule fois, et non deux. - **Les fonctionnalités, les sièges et les limites du plan suivent immédiatement le nouveau plan**, dans les deux sens. Deux points à régler correctement dans les paramètres de votre portail client Stripe : - **Gardez l'option « les clients peuvent modifier la quantité » désactivée.** La quantité multiplie ce qui est facturé au client mais jamais les crédits qu'il reçoit — un client qui définit la quantité sur 3 paie trois fois le prix et reçoit toujours l'allocation d'un seul plan. - **Planifier les déclassements pour la fin de la période de facturation est le choix par défaut le plus judicieux sur le plan financier.** Un déclassement qui prend effet immédiatement place le client sur un plan inférieur pour une période pour laquelle il a déjà payé le prix fort, et aucun des crédits déjà accordés ne vous est restitué. #### Étape 4 — Partagez vos liens de paiement L'onglet **Paiements** du tableau de bord répertorie vos liens de paiement. Ces liens utilisent le domaine sur lequel vous êtes connecté : ouvrez le tableau de bord depuis `app.youraiconnector.com` et ils commenceront par `app.youraiconnector.com` ; connectez-vous depuis votre propre domaine en marque blanche et ils porteront votre domaine à la place — une note sous les liens vous le rappelle. (Vous pouvez également remplacer manuellement la partie domaine d'une URL copiée.) La page de paiement elle-même est toujours en marque blanche, avec votre logo et votre marque. Il existe également une option **Copier le code d'intégration** sur le même onglet si vous souhaitez placer les cartes de tarification directement sur votre propre site web. Vous diffusez des publicités Meta ? Le code d'intégration transmet également l'ID de clic publicitaire Meta (`fbclid`) depuis votre page vers les boutons de paiement, et un lien de paiement simple l'accepte également (`...&fbclid=...`). Associé à un **ID de pixel Meta** sur votre domaine en marque blanche, cela permet à Meta d'attribuer l'inscription à la publicité. Consultez [Suivi des conversions des publicités Meta](white-labeling.md#tracking-meta-ads-conversions). Si vous avez également PayPal connecté, chaque forfait comporte un lien PayPal à côté de celui de Stripe, et le code d'intégration place un bouton par méthode de paiement connectée sur chaque carte tarifaire. Chaque lien de paiement pointe vers un plan selon sa position dans votre liste de plans (le premier plan est `tier=0`, le deuxième `tier=1`, et ainsi de suite). Si vous supprimez un plan, les plans suivants remontent d'une position. Par conséquent, copiez à nouveau vos liens et votre code d'intégration depuis l'onglet Paiements après avoir supprimé un plan, sinon un bouton sur votre site web pourrait finir par pointer vers le mauvais plan ou vers un plan qui n'existe plus. Les plans sont présentés à vos clients dans l'ordre où ils apparaissent dans votre liste de plans. **Ce que les acheteurs peuvent saisir lors du paiement.** Outre la carte bancaire, la page de paiement de Stripe demande l'adresse e-mail, le numéro de téléphone et l'adresse de facturation de l'acheteur, et propose un champ optionnel **Nom de l'entreprise** ainsi qu'une case à cocher **« J'achète en tant qu'entreprise »** où ils peuvent ajouter leur numéro de TVA ou d'identification fiscale. Le nom de l'entreprise et le numéro d'identification fiscale sont enregistrés sur le client dans votre compte Stripe, afin que vous puissiez les récupérer pour votre propre facturation. Le numéro de téléphone est demandé par défaut, mais vous pouvez désactiver cette option. Sous l'onglet **Paiements**, dans la section **Champs de paiement**, désactivez **Demander un numéro de téléphone lors du paiement**. Les acheteurs n'auront alors qu'à saisir leur adresse e-mail, leur carte et leur adresse de facturation. Cela s'applique immédiatement à vos liens de paiement et à votre tunnel de paiement intégré — inutile de copier quoi que ce soit à nouveau — et les comptes créés avec cette option désactivée n'auront tout simplement aucun numéro de téléphone enregistré, ce qui ne modifie en rien leur fonctionnement. > ⚠️ **Ne supprimez pas les produits créés par la plateforme dans votre compte Stripe.** Lorsque vous configurez des niveaux de tarification, la plateforme crée automatiquement les produits et prix Stripe correspondants. Les supprimer dans Stripe cassera vos liens de paiement. Gérez votre tarification depuis le tableau de bord du Mode SaaS, et non depuis Stripe. --- ### Option 2 : Fournisseur de paiement personnalisé Choisissez cette voie si Stripe n'est pas une option. La plateforme vous fournit un champ d'URL de webhook unique — vous êtes responsable du reste de la mise en place. Il y a **deux** choses que vous devez connecter vous-même : 1. **Inscription initiale** — lorsqu'un nouveau client paie via votre lien de paiement, vous appelez l'API de la plateforme pour créer le sous-compte. 2. **Recharges automatiques** — lorsque les crédits d'un sous-compte sont faibles, la plateforme appelle votre webhook afin que vous puissiez débiter la carte et accorder plus de crédits. #### Ce que vous construisez vous-même - **Produits / liens de paiement** chez votre propre fournisseur de paiement (Stripe en dehors de Stripe Connect, Mollie, Paddle, GoCardless, facturation manuelle, etc.). - **Un flux de travail qui s'exécute lors d'un paiement réussi**, qui appelle l'API de la plateforme pour : - Créer le sous-compte ([POST `/v1/sub-accounts`](https://help.dmchamp.com/api/reference)). - Envoyer éventuellement par e-mail au client son mot de passe temporaire. - **Un flux de travail qui gère les webhooks de recharge automatique** de la plateforme : débitez la carte enregistrée, puis appelez l'API de la plateforme pour ajouter des crédits. Vous n'avez pas à coder cela à partir de zéro — Zapier, Make, n8n ou tout autre outil low-code peut appeler l'API REST de la plateforme et l'API de votre fournisseur de paiement en séquence. #### Étape 1 — Trouver la référence de l'API La documentation complète de l'API se trouve sur **help.dmchamp.com → API Reference → Sub Accounts**. > Ouvrez `help.dmchamp.com` directement, et non l'URL de votre documentation en marque blanche. La référence de l'API est exclue de la documentation en marque blanche afin que vos clients ne puissent pas la voir. La section Sous-comptes (Sub Accounts) présente le point de terminaison de création de sous-compte, la structure de la réponse (y compris le mot de passe temporaire que vous pouvez utiliser dans votre e-mail de bienvenue) et les indicateurs de fonctionnalités disponibles que vous pouvez transmettre lors de la création d'un compte. #### Étape 2 — Configurer le webhook de recharge automatique 1. Dans l'assistant Mode SaaS, choisissez **Utiliser un fournisseur de paiement personnalisé**. 2. Saisissez votre **URL de webhook** — le point de terminaison sur votre serveur (ou Zapier / Make / n8n) qui gérera les événements de solde faible. 3. Cliquez sur **Envoyer un événement de test** pour vérifier que le point de terminaison est accessible. Le panneau de résultats affiche le statut HTTP renvoyé par votre serveur, la latence de l'aller-retour, le corps de la réponse et la charge utile JSON exacte envoyée — afin que vous puissiez construire et déboguer votre gestionnaire de bout en bout sans attendre qu'un vrai client soit à court de crédit. Les événements de test contiennent `test: true` dans la charge utile afin que votre serveur puisse s'arrêter avant de facturer quiconque. 4. Cliquez sur **Enregistrer l'URL du webhook**. Une fois configuré, chaque fois que le solde de crédits d'un sous-compte tombe en dessous de son seuil de recharge automatique : - La plateforme envoie une notification à votre URL de webhook avec les détails du sous-compte et le nombre de crédits dont il a besoin. - Votre serveur traite le paiement comme vous le souhaitez (débiter la carte du client, créer une facture, déduire d'un solde prépayé, etc.). - Une fois le paiement confirmé, votre serveur appelle l'API pour accorder les crédits au sous-compte. Pour les détails techniques sur la charge utile du webhook et l'appel API, consultez [Sub-Account Auto-Recharge (Custom Payment Provider)](sub-account-auto-recharge.md). --- ### Option 3 : Connecter PayPal Choisissez ce chemin si Stripe n'est pas disponible dans votre pays, ou si vos clients préfèrent payer avec PayPal. Il est intégré exactement comme Stripe — la plateforme gère le paiement, crée le sous-compte et livre les crédits — et l'argent va directement sur **votre propre compte PayPal Business**. Vous avez besoin d'un compte PayPal Business avec une application REST créée à l'intérieur ; il n'y a rien à construire. Connecter PayPal ne remplace pas Stripe. Si vous avez les deux, vos clients obtiennent les deux boutons, sur leur page de Facturation et sur vos cartes tarifaires. #### Étape 1 — Connectez votre application PayPal 1. Dans l'assistant du Mode SaaS, choisissez **Connecter PayPal à la place**. 2. Dans un nouvel onglet, ouvrez votre tableau de bord développeur PayPal et créez une **application REST** sur votre compte Business. 3. Copiez l'**ID client** et le **Secret** de l'application et collez-les dans l'assistant. 4. Choisissez l'environnement : **Live** pour les paiements réels, ou **Sandbox** si vous souhaitez tester tout le flux d'abord avec les acheteurs de test de PayPal. L'ID client et le Secret doivent provenir du même environnement que celui que vous choisissez, et les paiements Sandbox ne sont pas de l'argent réel — changez la connexion pour Live avant de partager vos liens. 5. Cliquez sur **Enregistrer & Continuer**. La plateforme vérifie immédiatement les informations d'identification auprès de PayPal ; si PayPal les rejette, rien n'est enregistré et vous pouvez les coller à nouveau. #### Étape 2 — Enregistrez le webhook PayPal Le webhook est la façon dont votre compte PayPal indique à la plateforme qu'un paiement a été effectué, qu'un abonnement a été renouvelé ou qu'un paiement a été remboursé. Sans lui, vos clients paient mais leurs crédits ne sont pas livrés. 1. L'assistant vous montre une **URL de webhook**. Copiez-la. 2. Dans la même application REST PayPal, ajoutez un webhook avec cette URL et abonnez-le à ces événements : - `CHECKOUT.ORDER.APPROVED` - `PAYMENT.CAPTURE.COMPLETED`, `PAYMENT.CAPTURE.DENIED`, `PAYMENT.CAPTURE.REFUNDED`, `PAYMENT.CAPTURE.REVERSED` - `PAYMENT.SALE.COMPLETED`, `PAYMENT.SALE.REFUNDED` - `BILLING.SUBSCRIPTION.ACTIVATED`, `BILLING.SUBSCRIPTION.CANCELLED`, `BILLING.SUBSCRIPTION.SUSPENDED`, `BILLING.SUBSCRIPTION.EXPIRED`, `BILLING.SUBSCRIPTION.PAYMENT.FAILED` - `VAULT.PAYMENT-TOKEN.DELETED` 3. PayPal attribue un **ID** au nouveau webhook. Copiez-le, collez-le dans l'assistant et cliquez sur **Enregistrer**. Vos plans restent les mêmes dans tous les cas : configurez-les une fois comme indiqué dans [Étape 3 — Configurer les niveaux de tarification](#step-3--set-up-pricing-tiers) et ils seront vendus via les méthodes de paiement que vous avez connectées. #### Ce que voient vos clients - **Recharges** — un bouton **Payer avec PayPal** sur leur page de facturation, à côté de l'option de carte bancaire, au même prix par crédit que vous avez défini. - **Plans** — chaque niveau obtient un lien de paiement PayPal à côté de celui de Stripe sur l'onglet **Paiements**, et **Copier le code d'intégration** génère un bouton par méthode de paiement connectée, afin qu'une carte tarifaire sur votre site web puisse proposer la carte bancaire et PayPal côte à côte. - **Recharges automatiques** — voir ci-dessous. #### Recharges automatiques sur PayPal Un paramètre, **Frais de recharge automatique**, détermine laquelle de vos méthodes connectées gère les recharges automatiques : Stripe, PayPal ou votre propre webhook. Une seule d'entre elles peut le faire à la fois, même si Stripe et PayPal sont tous deux connectés — tout le reste (recharges manuelles, paiement de plan) continue de proposer les deux. Réglez-le sur **PayPal** et chaque client connecte son propre compte PayPal une fois, depuis la carte **Recharge automatique** sur sa page de facturation. À partir de là, chaque fois que son solde tombe en dessous de son seuil, la plateforme débite ce compte PayPal enregistré pour la recharge au prix par crédit que vous avez défini et délivre les crédits automatiquement, exactement comme le fait le flux de carte Stripe. Un client qui n'a pas encore connecté PayPal n'est tout simplement pas débité — son solde diminue jusqu'à ce qu'il en connecte un ou achète des crédits manuellement — et si PayPal refuse un débit, aucun crédit n'est délivré et la plateforme réessaie la prochaine fois que le solde passe sous le seuil. Les clients peuvent supprimer leur compte PayPal de la même carte quand ils le souhaitent. Si vous déconnectez plus tard PayPal en mode SaaS et que c'était lui qui gérait les recharges automatiques, elles basculent sur Stripe si vous l'avez connecté, ou sur votre propre webhook si vous en avez configuré un. #### Bon à savoir sur PayPal - **Un plan demande toujours au client un compte PayPal, même lors d'un essai gratuit.** Les essais fonctionnent toujours — rien n'est débité tant que l'essai n'est pas terminé — mais PayPal exige que l'acheteur approuve avec un compte au préalable, donc l'option **Exiger une carte pour démarrer l'essai** du plan ne fait aucune différence sur un paiement PayPal. Si vous comptez sur des essais sans compte, vendez ce plan via Stripe. - **Les prix sont facturés exactement comme vous les avez définis.** PayPal n'ajoute pas de ligne de taxe distincte au moment du paiement, donc incluez toute taxe due dans le prix de vos plans et votre prix par crédit. - **Changer de plan signifie annuler et se réabonner.** Un client sous abonnement PayPal ne peut pas passer à un autre niveau sur place : il annule l'actuel et achète le nouveau plan via son propre lien. (Les clients payant par carte peuvent toujours changer dans le portail client Stripe — voir [Clients changeant de plan](#clients-switching-plans).) - **Un remboursement ne récupère pas les crédits.** Si vous remboursez un paiement PayPal depuis votre compte PayPal, le remboursement est enregistré ici, mais les crédits déjà délivrés restent sur le solde du client — comme avec Stripe. --- ### Configuration de la tarification - **Niveaux de tarification** — définissez des forfaits de crédits que vos clients peuvent acheter (jusqu'à 10, par ex. "Starter Pack : 100 crédits pour 15 $"), configurés sur l'onglet **Plans** du mode SaaS. Chaque plan est facturé **mensuellement, annuellement ou toutes les N semaines** (un prix annuel accorde toujours ses crédits mois par mois ; un plan de type hebdomadaire les accorde à chaque période de facturation) et peut inclure un **essai gratuit** de 1 à 90 jours avec son propre montant de crédits d'essai, avec ou sans demande de carte au préalable, et avec ou sans **expiration stricte** (les crédits d'essai inutilisés retournent dans votre réserve, compte verrouillé, si l'essai se termine sans mise à niveau). Voir [Étape 3 — Configurer les niveaux de tarification](#step-3--set-up-pricing-tiers). Chaque plan obtient son propre lien de paiement sur l'onglet **Paiements** — un lien Stripe, un lien PayPal, ou les deux, selon ce que vous avez connecté. Chaque plan peut également plafonner ce qu'un client conserve entre les renouvellements : le groupe **Crédits inutilisés** définit **Conserver au maximum** (mois d'allocation conservés) et **Expirer les crédits inutilisés après** (jours), appliqués à chaque client sur le plan — voir [Plafonner le report des crédits](sub-accounts.md#capping-what-rolls-over). Vous pouvez également gérer tout cela depuis le code — voir [Gérer vos niveaux de tarification via l'API](api-for-agencies.md#manage-your-pricing-tiers-over-the-api). - **Tarification par crédit** — définissez un prix personnalisé par crédit pour des recharges flexibles. Les achats de crédits personnalisés (ad-hoc) doivent être compris entre 10 et 10 000 crédits par transaction. Les abonnements aux niveaux couvrent des montants fixes ; le montant personnalisé gère tout ce qui se trouve entre les deux. Une **note** optionnelle (jusqu'à 200 caractères) est affichée aux clients directement sous le prix sur leur page de facturation — utile lorsque vous fixez le prix dans une devise mais facturez dans une autre, par ex. *"0,25 USD par crédit à notre taux de référence"*. Le prix et la note peuvent également être lus et modifiés depuis le code — voir [Définir votre prix par crédit via l'API](api-for-agencies.md#set-your-per-credit-price-over-the-api). - **Tarification minimale des crédits** — la plateforme impose un prix minimum par crédit pour maintenir la durabilité de la plateforme. Vous pouvez définir votre prix à ce minimum ou au-dessus. ### Tableau de bord des crédits des sous-comptes Les **Détails de consommation de crédits** de chaque sous-compte (accessibles depuis le menu **Plus** de sa ligne sur la page Sous-comptes) affichent : - Crédits achetés et dépenses totales - Crédits consommés et solde restant - Tendances d'utilisation au fil du temps, ventilées par motif et par campagnes principales > **Ce que montre le tableau de bord.** Lorsqu'un sous-compte utilise la clé API de votre agence, le tableau de bord affiche sa consommation de crédits mais masque le coût en dollars sous-jacent. Les totaux d'utilisation ne comptabilisent que les crédits réellement consommés — les bonus promotionnels, les renouvellements mensuels et les ajustements de forfait sont exclus afin que le chiffre des "crédits utilisés" reflète l'activité réelle. --- ## Copie de campagnes vers des sous-comptes Vous pouvez copier une campagne éprouvée depuis votre compte d'agence (ou n'importe quel sous-compte) vers un ou plusieurs sous-comptes à la fois — la configuration du bot, le message d'accueil, la FAQ et la base de connaissances, les fonctions personnalisées et les médias sont tous transférés, vous évitant ainsi de devoir tout reconstruire manuellement. La copie arrive sous forme de brouillon, et quelques éléments spécifiques au compte (modèles WhatsApp, canaux et numéro de téléphone, liste de contacts) sont à refaire sur chaque sous-compte. Commencez depuis la page **Sous-comptes** — ouvrez le menu **Plus** d'une ligne et choisissez **Copier la campagne ici**. Pour copier un agent IA à la place, utilisez **Copier l'agent ici** dans le même menu, ou l'icône **Copier cet agent dans un sous-compte** sur la ligne de l'agent dans la page **Agents IA**. Pour transmettre à un client une configuration complète en une seule fois plutôt qu'un seul agent, utilisez un **Snapshot** — consultez [Snapshots](snapshots.md). Pour obtenir la procédure complète étape par étape, savoir ce qui est copié et ce qui doit être refait, consultez [Copier une campagne vers un sous-compte](sub-accounts.md#copy-a-campaign-to-a-sub-account). --- ## Mode de connexion (agir en tant que sous-compte) Vous pouvez accéder directement au tableau de bord d'un sous-compte depuis votre compte d'agence, comme si vous étiez le client. Il s'agit de la même fonctionnalité que certaines plateformes appellent « assistance » ou « usurpation d'identité » — ici, l'action est intitulée **Se connecter en tant qu'utilisateur**. 1. Dans la barre latérale, cliquez sur **Sous-comptes**. 2. Trouvez le sous-compte dans la liste. Sur cette ligne, cliquez sur le menu **Plus** (icône à trois points tout à droite). 3. Cliquez sur **Se connecter en tant qu'utilisateur**. 4. Le tableau de bord se recharge en tant que ce sous-compte — vous avez un accès complet à ses campagnes, contacts, discussions et paramètres. 5. Une fois terminé, cliquez sur le bouton orange **Assistance : ** en haut de la barre latérale et choisissez **Retour à mon agence**. Ceci est particulièrement utile pour fournir une assistance pratique aux clients sans leur demander de partager leurs identifiants de connexion. --- ## Gestion des fonctionnalités des sous-comptes Selon votre niveau d'agence, vous pouvez contrôler les fonctionnalités auxquelles chaque sous-compte a accès. L'allocation des fonctionnalités est gérée par sous-compte et via vos niveaux de tarification. Depuis la fenêtre modale **Modifier** d'un sous-compte, vous pouvez effectuer des réglages précis individuellement : activer ou désactiver certaines fonctionnalités, masquer des pages spécifiques de son menu latéral et de ses paramètres, choisir qui reçoit ses e-mails d'alerte (voir [Routage des notifications](sub-accounts.md#notification-routing)), définir un plafond mensuel sur ses dépenses liées à sa propre clé API, et activer ou désactiver son niveau Max AI. L'éditeur de fonctionnalités inclut un groupe **Types de canaux** qui détermine les canaux de messagerie que le client peut connecter — Widget de chat, WhatsApp Business API, WhatsApp Web, Instagram, Facebook Messenger, Telegram, LINE, Viber, E-mail, SMS et iMessage. Les types de canaux sont activés par défaut, sauf si vous en désactivez certains ; un canal que vous avez désactivé apparaît comme verrouillé sur la page Canaux du client, avec une note indiquant qu'il n'est pas inclus dans son plan actuel. > **Si le client est sur un niveau payant, ajoutez également la fonctionnalité au niveau.** Les bascules que vous définissez ici sont remplacées par la liste des fonctionnalités du niveau à chaque renouvellement de l'abonnement du client. Utilisez la fenêtre modale **Modifier** pour des ajustements ponctuels, et le niveau tarifaire pour tout ce que le client doit conserver. > **Niveau Max AI et votre propre clé API.** Si votre agence utilise sa propre clé API, l'activation de Max pour un client fait passer l'utilisation de l'IA de ce client de « gratuit via votre clé » à 0,25 crédit par action facturé à votre compte d'agence. Il en va de même pour le niveau **Mini**, qui est inclus avec Max ; il fonctionne également sur notre infrastructure, à raison de 0,15 crédit par action, et jamais sur votre clé. --- ## Besoin d'aide ? If you have questions about agency accounts or sub-account management, reach out via our [email support](mailto:hi@dmchamp.com).