Send verification code via WhatsApp

circle-info

WhatsApp provides specific templates for verification code messages:

  • Preset fixed text for the authentication message template:

    • Verification code

    • Security Disclaimer (Optional): For security reasons, please do not share this verification code.

    • Expiration warning (optional): This verification code will expire in <NUM_MINUTES> minutes.

  • Validity period: Customize the actual validity period of this verification code. If it is not delivered before the expiration date, the message will be withdrawn without incurring any fees.

  • Button: Copy Verification Code Button

The text does not support URLs, media, and emojis.

Authentication templates that include a one-time password button consist of only preset text and a button, so the risk of such templates being suspended is greatly reduced.

Prerequisites

  • Have a Finedu account

  • Register a WhatsApp Business account via Finedu Embedded System

  • Business number already linked

1

Create a verification template

2

Set template content

  • Select template language (content generated by meta tags).

  • Set optional content:

    • Choose the sending method: Copy code (copy verification code)

    • Add security tips and verification code expiration time reminders (optional)

    • Set message expiration time (optional)

We recommend setting a custom expiration period; you can choose 1–10 minutes as the message validity period. Once set, your authentication message must be sent within this period. If the message does not reach the user's device within this timeframe, it will be withdrawn, you will not be charged, and your customers will not see the message. If you do not set a custom expiration period, the standard WhatsApp message validity period (24 hours) will apply. This means you may incur additional charges for invalid messages sent after the timeout.

  • Click the submit button.

  • Returning to the template list, you can see the template you just created.

  • When you see the template status change to active, it means the template is available.

3

Send verification SMS

1

Send test SMS via Inbox

  • Enter the sending number (number format: +91286****39)

  • Choose your business number

  • Select template

  • Fill variables

2

Send test SMS via API

curl
curl --location --request POST 'https://wa.antgst.com/v1/whatsapp/messages/send' \
--header 'Authorization: Bearer 76062********456' \
--header 'Content-Type: application/json' \
--data-raw '{
    "to": "880******598",
    "from": "155****350",
    "type": "template",
    "template": {
        "name": "template_authentication_202",
        "parameters":"12324",
        "language": "bn"
    }
}'
4

Listen for Webhook push notifications

1

Configure callback address

2

Monitor OTP message status

For each message you send, a notification about the message's status will be sent to your webhook callback.

status
description

failed

Your message failed to send.

sent

The message you sent is being transmitted within WhatsApp's system.

delivered

Your message has been delivered to the customer's device.

read

Your message has been read by the customer. The read notification is only available to customers who have enabled read receipts.

See the API documentation for details.

Last updated