action_whatsapp_send · action · Utility · Disponibile · v1.0.0

Descrizione

Invia un messaggio WhatsApp via Meta Cloud API (Graph). Due modalita`: text (richiede finestra cliente aperta 24h — risposta a messaggi ricevuti) oppure template (qualsiasi momento, richiede template approvato in WhatsApp Business Manager). Output: { messageId, recipient, mode, response }.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`phoneNumberId` Phone Number ID (Meta)	`string`	si	— 1234567890123456	NON e` il tuo numero di telefono. E` l'ID NUMERICO che trovi nel pannello Meta Business → WhatsApp → Configurazione API. Composto da soli numeri.
`accessToken` Access Token (permanente)	`string (encrypted)`	si	—	Token di accesso permanente da Meta Business → Sistema Users → genera token con permesso whatsapp_business_messaging. Bypassa scadenza, da custodire come segreto.
`apiVersion` Versione API Graph	`enum` `v18.0v19.0v20.0v21.0`	no	`v20.0`	Default v20.0. Cambia solo se Meta annuncia una deprecation.
`recipient` Destinatario (numero E.164)	`expression`	si	— +39 333 1234567 oppure {{input.phone}}	Numero di telefono del destinatario in formato E.164. Spazi/trattini/parentesi vengono rimossi automaticamente. Il `+` opzionale.
`mode` Modalita`	`enum` `texttemplate`	si	`text`	text = messaggio di testo libero. RICHIEDE che il cliente ti abbia scritto negli ultimi 24h (regola Meta). template = template pre-approvato in WhatsApp Business Manager. Funziona SEMPRE — l'unico modo per iniziare una nuova conversazione.
`body` Testo messaggio	`expression`	no	— Buongiorno {{input.nome}}, abbiamo ricevuto la sua PEC.	Testo del messaggio. Max 4096 caratteri. Supporta {{espressioni}}.
`previewUrl` Anteprime link automatiche	`boolean`	no	`false`	Se on, WhatsApp genera anteprime per i link nel body. Default off (UX piu` pulita + niente costo extra per la preview).
`templateName` Nome template	`string`	no	— pec_ricevuta_consegna	Nome esatto del template come approvato in WhatsApp Business Manager. Case-sensitive. Solo template "APPROVED" funzionano (PENDING / REJECTED danno errore).
`languageCode` Codice lingua	`string`	no	`it` it oppure en_US	Codice lingua del template. Deve combaciare ESATTAMENTE con quello scelto in WhatsApp Business Manager. Formato xx oppure xx_XX.
`componentsJson` Components (JSON array)	`code`	no	— [{"type":"body","parameters":[{"type":"text","text":"{{input.nome}}"},{"type":"text","text":"{{$today}}"}]}]	Array di components per popolare le variabili del template (placeholder {{1}}, {{2}}, ecc). Tipi parametro: text, currency, date_time, image, document, video. Vuoto = nessuna variabile (template fissi). Per dettagli: https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages
`timeoutMs` Timeout HTTP (ms)	`number`	no	`15000`	Range 1000-60000. Meta tipicamente risponde < 1s.
`includePipelineLog` Includi log nell'output	`boolean`	no	`true`	—

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-action_whatsapp_send-1",
  "defId": "action_whatsapp_send",
  "label": "WhatsApp",
  "config": {
    "phoneNumberId": "1234567890123456",
    "accessToken": "<accessToken>",
    "apiVersion": "v20.0",
    "recipient": "+39 333 1234567   oppure   {{input.phone}}",
    "mode": "text",
    "previewUrl": false,
    "languageCode": "it",
    "timeoutMs": 15000,
    "includePipelineLog": true
  }
}

🔗 Nodi correlati nella stessa categoria

Pronto a usare WhatsApp?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi