Authentication Messages

1. One-tap autofill

One-tap autofill authentication templates allow you to send a one-time password or code along with a one-tap autofill button to your users. When a WhatsApp user taps the autofill button, the WhatsApp client triggers an activity which opens your app and delivers it the password or code.

Create Template Sample

{
  "name": "authentication_code_autofill_button",
  "language": "en",
  "category": "authentication",
  "message_send_ttl_seconds": 60,
  "components": [
    {
      "type": "body",
      "add_security_recommendation": true
    },
    {
      "type": "footer",
      "code_expiration_minutes": 10
    },
    {
      "type": "buttons",
      "buttons": [
        {
          "type": "otp",
          "otp_type": "one_tap",
          "text": "Copy Code",
          "autofill_text": "Autofill",
          "package_name": "com.example.luckyshrub",
          "signature_hash": "K8a/AINcGX7"
        }
      ]
    }
  ]
}

Template Messsage Sample

{
      "to": "+91808080XXXX",
      "type": "template",
      "template": {
        "name": "verification_code",
        "language": {
          "code": "en"
      },
      "components": [
        {
          "type": "body",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        },
        {
          "type": "button",
          "sub_type": "url",
          "index": "0",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        }
      ]
    }
  }

2. Zero-tap

Zero-Tap Authentication Templates let your app deliver one-time passwords or codes via WhatsApp without the user ever leaving your app. When a user requests a code, WhatsApp broadcasts it directly, and your app's broadcast receiver captures it automatically and fills it in — the user never has to open WhatsApp or copy anything. If they do check the WhatsApp message, they'll only see fixed text like is your verification code. Before delivering the code, WhatsApp runs eligibility checks; if these fail and the code can't be broadcast, it falls back to showing a one-tap autofill or copy code button instead. Because of this fallback, your template payload must always include both a one-tap autofill button and a copy code button, even if most users never see them.

Create Template Sample

{
  "name": "zero_tap_auth_template",
  "language": "en",
  "category": "authentication",
  "message_send_ttl_seconds": 60,
  "components": [
    {
      "type": "body",
      "add_security_recommendation": true
    },
    {
      "type": "footer",
      "code_expiration_minutes": 5
    },
    {
      "type": "buttons",
      "buttons": [
        {
          "type": "otp",
          "otp_type": "zero_tap",
          "text": "Copy Code",
          "autofill_text": "Autofill",
          "zero_tap_terms_accepted": true,
          "supported_apps": [
            {
              "package_name": "com.example.luckyshrub",
              "signature_hash": "K8a/AINcGX7"
            }
          ]
        }
      ]
    }
  ]
}

Template Message Sample

{
      "to": "+91808080XXXX",
      "type": "template",
      "template": {
        "name": "verification_code",
        "language": {
          "code": "en"
      },
      "components": [
        {
          "type": "body",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        },
        {
          "type": "button",
          "sub_type": "url",
          "index": "0",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        }
      ]
    }
  }

3. Copy code

Copy code authentication templates allow you to send a one-time password or code along with a copy code button to your users. When a WhatsApp user taps the copy code button, the WhatsApp client copies the password or code to the device’s clipboard. The user can then switch to your app and paste the password or code into your app.

Create Template Sample

{
  "name": "authentication_code_copy_code_button",
  "language": "en",
  "category": "authentication",
  "message_send_ttl_seconds": 60,
  "components": [
    {
      "type": "body",
      "add_security_recommendation": true
    },
    {
      "type": "footer",
      "code_expiration_minutes": 5
    },
    {
      "type": "buttons",
      "buttons": [
        {
          "type": "otp",
          "otp_type": "copy_code",
          "text": "Copy Code"
        }
      ]
    }
  ]
}

Template Message Sample

{
      "to": "+91808080XXXX",
      "type": "template",
      "template": {
        "name": "verification_code",
        "language": {
          "code": "en"
      },
      "components": [
        {
          "type": "body",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        },
        {
          "type": "button",
          "sub_type": "url",
          "index": "0",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        }
      ]
    }
  }

1. One-tap autofill#

Create Template Sample#

Template Messsage Sample#

2. Zero-tap#

Create Template Sample#

Template Message Sample#

3. Copy code#

Create Template Sample#

Template Message Sample#

1. One-tap autofill

Create Template Sample

Template Messsage Sample

2. Zero-tap

Create Template Sample

Template Message Sample

3. Copy code

Create Template Sample

Template Message Sample