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

  1. If the correspondence belongs to an operating entity with its own gateway, that gateway sends it.
  2. 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:

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:

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

What your organisation configures

From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.