On message received

onWhatsAppMessageReceived subscribes the connected WhatsApp Business Account and receives messages for its selected phone number.

automations/watch-whatsapp.automation.ts

import { automation } from "automate.ax"
import { onWhatsAppMessageReceived } from "automate.ax/whatsapp"

export default automation("Watch WhatsApp", () => {
  const received = onWhatsAppMessageReceived()

  received.message.type
  received.sender.id
})

It accepts optional static account, defaulting to the project binding. A signal cannot choose the phone number at runtime. The signal includes businessAccountId, phoneNumberId, displayPhoneNumber, sender ID and profile name, message ID, timestamp, type, typed content, reply context, and providerEvent. Supported message types include text, media, location, contacts, buttons, interactive replies, reactions, orders, system events, and unsupported payloads. Meta retries failed deliveries. Automate.ax verifies the X-Hub-Signature-256 signature and deduplicates messages by provider message ID before orchestration.

Get started

Concepts

Reference