message/sendTemplate

When to Use

• Outbound marketing campaigns: A promotional workflow sends an approved marketing template to opted-in customers announcing a seasonal sale, with personalised first name and discount code variables.
• Appointment reminders outside business hours: A healthcare workflow sends a pre-approved reminder template to patients 48 hours before their appointment, regardless of whether the patient has messaged recently.
• Order status proactive notifications: An e-commerce workflow sends a shipping notification template when an order label is created, re-engaging customers who last messaged more than 24 hours ago.
• Authentication OTP via template: A security workflow sends an authentication template with a one-time code variable to users who request account recovery, ensuring delivery even to cold sessions.
• Subscription renewal alerts: A billing workflow sends a renewal reminder template 7 days and 1 day before a subscription expires, with the plan name, renewal date, and price as variables.

Configuration

Connection

Operation

Components JSON Schema

The componentsJson array contains objects for each component type in the template:

[
  {
    "type": "header",
    "parameters": [
      { "type": "text", "text": "Order #ORD-12345" }
    ]
  },
  {
    "type": "body",
    "parameters": [
      { "type": "text", "text": "Jane" },
      { "type": "text", "text": "ORD-12345" },
      { "type": "text", "text": "3-5 business days" }
    ]
  },
  {
    "type": "button",
    "sub_type": "url",
    "index": "0",
    "parameters": [
      { "type": "text", "text": "ORD-12345" }
    ]
  }
]

Sample Configuration

{
  "resource": "message",
  "operation": "sendTemplate",
  "accessToken": "{{ $credentials.whatsAppToken }}",
  "phoneNumberId": "123456789012345",
  "to": "{{ $input.customerPhone }}",
  "templateName": "order_shipped",
  "languageCode": "en_US",
  "componentsJson": "[{\"type\":\"body\",\"parameters\":[{\"type\":\"text\",\"text\":\"{{ $input.customerName }}\"},{\"type\":\"text\",\"text\":\"{{ $input.orderId }}\"},{\"type\":\"text\",\"text\":\"{{ $input.estimatedDelivery }}\"}]}]"
}

Validation Errors

Output

Success Port

Error Port

Sample Output

{
  "messageId": "wamid.HBgLMTQxNTU1NTI2NzEVAgARGBIzQzM4NjhGQTExMjQ3RCMAA",
  "phoneNumberId": "123456789012345",
  "to": "14155552671",
  "status": "sent",
  "errorCode": null,
  "errorMessage": null,
  "rawResponse": "{\"messaging_product\":\"whatsapp\",\"contacts\":[{\"input\":\"14155552671\",\"wa_id\":\"14155552671\"}],\"messages\":[{\"id\":\"wamid.HBgLMTQxNTU1NTI2NzEVAgARGBIzQzM4NjhGQTExMjQ3RCMAA\"}]}"
}

Expression Reference

Node Policies & GuardRails

Examples

Shipping Notification — Order Shipped Template

{
  "resource": "message",
  "operation": "sendTemplate",
  "accessToken": "{{ $credentials.whatsAppToken }}",
  "phoneNumberId": "123456789012345",
  "to": "{{ $input.customerPhone }}",
  "templateName": "order_shipped",
  "languageCode": "en_US",
  "componentsJson": "[{\"type\":\"body\",\"parameters\":[{\"type\":\"text\",\"text\":\"{{ $input.customerName }}\"},{\"type\":\"text\",\"text\":\"{{ $input.orderId }}\"},{\"type\":\"text\",\"text\":\"{{ $input.trackingNumber }}\"},{\"type\":\"text\",\"text\":\"{{ $input.carrier }}\"}]},{\"type\":\"button\",\"sub_type\":\"url\",\"index\":\"0\",\"parameters\":[{\"type\":\"text\",\"text\":\"{{ $input.trackingNumber }}\"}]}]"
}

Triggered by an order management system webhook when a shipping label is created. The template body substitutes the customer name, order ID, tracking number, and carrier. The URL button in the template appends the tracking number to a tracking page URL.

Appointment Reminder — Healthcare Template

{
  "resource": "message",
  "operation": "sendTemplate",
  "accessToken": "{{ $credentials.whatsAppToken }}",
  "phoneNumberId": "123456789012345",
  "to": "{{ $input.patientPhone }}",
  "templateName": "appointment_reminder",
  "languageCode": "en_US",
  "componentsJson": "[{\"type\":\"body\",\"parameters\":[{\"type\":\"text\",\"text\":\"{{ $input.patientName }}\"},{\"type\":\"text\",\"text\":\"{{ $input.doctorName }}\"},{\"type\":\"text\",\"text\":\"{{ $input.appointmentDate }}\"},{\"type\":\"text\",\"text\":\"{{ $input.appointmentTime }}\"}]}]"
}

A ScheduledTrigger fires 48 hours before each appointment. Because this is an outbound proactive notification that may go to patients who have not messaged recently, the template type (UTILITY) ensures delivery compliance. The 24-hour window opens, allowing follow-up messages if the patient replies.

Authentication OTP Template

{
  "resource": "message",
  "operation": "sendTemplate",
  "accessToken": "{{ $credentials.whatsAppToken }}",
  "phoneNumberId": "123456789012345",
  "to": "{{ $input.userPhone }}",
  "templateName": "auth_otp_code",
  "languageCode": "en_US",
  "componentsJson": "[{\"type\":\"body\",\"parameters\":[{\"type\":\"text\",\"text\":\"{{ $input.otpCode }}\"}]},{\"type\":\"button\",\"sub_type\":\"url\",\"index\":\"0\",\"parameters\":[{\"type\":\"text\",\"text\":\"{{ $input.otpCode }}\"}]}]"
}

A AUTHENTICATION category template registered with Meta for OTP delivery. The OTP code is substituted into both the body text and the button URL suffix (which deep-links back into the app). Authentication templates receive the highest delivery priority from Meta.