Creating Authentication Templates

Prev Next

Overview

Meta authentication templates are used for one-time passwords (OTPs), security verification, and account authentication messages.

This guide explains how to create and edit authentication templates in accordance with Meta’s current requirements.

For general information about WhatsApp templates, such as categories, statuses, and reporting, see the Template Management guide.

This guide covers authentication templates only. See the marketing and utilities templates guide to learn how to create those templates.

For detailed information on Meta’s authentication template policies, refer to Meta’s official documentation.

Creating Authentication Templates

  1. In the CommBox console, navigate to Settings > WhatsApp (in the Communication Channels section), and click the General Settings button at the top.
    WA module1- General boxed.png

  2. In the side menu bar, select the Message Templates section.
    WA module2 - Message Templates.png

  3. The template list displays all templates associated with your accounts, including their category and approval status. Click +Add Template.
    WA module2 - Message Templates - Add Template boxed.png

  4. In the new dialog box, enter:

    1. Select the WABA (WhatsApp Business Account) this template will be associated with.
    2. The primary language for this template.
    3. The template’s name (no capital letters or spaces)
    4. A Friendlier name for easy reference (optional)
    5. Select Authentication for the Category.
      WA Module - new Template1.png
  5. Template categories are determined and billed according to Meta's policies. Meta may reclassify a submitted template if its content does not match the selected category. For example, a business may consider a customer update to be a Utility message, while Meta may classify it as Marketing.
    To automatically accept Meta's category decision, leave the Accept WhatsApp category update option enabled (recommended).

  6. Click Next.

  7. The next section is for the content of the actual template.
    Authentication2.png

  8. Authentication messages use fixed text set by WhatsApp. Choose how the code is delivered and which optional lines to include:

    • Copy code
      Authentication2-copy code.png
      Customers copy the code and paste it on the organization’s website or app.

    • Autofill
      For Android only. When the customer taps the button, a code is sent to the website or app. Other devices will automatically receive a Copy code message.
      Authentication2-autofill.png
      a. Edit the button’s wording (optional)

      b. Package name: From the Google Play Console, select your app. The package name appears in the app information and Play Store URL.
      c. App Signature Hash: Navigate to Google Play Console > Select App > Release > Setup > App Integrity > App signing key certificate

  9. Add security messages (optional)

  10. Add expiry time for the code: 1- 90 minutes (optional)
    Authentication0.png

  11. Submit the Template
    Review the template configuration and click Submit for Review to submit it for Meta approval.

  12. Locate your template using the filters at the top.
    new autenication-pending.png

If you need assistance, contact support@commbox.io.

Editing Existing Marketing or Utility Templates

Before editing a template, note the following restrictions:

  • Editing templates requires the appropriate CommBox permissions.
  • Only templates with an Approved, Rejected, or Paused status can be edited.
  • The template's official name, category, and language cannot be changed.
  • Approved templates can be edited up to 10 times within a rolling 30-day period, and no more than once within 24 hours.
  • Rejected and Paused templates can be edited without limitation.

Editing Procedure

  1. Navigate to Settings > WhatsApp.

  2. Click the General Settings tab and then select the Message Templates section.

  3. Locate the template you want to modify. Use the available filters to quickly find specific templates.

  4. Click the 3-dot menu at the end of the line and select Edit.
    WA Module - new Template5.png

  5. Update the template content as required.
    On the first page, change the template's business display name. Click Next.

  6. Edit the content and click Save to submit the updated version for processing.
    The updated template will be reviewed and processed in accordance with Meta's template approval policies.

Note:Our API, Inbox, Compose, and Campaigns support sending authentication messages.

Compose Example:
image.png