< woml />
View on GitHub

<whatsapp>

<whatsapp> is a built-in communication tag used as a signed message trigger or template-based notification provider.

Why use it

Use it when Meta WhatsApp messages should admit workflows or carry pre-approved approval and lifecycle templates.

Common use cases

  • Start a workflow from an inbound WhatsApp message.
  • Deliver a template-based approval.
  • Send a lifecycle template with a bounded message parameter.

Syntax

WOML
<whatsapp
  id="customerMessage"
  events="message"
  phone-number-id="123456789012345"
  verify-token="{{secrets.WHATSAPP_VERIFY_TOKEN}}"
  app-secret="{{secrets.WHATSAPP_APP_SECRET}}"
/>

Rules and behavior

  • A trigger accepts only events="message".
  • phone-number-id is Meta's numeric Phone Number ID.
  • verify-token and app-secret are required secret references.
  • WOML exposes /callbacks/whatsapp and verifies X-Hub-Signature-256 over raw bytes.
  • Delivery-status callbacks do not create runs.
  • WhatsApp v1 sends approved templates, not arbitrary proactive free-form text.