Aller au contenu principal

Licence

Activer votre licence, comprendre ce que montre l'écran Licence, combien de temps la passerelle continue d'envoyer quand notre serveur de licences est injoignable, pourquoi elle n'a plus besoin de nous à partir de la date fixée par le contrat de licence, ce qui change avec une licence étudiante, comment changer de machine, et ce que signifie une licence retirée.

Une licence complète est perpétuelle : achetée une fois, elle vous appartient et n'expire pas. Toutes les mises à jour de la ligne de version achetée (par exemple toutes les versions 1.x de la V1) sont incluses à vie, sans surcoût. Une future version majeure (V2) sera une mise à niveau payante.

Une licence étudiante ? Elle donne toutes les fonctionnalités, avec un quota d'envoi quotidien et une durée qui se redemande chaque année, et elle a besoin de joindre notre serveur d'activation plus souvent qu'une licence complète. Lisez Si vous avez une licence étudiante : c'est la seule section de cette page qui change pour vous.

La passerelle vérifie la licence auprès de notre serveur de licences environ une fois par jour. Elle est conçue pour qu'une panne de notre côté n'arrête pas vos SMS du jour au lendemain :

  • avant la date indiquée sur l'écran Licence dans Sans condition à partir du, la passerelle continue d'envoyer pendant toute panne de 30 jours au plus (15 jours de validité de son jeton local, puis 15 jours de grâce) ; au-delà, les envois sont mis en pause et reprennent d'eux-mêmes à la vérification réussie suivante ;
  • à partir de cette date, fixée par le contrat de licence, la passerelle ne dépend plus de notre serveur : elle continue de fonctionner même si notre serveur disparaît ;
  • seul un retrait explicite et signé (par exemple après un remboursement) arrête les envois immédiatement.

La licence s'affiche dans Licence, dans la section Système du menu, et est résumée dans Paramètres > Licence.

Activer la passerelle

Une nouvelle installation demande la clé avant toute chose : une fenêtre intitulée Activer cette passerelle s'ouvre sur chaque écran tant qu'aucune clé n'est saisie (l'écran Licence lui-même reste accessible).

  1. Retrouvez votre clé dans votre espace client sur notre site, ou dans le courriel de livraison.
  2. Tapez-la ou collez-la dans Clé de licence. Le format est XXXX-XXXX-XXXX-XXXX ; les espaces, les tirets et les minuscules sont acceptés.
  3. Cliquez sur Activer.

La première activation demande une connexion internet vers notre serveur. Ensuite, la passerelle renouvelle sa licence d'elle-même ; voyez plus bas combien de temps elle peut se passer de nous. Seul un Superadministrateur peut activer ou revérifier la licence.

Message après Activer Signification
Licence activée. C'est fait
Clé non reconnue Une faute de frappe : la clé est vérifiée sur votre machine avant tout envoi. Vérifiez-la caractère par caractère
Notre serveur ne répond pas Notre serveur est injoignable : cela ne dit rien de votre clé. Réessayez dans quelques minutes
Clé émise pour une autre ligne de version La clé est valable, mais pour une autre version majeure de la passerelle. Une mise à niveau s'achète depuis votre espace client
Cette clé a été retirée Notre serveur a signé un retrait pour cette clé. Contactez le support

Ce que la passerelle nous envoie, et ce qu'elle n'envoie jamais

Quand elle vérifie la licence, la passerelle envoie seulement : la clé, la ligne de version et la version de la passerelle, une empreinte de la machine (un hachage à sens unique, pas un identifiant matériel), le nombre de téléphones appairés et un compteur de vérifications. Jamais un message, un numéro, un contact ni un log. Une passerelle sans clé ne nous contacte jamais.

Comment la vérification fonctionne

  • Après l'activation, la passerelle détient un jeton local signé, valable 15 jours. Elle le renouvelle discrètement environ une fois par jour : en temps normal, le jeton n'approche jamais de sa date.
  • Si notre serveur ne répond pas, la passerelle réessaie plus tard : après 15 minutes, 1 heure, 6 heures, puis toutes les 24 heures, indéfiniment. Les envois continuent entre-temps.
  • Si le jeton dépasse sa date sans être renouvelé, une période de grâce de 15 jours s'ouvre. Les envois continuent toujours, et un bandeau indique la date à laquelle les envois seront mis en pause si aucune vérification ne réussit d'ici là.
  • Si la période de grâce se termine elle aussi, et que la licence n'a pas atteint la date indiquée dans Sans condition à partir du, les envois sont mis en pause jusqu'à la vérification réussie suivante (voir plus bas). La passerelle réessaie alors au moins toutes les heures.
  • Le jeton porte, signée par nous, la date fixée par le contrat de licence à partir de laquelle votre licence devient sans condition, affichée dans Sans condition à partir du tant qu'elle n'est pas atteinte. La passerelle compare cette date à sa propre horloge : une fois atteinte, elle n'a plus du tout besoin de nous joindre, même si elle n'a pas pu nous contacter depuis des mois. La vérification continue environ une fois par jour, mais n'a plus besoin de réussir. L'écran affiche alors Cette licence vous appartient sans condition.
  • Reculer l'horloge de la machine ne prolonge aucune de ces dates : la passerelle tient un compteur de vérifications et la date la plus tardive qu'elle a vue, et ne revient jamais en arrière.

Si vous avez une licence étudiante

Une licence étudiante donne la même passerelle et les mêmes fonctionnalités que la licence complète : les mêmes téléphones, la même API, la même automatisation, les mêmes conversations. Trois choses diffèrent, et aucune ne vous est cachée.

Elle envoie 30 messages par jour

Une licence étudiante peut envoyer 30 messages par jour depuis toute l'installation, comptés en messages entiers et non en morceaux : un SMS long que votre opérateur facture en trois ne compte ici que pour un. Le décompte porte sur la journée calendaire UTC, la même horloge que les quotas des cartes SIM, donc il repart à minuit UTC quel que soit le fuseau que vous affichez.

Le 21e message de la journée attend, il n'est pas perdu. Il passe en Quota atteint dans l'historique des messages, exactement comme un message qui attend un quota de SIM, et part de lui-même à minuit UTC. Il n'est jamais marqué en échec, il ne coûte aucune tentative, et vous n'avez rien à faire : le lendemain, il part en premier. Tout ce qui arrive continue d'être reçu, sans aucune limite.

Le quota est décompté au moment où un message est remis à un téléphone : un message qu'un téléphone refuse ensuite a donc déjà consommé sa part de la journée. La réception, les conversations, les contacts, les exports, le dashboard et toutes les lectures par l'API ne sont jamais comptés ni limités.

Elle dure douze mois, puis se redemande

Une licence étudiante est accordée pour douze mois. Sa date de fin est fixée à son émission, et vous en redemandez une à la fin de chaque période depuis votre espace client, avec le justificatif de l'année en cours. La passerelle n'a rien à réinstaller : dès que la nouvelle licence est en vigueur, la vérification réussie suivante la prend en compte.

Quand la période est terminée, les envois sont mis en pause et rien d'autre ne s'arrête. Les messages en file attendent, la réception, les conversations, les contacts, le dashboard et les lectures par l'API continuent de fonctionner, et vos données restent les vôtres. La licence n'est pas retirée, et rien n'est supprimé.

Elle a besoin de joindre notre serveur tous les trois jours

C'est la vraie différence, et elle est voulue. Une licence complète continue d'envoyer pendant une panne de 30 jours au plus, et à partir de la date indiquée dans Sans condition à partir du elle ne dépend plus de nous du tout. Une licence étudiante n'a jamais cela. Elle détient un jeton local valable trois jours, le renouvelle environ deux fois par jour, et n'a aucune période de grâce : si rien ne réussit pendant trois jours, les envois sont mis en pause.

Durée sans vérification réussie Licence étudiante
Jusqu'à 3 jours Tout fonctionne
Au-delà de 3 jours Envois en pause jusqu'à la vérification réussie suivante

Une licence étudiante n'affiche jamais non plus Sans condition à partir du : elle dépend de la vérification pendant toute sa durée. C'est ce que paie le prix réduit, et c'est la raison d'être de la licence complète.

Ce que montre l'écran quand elle ne peut pas nous joindre. L'écran Licence affiche Envois en pause : vérification de licence nécessaire, le bloc de contact affiche Serveur d'activation injoignable avec Sans réponse depuis, et Envois mis en pause le donne la date à laquelle c'est arrivé. Le comportement est celui de toute licence en pause :

  • les messages déjà en file attendent dans la file : rien n'est mis en échec ni perdu, et les nouveaux sont acceptés et attendent avec eux ;
  • la réception, les conversations, les contacts, le dashboard, les lectures par l'API et tous les réglages continuent de fonctionner ;
  • les envois reprennent d'eux-mêmes à la vérification réussie suivante, en commençant par les messages en file. La passerelle réessaie au moins toutes les heures, et Vérifier maintenant force une vérification immédiate ;
  • votre licence n'est pas retirée : une panne de notre côté, quelle qu'en soit la durée, ne retire jamais une licence et ne fait perdre aucun message.

Une installation étudiante a donc besoin d'une machine qui accède à internet, et à notre serveur d'activation à travers un éventuel pare-feu ou proxy. Si votre réseau bloque les connexions sortantes pendant des jours, c'est la licence complète qu'il faut acheter.

Ce que montre l'écran Licence

Le statut

Statut Ce que cela signifie Envois
Aucune clé enregistrée Aucune clé n'a jamais été saisie sur cette installation. La passerelle fonctionne en période d'essai jusqu'à la date indiquée dans Fin de l'essai le Se poursuit jusqu'à cette date
Période d'essai terminée, envoi en pause Aucune clé n'a jamais été saisie et l'essai est terminé En pause ; les messages attendent dans la file, tout le reste continue de fonctionner. La saisie d'une clé les libère aussitôt
Licence active Tout est en ordre. Vous n'avez rien à faire Continuent
Jeton local à renouveler Le jeton local a dépassé sa date et la période de grâce de 15 jours court. Un bandeau indique la date de mise en pause des envois ; le renouvellement se fait seul dès que notre serveur répond Continuent
Envois en pause : vérification de licence nécessaire La période de grâce est terminée et la licence n'a pas atteint la date indiquée dans Sans condition à partir du, ou cette machine n'a jamais obtenu de jeton pour la clé (voir Changer de machine), ou une licence étudiante a passé trois jours sans vérification réussie, ou sa période est terminée En pause ; les messages attendent dans la file, tout le reste continue
Licence retirée Une décision signée a retiré cette licence Suspendus ; la consultation et l'export de vos données restent ouverts

Avant de saisir une clé. Une installation neuve fonctionne entièrement pendant 7 jours, le temps de l'installer, d'appairer vos téléphones et de brancher votre propre code avant de payer. L'écran Licence affiche la date de fin dans Fin de l'essai le. Une fois cette date passée, les messages sortants ne partent plus et attendent dans la file : aucun n'est en échec, aucun n'est perdu, les messages entrants continuent d'arriver et le tableau de bord continue de fonctionner. Dès que vous saisissez une clé de licence, la file repart normalement. Le temps qui passe ne retire jamais rien.

À partir de la date indiquée dans Sans condition à partir du, la licence affiche Licence active, quel que soit l'état de notre serveur. Une licence étudiante n'affiche jamais Jeton local à renouveler : elle n'a pas de période de grâce, elle passe donc directement de Licence active à Envois en pause : vérification de licence nécessaire.

Contact avec notre serveur d'activation

Ce bloc décrit nos tentatives : Serveur d'activation joignable ou Serveur d'activation injoignable, avec Sans réponse depuis, Dernière tentative, Dernier contact réussi et Prochaine tentative. Un serveur injoignable n'est jamais une licence invalide : avant la date indiquée dans Sans condition à partir du, il ne compte que s'il dure au-delà de la période de grâce. Vérifier maintenant (Superadministrateur) force une tentative immédiate ; quand les envois sont en pause, une vérification réussie les relance aussitôt.

Ce que votre clé autorise

Champ Signification
Clé Les quatre premiers caractères de votre clé ; la clé complète n'est jamais affichée
Ligne de version La version majeure que votre clé ouvre
Mises à jour incluses Toutes les versions de votre ligne de version, à vie
Validité du jeton local Quand le jeton local doit être renouvelé. La dépasser ouvre la période de grâce de 15 jours
Envois mis en pause le Affiché quand aucune vérification n'a réussi depuis un moment : la date de mise en pause des envois, sauf vérification réussie avant
Sans condition à partir du La date, fixée par le contrat de licence, à partir de laquelle votre licence ne dépend plus de notre serveur. À partir de là, la vérification continue mais n'a plus besoin de réussir, et cette ligne laisse place à Cette licence vous appartient sans condition
Compteur de vérifications Nombre de vérifications faites, une protection contre une horloge d'ordinateur reculée

Journal des vérifications

Le Journal des vérifications liste chaque tentative de contact, de la plus récente à la plus ancienne, avec son Résultat :

Résultat Signification
Réussite Jeton renouvelé
Sans réponse Notre serveur n'a pas pu être joint, ou sa réponse n'a pas pu être vérifiée. La licence n'est pas retirée ; seul compte le temps passé sans aucune vérification réussie
Refus signé Notre serveur a refusé le renouvellement sans retirer la licence, par exemple Empreinte machine différente ou Usage signalé comme abusif. Rien ne s'arrête sur le moment, mais aucun jeton n'est renouvelé : les règles de grâce s'appliquent
Autre ligne de version La clé concerne une autre version majeure : une offre de mise à niveau s'affiche. Le logiciel installé n'est pas celui qu'ouvre votre clé, aucun jeton n'est obtenu : les règles de grâce s'appliquent
Retrait signé La licence a été retirée : voir plus bas

Quand notre serveur est injoignable

Durée sans vérification réussie Avant la date indiquée dans Sans condition à partir du À partir de cette date
Jusqu'à la date du jeton (15 jours après la dernière réussite) Tout fonctionne Tout fonctionne
Les 15 jours suivants (grâce) Tout fonctionne, bandeau avec la date de pause Tout fonctionne
Au-delà Envois en pause jusqu'à la vérification réussie suivante Tout fonctionne, sans limite de durée

Ce sont les durées d'une licence complète. Une licence étudiante dispose de trois jours et d'aucune période de grâce.

Le Journal d'activité inscrit le moment où notre serveur de licences cesse de répondre puis, plus tard, la durée de la panne. Vos outils peuvent suivre les mêmes faits avec les événements webhook license.offline et license.reconnected. Si les notifications sont activées, les administrateurs sont aussi prévenus quand les envois sont mis en pause.

Pendant la pause des envois

  • Les messages déjà en file attendent dans la file : rien n'est mis en échec ni perdu. Les nouveaux messages, depuis le dashboard, les campagnes, les réponses automatiques ou l'API, sont acceptés et attendent avec eux.
  • La réception, les conversations, les contacts, le dashboard, les lectures par l'API et tous les autres réglages continuent de fonctionner.
  • Les envois reprennent d'eux-mêmes à la vérification réussie suivante, en commençant par les messages en file. La passerelle réessaie au moins toutes les heures ; Vérifier maintenant force une vérification immédiate.
  • Que faire : vérifiez que la machine accède à internet (et à notre serveur de licences à travers un éventuel pare-feu ou proxy). Si c'est notre serveur qui est en panne, contactez le support.

Une réponse que la passerelle ne peut pas vérifier (une page d'erreur de proxy, un portail captif, une réponse falsifiée) est traitée exactement comme une absence de réponse : elle ne peut jamais retirer votre licence.

Changer de machine

La licence occupe une machine à la fois, identifiée par son empreinte. Utiliser la même licence sur plusieurs machines en même temps est interdit par le contrat de licence (article 2.3) ; changer de machine est permis.

  • Déménager avec vos données, en suivant Changer de serveur sans perdre la clé secrète de la passerelle, conserve l'empreinte : il n'y a rien à faire.
  • Sur une nouvelle installation, saisissez votre clé. Si l'ancienne machine détient encore l'activation, la passerelle signale que la licence est déjà utilisée sur une autre machine et le journal des vérifications affiche Empreinte machine différente. La nouvelle passerelle envoie pendant 15 jours, puis met ses envois en pause jusqu'à obtenir son propre jeton, quelle que soit la date : la date indiquée dans Sans condition à partir du ne s'applique qu'à une machine qui a elle-même obtenu un jeton. Pour libérer l'ancienne machine, utilisez Régénérer la clé dans votre espace client : toutes les machines sont libérées, l'ancienne clé cesse de fonctionner, et vous saisissez la nouvelle clé sur la nouvelle passerelle. Vous pouvez aussi contacter le support.
  • Une copie de la base restaurée sur une autre machine n'emporte pas la licence avec elle : le jeton appartient à la machine qui l'a obtenu, et la copie suit la même règle qu'une nouvelle installation.

Une licence retirée

Une licence n'est retirée que par une décision signée par notre serveur, par exemple après un remboursement. Dans ce cas :

  • les envois s'arrêtent immédiatement, quel que soit l'âge de la licence (envoi rapide, campagnes, réponses automatiques, envois par l'API) ;
  • la consultation et l'export de vos données restent ouverts : conversations, contacts, historique, sauvegardes existantes et exports restent accessibles, pour que vous puissiez toujours emporter vos données ;
  • l'écran affiche Ressaisir votre clé : si vous avez contesté le retrait et obtenu gain de cause, retaper la clé ici est la sortie. Contactez le support pour contester.

Par l'API

Méthode Chemin Ce qu'il fait
GET /api/v1/license L'état de la licence, sans contacter notre serveur
POST /api/v1/license/activate Enregistre une clé ({"licenseKey": "XXXX-XXXX-XXXX-XXXX"}) et l'active
POST /api/v1/license/check Force une vérification. Répond 200 même quand notre serveur n'a pas répondu : le résultat est dans le corps
GET /api/v1/license/checks Le journal des vérifications

L'activation et la vérification demandent une session de Superadministrateur ou une clé de portée admin. POST /license/activate permet aussi de remplacer la clé d'une installation active, par exemple après avoir régénéré votre clé dans votre espace client.

GET /license indique aussi quelle édition vous détenez, pour que vos propres outils puissent suivre un quota étudiant :

Champ Ce qu'il porte
edition standard pour une licence complète, student pour une licence étudiante
expiresAt La fin de la période étudiante. null sur une licence complète, dont le droit d'usage ne finit pas
dailyCap Les messages autorisés par journée UTC. null quand il n'y a aucun quota à respecter
sentToday Les messages déjà envoyés sur la journée UTC en cours. null quand il n'y a aucun quota, et null aussi quand la passerelle n'a pas pu lire le compteur

En cas de problème

Ce que vous voyez Que faire
Serveur d'activation injoignable Rien dans un premier temps. Si cela dure des jours, vérifiez que la machine accède à internet
Un bandeau Envois mis en pause le Vérifiez l'accès internet de la machine, puis utilisez Vérifier maintenant. Le bandeau disparaît à la vérification réussie suivante
Envois en pause : vérification de licence nécessaire Comme ci-dessus ; les envois reprennent d'eux-mêmes à la vérification réussie suivante. Si le journal des vérifications affiche Empreinte machine différente, libérez l'ancienne machine depuis votre espace client
Notre serveur ne répond pas à la première activation La machine a besoin d'un accès internet pour cette seule étape. Réessayez plus tard
Clé non reconnue Recopiez la clé depuis votre espace client
Empreinte machine différente dans le journal des vérifications La licence est encore rattachée à votre ancienne machine. Utilisez Régénérer la clé dans votre espace client, ou contactez le support
Licence retirée Exportez ce dont vous avez besoin, puis contactez le support
Des messages en Quota atteint avec une licence étudiante Les 30 messages de la journée sont consommés. Ils partent d'eux-mêmes à minuit UTC. Si 30 par jour ne suffisent pas, la licence complète n'a aucun quota
Envois en pause : vérification de licence nécessaire avec une licence étudiante Trois jours ont passé sans vérification réussie, ou la période est terminée. Vérifiez que la machine accède à internet, puis utilisez Vérifier maintenant. Si la période est terminée, redemandez une licence depuis votre espace client : les envois reprennent à la vérification réussie suivante

Rechercher dans la documentation

Saisissez quelques mots, puis choisissez une page.