Writing the verification SMS: the code placeholder, your Sender ID and staying in one part

WhatsApp & APIs·· 48 views· 3 min read

The short answer: the text field takes your own wording, up to 300 characters, with {code} once (that is where the code goes) and, if you like, {minutes} (the validity in minutes). If you leave it out, we use a short text that fits in one SMS. For your own, the recipe is: company name, the code, what it is for, “Do not share it”. And short, so it stays a single part.

What to include, and in what order

1 Who is sending, right at the start. Your company or service name, even if you use a Sender ID.
2 The code, early. Many phones show only the start of a message in the notification; the customer should not have to open the SMS to see it.
3 What it is for. Signing in, confirming the number, approving a payment. It is the best defence against code-sharing scams.
4 The validity, with {minutes}, if it fits.
5 “Do not share it.” Always.

Ready-made examples

Use Text for the text field
Login [COMPANY]: your login code is {code}. Valid for {minutes} min.
Sign-up [COMPANY]: code {code} to confirm your number. Do not share it.
Payment [COMPANY]: code {code} to confirm your payment. Do not share it.
Booking [COMPANY]: code {code} to confirm your booking for 20/12.
Portuguese, no accents (160 characters per part) [EMPRESA]: o seu codigo e {code}. Valido {minutes} minutos. Nao o partilhe.

Replace [COMPANY] with your company name before sending. Leave {code} and {minutes} as they are: we fill them in on each send.

Staying in one part

Without accents, an SMS holds up to 160 characters; with letters such as ã, õ, ç, á or ó, the whole message switches to Unicode and a part holds only 70. Each part uses one credit. English texts like the ones above have no accents and fit easily; Portuguese texts often do have them, so keep them short or drop the accents. The send response includes parts, so you will know from the first test. The full explanation is in how many credits an SMS uses.

The sender

In the sender field, give a Sender ID approved for the number's country, and the code arrives under your brand name. Without sender, it goes out from the free NETMSG sender. Neither can receive replies: the customer types the code on your website or app.

No links and no advertising in a code SMS. An offer next to the code makes the message look suspicious and pushes it into two parts. Send promotions separately, to people who agreed to receive them.
Autofill: some browsers can fill in the code by themselves if the last line of the SMS has @ followed by your site's domain, a space, and # followed by the code. It takes up characters, so check that the message still fits in one part.

Want to send codes with your own wording and brand name? See Verification SMS.

See Verification SMS

SEE ALSO

Code-sharing scams: protecting your customers from people who ask for their SMS code

Code length, validity and attempts: choosing length, expires_in and max_attempts

How much SMS verification costs: credits per code, free checks and a monthly estimate

How many credits an SMS uses: 160, 153, 70 and 67 characters explained

What a Sender ID is: SMS that arrive with your company name instead of a number

GSM-7 or Unicode in SMS: why one accent splits a message into more parts

RECOMMENDED PRODUCT

Web hosting with cPanel

Domain and SSL included, daily backups and the panel you already know. from KSh858.00/mo (3-year plan, with coupon)

See plans
Was this answer helpful? Your answer helps us improve this article.