Introduction

This guide provides the specifications for the Gupshup Messaging API for WhatsApp Business, designed to facilitate sending and receiving WhatsApp messages through a simple REST API over HTTP/HTTPS.

It is intended for developers and IT teams within enterprises who wish to integrate their internal systems with the Gupshup Messaging API.

WhatsApp Template Categories

WhatsApp Business Messaging categorizes message templates into three broad categories:

  • Utility
  • Marketing
  • Authentication

MARKETING

Marketing templates are flexible and not related to a specific, pre-agreed transaction. They may include:

  • Promotions or offers
  • Welcome or closing messages
  • Updates or reminders
  • Invitations or recommendations
  • Requests to respond to or initiate a new transaction

UTILITY

Utility templates are tied to a specific, agreed-upon transaction and serve purposes such as:

  • Confirming, suspending, or changing a transaction or subscription

AUTHENTICATION

Authentication templates are used to verify user identity via one-time passcodes (typically 4–8 digit alphanumeric codes) for account login, verification, or recovery.

These templates are generally delivered via WhatsApp and are commonly triggered through a mobile app, giving users the option to receive one-time passwords or verification codes via WhatsApp.

Authentication templates can be created using Gupshup’s Unify Panel. As part of Meta’s implementation guidelines, each authentication template must include one of the following button types:

  • Copy Code Button
    Copies the one-time password or code to the user's clipboard. The user can then manually paste it into your app.
    Maximum character limit for the button name: 25 characters
  • One-Tap Autofill Button
    Automatically loads and passes the code to your app.
    Note: Supported only on Android devices.
  • Zero-Tap Authentication
    Allows users to receive and use the code within your app without leaving it or tapping any button.

Note: Media Messages are not supported in the Authentication Template.