How to create SCG-WhatsApp Utility Template

 

In the WhatsApp realm, messages that are originated due to consumer actions or are requested by the consumer are in the UTILITY category.

This WhatsApp message category is used by the enterprises to provide feedback to the customer about the ongoing transaction specifics like accounts, amounts, status or any requested information.

Examples: Opt-In Management, Order Management, Accounts Alerts, Feedback Surveys and continue a conversation.

 

Purpose of this document

This document provides information on how to create a UTILITY WhatsApp template using SCG APIs.

 

SCG WhatsApp Template Management API

The SCG WhatsApp templates are the Meta regulated templates created to be used by the SCG API exclusively for the WhatsApp channel / type message. As an alternative for the SCG portal, the SCG API provides a way to manage SCG WhatsApp templates by calling API methods directly.

 

Example: creating a UTILITY Template by API call.

This example shows the SCG API call to create a WhatsApp UTILITY template.

We could use the Postman to directly execute an SCG API call with a POST request to create a simple template:

When executed, SCG API response looks like:

 

The cURL command to create the SCG WhatsApp template is:

curl -L -g 'https://api.syniverse.com/scg-external-api/api/v1/messaging/external_message_templates/{WABA}' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {SCG_TOKEN}' \
-d '{
  "language": "en_US",
  "name": "da_test_043",
  "category": "UTILITY",
  "components": [
    {
      "type": "HEADER",
      "format": "IMAGE",
      "example": {
        "header_handle": [
          "{Media Handler}"
        ]
      }
    },
    {
      "text": "Thank you! Your order {{1}} is confirmed. We will let you know once your package is on its way.",
      "type": "BODY",
      "example": {
        "body_text": [
          [
            "12345678"
          ]
        ]
      }
    }
  ]
}'

 

Example: using a UTILITY Template.

To send the UTILITY message using the new template in Postman

 

The message on the mobile device: