Ir al contenido principal

License

Activate your perpetual licence, understand what the License screen shows, why an unreachable licence server never stops your gateway, how to move to another machine, and what a withdrawn licence means.

Your licence is perpetual: bought once, it is yours and does not expire. The gateway checks it with our licence server from time to time, but it is built so that our server being down, slow or gone never stops your SMS. Only an explicit, signed withdrawal can reduce what the gateway does.

The licence is shown in License, in the System section of the menu, and summarised in Settings > License.

Activate the gateway

A new installation asks for the key before anything else: a window titled Activate this gateway opens on every screen until a key is entered (the License screen itself stays reachable).

  1. Find your key in your customer area on our website, or in the delivery email.
  2. Type or paste it in Licence key. The format is XXXX-XXXX-XXXX-XXXX; spaces, dashes and lowercase are accepted.
  3. Click Activate.

The first activation needs an internet connection to our server, once. After that, the gateway works offline. Only a Superadmin can activate or re-check the licence.

Message after Activate Meaning
Licence activated. Done
Key not recognised A typing mistake: the key is checked on your machine before anything is sent. Check it character by character
Our server is not answering Our server is unreachable: this says nothing about your key. Try again in a few minutes
Key issued for another version line The key is valid but for another major version of the gateway. An upgrade is bought from your customer area
This key has been withdrawn Our server signed a withdrawal for this key. Contact support

What the gateway sends us, and what it never sends

When it checks the licence, the gateway sends only: the key, the version line and version of the gateway, a fingerprint of the machine (a one-way hash, not a hardware identifier), the number of paired phones and a check counter. Never a message, a number, a contact or a log. A gateway with no key never contacts us at all.

How the check works

  • After activation, the gateway holds a signed local token, valid for a limited time (typically 90 days). It renews it silently about once a day.
  • If our server does not answer, it tries again later: after 15 minutes, 1 hour, 6 hours, then every 24 hours, for ever. Nothing is suspended in the meantime.
  • Once you have held the licence for 12 months, offline operation becomes unlimited: the gateway no longer needs to reach us at all. The screen then shows This licence is yours unconditionally.

What the License screen shows

The status

Status What it means Sending
No key recorded No key was ever entered on this installation Enter a key
Licence active Everything is in order. There is nothing for you to do Continues
Local token due for renewal The local token is past its date; renewal happens by itself as soon as our server answers Continues
Renewal pending for a while The token has not been renewed for more than 30 days. Your licence is still valid, nothing is suspended Continues
Licence withdrawn A signed decision withdrew this licence. The only case where the gateway reduces what it does Suspended; reading and exporting your data stay open

Contact with our activation server

This block describes our attempts, not your licence: Activation server reachable or Activation server unreachable ("The service is not degraded: an unreachable server is never an invalid license"), with No answer since, Last attempt, Last successful contact and Next attempt. Check now (Superadmin) forces an attempt immediately; its result is informative only.

What your key allows

Field Meaning
Key The first four characters of your key; the full key is never displayed
Version line The major version your key opens
Updates included until Updates published up to this date are included
Local token validity When the local token is due for renewal. Passing it cuts nothing
Check counter Number of checks made, a protection against a computer clock moved backwards

Check log

Check log lists every contact attempt, newest first, with its Result:

Result Meaning
Success Token renewed
No answer Our server could not be reached, or its answer could not be verified. Nothing changes for you
Signed refusal Our server refused without withdrawing the licence, for example Different machine fingerprint or Usage reported as abusive. Nothing stops
Other version line The key belongs to another major version: an upgrade offer is shown. Nothing stops
Signed withdrawal The licence was withdrawn: see below

When our server is unreachable

Nothing stops. Sending, receiving, campaigns, automatic replies, the API: everything keeps working. The Activity log records "Our licence server cannot be reached. Nothing is suspended" and, later, how long the outage lasted. The indicator clears by itself. Your tools can follow the same facts with the license.offline and license.reconnected webhook events.

An answer that the gateway cannot verify (a proxy error page, a captive portal, a forged answer) is treated exactly like no answer: it can never withdraw your licence.

Moving to another machine

The licence holds one machine at a time, identified by its fingerprint.

  • Moving with your data, following Changing server without losing the gateway's secret key, keeps the fingerprint: there is nothing to do.
  • On a new installation, enter your key. If the old machine still holds the activation, the gateway reports that the licence is already in use on another machine and the check log shows Different machine fingerprint. Nothing stops: the new gateway works and sends. To release the old machine, use Regenerate key in your customer area: every machine is freed, the old key stops working, and you enter the new key on the new gateway. You can also contact support.

A withdrawn licence

A licence is withdrawn only by a decision our server signs, for example after a refund. In that case:

  • sending stops (quick send, campaigns, automatic replies, API sends);
  • reading and exporting your data stay open: conversations, contacts, history, existing backups and exports remain accessible, so you can always take your data with you;
  • the screen shows Enter your key again: if you contested the withdrawal and won, typing the key here is the way out. Contact support to contest.

With the API

Method Path What it does
GET /api/v1/license The licence state, without contacting our server
POST /api/v1/license/activate Records a key ({"licenseKey": "XXXX-XXXX-XXXX-XXXX"}) and activates it
POST /api/v1/license/check Forces a check. Answers 200 even when our server did not answer: the result is in the body
GET /api/v1/license/checks The check log

Activation and check need a Superadmin session or a key with the admin scope. POST /license/activate also lets you replace the key of an active installation, for example after regenerating your key in your customer area.

Troubleshooting

What you see What to do
Activation server unreachable Nothing. If it lasts for days, check that the machine can reach the internet
Our server is not answering on the first activation The machine needs internet access for this one step. Try again later
Key not recognised Copy the key again from your customer area
Renewal pending for a while Nothing is suspended. Check the internet access of the machine; the message clears at the next successful contact
Different machine fingerprint in the check log The licence is still attached to your previous machine. Contact support for a reset
Licence withdrawn Export what you need, then contact support

Buscar en la documentación

Escriba algunas palabras y elija una página.