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).
- Find your key in your customer area on our website, or in the delivery email.
- Type or paste it in Licence key. The format is
XXXX-XXXX-XXXX-XXXX; spaces, dashes and lowercase are accepted. - 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 |