Notifications

Notifications use pre-approved templates to send one-way messages to users.

---

Before sending a notification, make sure that:

• Webhooks are configured to receive delivery events.

• The template you are using has been approved.

• You have a valid orgId and API token.

If webhooks are not configured, delivery results and user events will not be captured.

Send Notification

Use this endpoint to send a WhatsApp template message to a single recipient.

POST https://www.channel360.co.za/v1.1/org/{{orgId}}/notification

Headers

Name	Value
Content-type	applications/json
Authorization	Bearer <token>

Body

orgId	stringrequired	Organization ID (path parameter)
destination	stringrequired	Recipient phone number
message	objectrequired	Message payload (template-based)
message.type	stringrequired	Must be set to template
message.template	objectrequired	Template message definition
message.template.name	stringrequired	The name of the template.
message.template.language	objectrequired	An object specifying the language for the template with the following properties:
message.template.language.policy	stringrequired	Set to "deterministic" to define the language policy.
message.template.language.code	stringrequired	Language code (e.g. en_US)
message.template.components	array	An array of message components. You can define message components within this array.

Examples of templates and notifications

Example 1: Notification sent using a basic text template.

Notification sent

{
    "destination": "{{mobileNumber}}",
    "message": {
        "type": "template",
        "template": {
            "name": "summer_sale_announcement",
            "language": {
                "policy": "deterministic",
                "code": "en_US"
            },
            "components": []
        }
    }
}

Template used

Example 2: Notification sent using a template with header tag, body tag, footer text, and button tag.

Notification sent

{
    "destination": "{{mobileNumber}}",
    "message": {
        "type": "template",
        "template": {
            "name": "contact_confirmation",
            "language": {
                "policy": "deterministic",
                "code": "en_US"
            },
            "components": [
                {
                    "type": "header",
                    "parameters": [
                        {
                            "type": "text",
                            "text": "Pete"
                        }
                    ]
                },
                {
                    "type": "body",
                    "parameters": [
                        {
                            "type": "text",
                            "text": "0852345678"
                        }
                    ]
                },
                {
                    "type": "button",
                    "sub_type": "url",
                    "index": "0",
                    "parameters": [
                        {
                            "type": "text",
                            "text": "639700347749ed00181de224"
                        }
                    ]
                }
            ]
        }
    }
}

Template used

Example 3: Notification sent using an Afrikaans template.

Notification

{
    "destination": "{{mobileNumber}}",
    "message": {
        "type": "template",
        "template": {
            "name": "af_kontak_met_etiket",
            "language": {
                "policy": "deterministic",
                "code": "af"
            },
            "components": [
                {
                    "type": "body",
                    "parameters": [
                        {
                            "type": "text",
                            "text": "Pieter"
                        }
                    ]
                }
            ]
        }
    }
}

Template used

What happens after sending?

When you send a notification, the API responds with a notificationId.

{
    "notification": {
        "_id": "696f4f59ad414d784b450a3e"
    }
}

Receiving a notificationId only confirms that the request was sent. It does not mean the message was delivered to the user.

Authentication Templates

Authentication Notification

For authentication message templates, the components array contains dynamic placeholders that must be populated with a unique {{AUTH_CODE}} at runtime. These placeholders ensure secure and personalised message delivery.

• The {{AUTH_CODE}} should be inserted into the parameters section dynamically before sending.

• The same {{AUTH_CODE}} should be used across all relevant components (e.g., body text and buttons).

{
    "destination": "{{mobileNumber}}",
    "message": {
        "type": "template",
        "template": {
            "name": "{{templateName}}",
            "language": {
                "policy": "deterministic",
                "code": "{{language}}"
            },
            "components": [
                {
                    "type": "body",
                    "parameters": [
                        {
                            "type": "text",
                            "text": "{{code}}"
                        }
                    ]
                },
                {
                    "type": "button",
                    "sub_type": "url",
                    "index": "0",
                    "parameters": [
                        {
                            "type": "text",
                            "text": "{{code}}"
                        }
                    ]
                }
            ]
        }
    }
}
 

Override API

This feature is not fully supported and comes with risk, use your own discretion.

Message overrides (also referred to as passthrough) are a way to access newer META features that are not yet fully supported by C360.

To use the override feature, you need to include an "override" object that will contain your usual payload fields instead of the message object. Here is an example:

{
  "destination": "2700000000",
  "message": { "type": "text", "text": "." }, //Removed almost all fields
  "override": { // Included them in this object instead
    "whatsapp": {
      "payload": {
        "type": "template",
        "template": {
          "name": "example_template",
          "language": { "policy": "deterministic", "code": "en" },
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "image",
                  "image": {
                    "link": "https://image.jpg"
                  }
                }
              ]
            },
            {
              "type": "body",
              "parameters": [
                { "type": "text", "text": "John" },
                { "type": "text", "text": "R 499.00" },
                { "type": "text", "text": "2025-10-01" }
              ]
            }
          ]
        }
      }
    }
  }
}