WhatsApp gateways
A WhatsApp gateway is the WhatsApp Business service your organisation sends through. It decides whether a client’s WhatsApp goes out, on whose account, from which number, and on which approved template.
You see them under Settings › Correspondence › WhatsApp.
Gateways
| Column | What it tells you |
|---|---|
| Type | The WhatsApp service. Twilio is the one available today. |
| Sends for | Whole bank, or one operating entity that sends under its own brand. |
| Sender number | The WhatsApp business number clients see the message come from. |
| Account | The account at the WhatsApp service that sends, and is billed. |
| Credential | Set once the service’s auth token is entered on the Secrets page. |
If a gateway’s credential is not set, it sends nothing. Select Secrets and enter the token there.
Which gateway sends a message
- If the correspondence belongs to an operating entity with its own gateway, that gateway sends it.
- Otherwise the whole-bank gateway sends it.
If the operating entity’s own gateway has no credential, the message is not sent through the whole-bank gateway instead. It is recorded as skipped, “channel not configured”.
Templates
WhatsApp lets a business start a conversation only with a template Meta has approved. Your organisation gets each template approved at Meta, then records it against the kind of correspondence it carries.
| Column | What it tells you |
|---|---|
| Correspondence type | The kind of correspondence the template carries. |
| Template | The template id your WhatsApp service gave you. |
| Language | The template’s approved language. |
| Fills | Which parts of the correspondence fill the template’s blanks, in order: title, message, client name, document link. |
A template belongs to the gateway it was approved on. An operating entity’s gateway never borrows the whole-bank gateway’s templates.
If a kind of correspondence has no template, clients are not offered WhatsApp for it. A client who chose WhatsApp before the template was removed keeps the choice, but the message is skipped, “no approved template”, until a template is recorded again.
Documents
A statement goes on WhatsApp with its PDF. The message carries a private link to that one document. The link:
- opens only that document, for only your organisation,
- expires 15 minutes after the message is sent, unless your organisation sets a different time,
- cannot be altered to reach any other file.
Each time the link is opened, the fetch is recorded.
If a template has a document link but the correspondence has no document, the message is not sent. It is recorded as skipped, “no document for a document template”, and a must-deliver correspondence goes by its fallback instead.
The client’s opt-in
WhatsApp is only ever the client’s own choice. Choosing WhatsApp on the client’s Delivery tab records their opt-in: who made the change, and when. Removing it withdraws the opt-in, and the earlier choice stays in the history.
So WhatsApp is never:
- a default channel for a kind of correspondence,
- a must-deliver fallback,
- used for correspondence sent to an address rather than to a client.
See delivery preferences.
Which numbers get a message
A WhatsApp message goes only to the client’s mobile number, in international form
such as +27821234567.
| Result | What happened | What to do |
|---|---|---|
| no mobile number | The client has no mobile number. Nothing was sent. | Add the client’s mobile number. |
| invalid mobile number | The number is not a mobile number, for example a landline. Nothing was sent. | Correct the client’s mobile number. |
| invalid number | The WhatsApp service would not message the number. | Check the number with the client. |
| credential refused by the gateway | The auth token was rejected. | Enter a current token on the Secrets page. |
If the WhatsApp service times out, is unavailable, or asks you to slow down, the message is tried again later.
Standards
- Numbers are in the international telephone number format, ITU-T E.164.
- Templates and opt-in follow the WhatsApp Business Platform rules. Meeting the consent law your organisation is under stays your organisation’s obligation.
What your organisation configures
- Which WhatsApp service your organisation uses, its account, and its auth token.
- The sender number each gateway sends from.
- Whether an operating entity sends through a gateway of its own.
- The approved template for each kind of correspondence, and what fills it.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.