WhatsApp In

trigger_whatsapp · trigger · Triggers · Available · v1.0.0

Description

Trigger the workflow when a customer messages your WhatsApp Business number (official Meta Cloud API). One run per incoming message with a fully normalized payload: E.164 sender, profile name, message type (text, interactive button/list reply, image, document, audio, video, sticker, location, reaction), text or caption, media references for Graph API download, and reply context. Fail-closed security on both protocol flows: the GET verification handshake echoes hub.challenge only when the verify token matches (timing-safe), and every POST event is accepted only with a valid X-Hub-Signature-256 HMAC signature. Automatic per-message-id dedup (Meta re-delivers unacknowledged events). Pair with the WhatsApp send node for a full conversational bot: replies fall inside the 24-hour customer-service window, so free-form text needs no pre-approved template.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`verifyToken` Verify token (handshake Meta)	`string (encrypted)`	yes	—	Stringa segreta che SCEGLI TU (es. generata random) e incolli identica nel campo "Verify token" del pannello Meta Business → WhatsApp → Configurazione → Webhook. Meta la rimanda nel GET di verifica: se non combacia, l'handshake fallisce e il webhook non si attiva.
`appSecret` App Secret (verifica firma)	`string (encrypted)`	yes	—	App Secret dell'app Meta (Business → Impostazioni app → Di base → App secret). Serve a verificare la firma X-Hub-Signature-256 di OGNI evento: senza firma valida la richiesta è respinta con 401. NON è l'Access Token (quello va nel nodo WhatsApp di invio).
`phoneNumberIdFilter` Filtro Phone Number ID (opzionale)	`string`	no	— 1234567890123456	Se l'app Meta gestisce PIÙ numeri WhatsApp, processa solo gli eventi di questo Phone Number ID (l'ID numerico del pannello Meta, non il numero di telefono). Vuoto = accetta gli eventi di qualsiasi numero dell'app.
`includeStatuses` Avvia anche per status update	`boolean`	no	`false`	Se on: il workflow parte anche per gli status dei messaggi INVIATI (sent, delivered, read, failed) con kind="status". Default off: solo i messaggi in arrivo dei clienti (gli status di consegna sono rumore per un bot conversazionale).

⬆️ Node output

Fields available to downstream nodes via $node.<alias>.json.<field>:

messageId
from
profileName
phoneNumberId
displayPhoneNumber
timestamp
type
text
interactive
media
location
replyToMessageId
kind
raw

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-trigger_whatsapp-1",
  "defId": "trigger_whatsapp",
  "label": "WhatsApp In",
  "config": {
    "verifyToken": "<verifyToken>",
    "appSecret": "<appSecret>",
    "includeStatuses": false
  }
}

🔗 Related nodes in the same category

Ready to use WhatsApp In?

Available now on all FlowForge plans. Try it free without a credit card.

Start free Browse all nodes