Pingtochat Docs

Pingtochat Docs

Did You Know?

You can create any type of product documentation with Docy

leafleafleafDocy banner shape 01Docy banner shape 02Man illustrationFlower illustration

No parameter header , body , footer and buttons – quick-replay ,visit-website,phone-number

Estimated reading: 3 minutes 65 views

This document provides detailed information about the Utility Templates used for communication purposes. These templates allow businesses to send structured messages to users for transactional or informational purposes.

Endpoint

http://{{your_domain}}/api/v1.0/{{phone_number_id}}/{{key}}/message_templates
  • {{your_domain}}: Your domain URL where the API is hosted.
  • {{phone_number_id}}: The unique identifier of the phone number used for sending messages.
  • {{key}}: Your API key for authentication.How to create key

Request Headers

  • Authorization: Bearer token for authentication.
  • Content-Type: Should be set to application/json.

Template Information

Utility Template J

  • Name: utility_j
  • Language: en_US (English – United States)
  • Category: UTILITY
  • Allow Category Change: Yes

Components

Utility Template J Components

The utility_j template consists of a Header, a Body, a Footer, and a Buttons component.

  • Header:
    • Type: HEADER
    • Format: TEXT
    • Text: Order Infermation
    • Purpose: Provides a title for the message, indicating that it contains order-related details.
  • Body:
    • Type: BODY
    • Text: Item no CR7000 is confirmed!
    • Purpose: Serves as a confirmation notification for an item, order, or transaction.
  • Footer:
    • Type: FOOTER
    • Text: Thank you for choosing us!
    • Purpose: Provides a closing remark to thank the recipient.
  • Buttons:
    • Type: BUTTONS
    • Buttons:
      • Type: QUICK_REPLY
      • Text: Unsubscribe from Promos
      • Purpose: Allows the recipient to opt out of promotional messages.
      • Type: URL
      • Text: Go to link
      • URL: https://app.pingtochat.com/
      • Purpose: Provides a link for the recipient to access additional resources or actions.
      • Type: PHONE_NUMBER
      • Text: Call
      • Phone Number: 91xxxxxxxxxx
      • Purpose: Provides a direct call option for customer support or further assistance.

Example Message Generation

Utility Template J

Header: Order Infermation Body: Item no CR7000 is confirmed! Footer: Thank you for choosing us! Buttons:

  • Unsubscribe from Promos
  • Go to link (URL: https://app.pingtochat.com/)
  • Call (Phone: 91xxxxxxxxxx)

Sample Request

{
  "name": "utility_j",
  "language": "en_US",
  "category": "UTILITY",
  "allow_category_change": true,
  "components": [
        {
        "type": "HEADER",
        "format": "TEXT",
        "text": "Order Infermation"
        },
        {
        "type": "BODY",
        "text": "Item no CR7000 is confirmed!"
        },
         {
        "type": "FOOTER",
        "text": "Thank  you for choosing us!"
        },
        {
        "type":"BUTTONS",
        "buttons": [
                {
                "type": "QUICK_REPLY",
                "text": "Unsubscribe from Promos"
                },
                {
                "type": "url",
                "text": "Go to link",
                "url": "https://app.pingtochat.com/"
                },
                {
                "type": "PHONE_NUMBER",
                "text": "Call",
                "phone_number": "91xxxxxxxxxx"
                }
            ]
        }
    ]
}

Success Response

Status Code: 201 APPROVED

{
    "id": "xxxxxx",
    "status": "APPROVED",
    "category": "MARKETING"
}

Notes

  • The template allows changes to the category since allow_category_change is set to true.
  • This template is intended for utility purposes, such as order confirmations, service updates, or other transactional messages.
  • The inclusion of Quick Reply, URL, and Phone Number Buttons allows recipients to opt out of promotions, access additional resources, or directly call for support.
  • The message format is mostly fixed and does not include dynamic placeholders, making it suitable for standard notifications.

Leave a Comment

Share this Doc

No parameter header , body , footer and buttons – quick-replay ,visit-website,phone-number

Or copy link

CONTENTS