Eventi WhatsApp che guidano i tuoi flussi di lavoro su n8n.

I webhook firmati di Flowella avviano i flussi di lavoro di n8n tramite il trigger Webhook proprio di n8n, mentre il nodo “Richiesta HTTP” invia i modelli WhatsApp tramite l’API di Flowella.

Inizia gratuitamente Riferimento API
  • Funziona oggiTramite l'API di Flowella e i webhook
  • ProssimamenteUn nodo Flowella per n8n
Flo, la mascotte di Flowella, collega un cavo all’ultimo dei tre nodi colorati per unirli tra loro

Attiva un evento, segui il payload.

Ecco un flusso di lavoro n8n, disegnato nello stile di Flowella. Scegli un evento di esempio e invialo, poi seguilo di nodo in nodo: il nodo Switch instrada ogni evento, mentre un nodo Richiesta HTTP avvisa il tuo team, aggiorna la tua mailing list o invia un modello WhatsApp tramite l’API di Flowella. Seleziona un nodo qualsiasi per vedere esattamente cosa ha ricevuto o inviato.

Flo indica una delle tre frecce del cartello, proprio come un ramo del flusso di lavoro sceglie un percorso
Solo i nodi di n8n
Esempio di evento
Acme ClubConto aziendale
Dati di esempio

Oggi

Ciao Ada, la tua iscrizione all’Acme Club scade il 31 ottobre. Rispondi qui se hai domande.
Eventi Flowellaflusso di lavoro n8n
Dati di esempio

Cosa ha pubblicato Flowella sul webhook Dati di esempio

POST/webhook/flowella-events

Content-Type
application/json
X-Flowella-Signature
Viene firmato quando si verifica un evento

Invia un evento per visualizzare i post di Flowella qui.

POST/webhook/flowella-events

Content-Type
application/json
X-Flowella-Signature
5d2c9f1a…e19a
{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "message.received",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "messageId": "clsamplemsg00000000000043",
    "conversationId": "clsampleconv0000000000007",
    "contactId": "clsamplecontact0000000003",
    "direction": "INBOUND",
    "type": "TEXT",
    "metaMessageId": "wamid.sample00000000000043"
  }
}

POST/webhook/flowella-events

Content-Type
application/json
X-Flowella-Signature
5d2c9f1a…e19a
{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "optout.created",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "contactId": "clsamplecontact0000000003",
    "conversationId": "clsampleconv0000000000007",
    "phone": "+447700900123",
    "reason": "USER_KEYWORD"
  }
}

POST/webhook/flowella-events

Content-Type
application/json
X-Flowella-Signature
5d2c9f1a…e19a
{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "template.status_updated",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "metaTemplateId": "1234567890123456",
    "templateName": "autumn_fair_invite",
    "status": "APPROVED",
    "language": "en_GB"
  }
}

Ogni consegna ha la stessa busta, e i campi specifici dell’evento si trovano nella sua ultima chiave: id type created_at payload_version data

Prima di procedere, verifica l'X-Flowella-Signature: si tratta di un digest esadecimale HMAC-SHA256 del corpo del messaggio non elaborato, generato con la tua chiave segreta di firma.

Switch: per ogni evento viene applicata la prima regola le cui condizioni sono tutte soddisfatte

Questo evento: Non ancora verificato type: message.received data.type: TEXT type: optout.created type: template.status_updated data.status: APPROVED

  1. Avvisare il team {{ $json.body.type }} è uguale a message.received {{ $json.body.data.type }} è uguale a TEXT
  2. Aggiornare la mailing list {{ $json.body.type }} è uguale a optout.created
  3. Invia la campagna {{ $json.body.type }} è uguale a template.status_updated {{ $json.body.data.status }} è uguale a APPROVED

In attesa di un evento.

La regola 1 è soddisfatta, quindi l'evento procede con l'invio di un avviso alla squadra.

La regola 2 viene soddisfatta, quindi l'evento procede all'aggiornamento della mailing list.

La regola 3 è soddisfatta, quindi l'evento passa alla fase "Invia la campagna".

Lo Switch inoltra l'evento senza modificarlo, in modo che anche il nodo successivo possa leggere $json.body.

Cosa ha inviato il nodo “Richiesta HTTP” Dati di esempio

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type
application/json

Questo nodo viene eseguito solo quando la regola 1 viene soddisfatta.

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type
application/json

conversationId da {{ $json.body.data.conversationId }}contactId da {{ $json.body.data.contactId }}

{
  "conversationId": "clsampleconv0000000000007",
  "contactId": "clsamplecontact0000000003"
}
200 OK

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type
application/json

Non eseguito. Lo Switch ha inviato questo evento a un'altra uscita.

L'evento contiene gli ID, non la risposta vera e propria, quindi il tuo team apre la conversazione nella casella di posta in arrivo di Flowella e risponde da lì.

Cosa ha inviato il nodo “Richiesta HTTP” Dati di esempio

POSThttps://lists.example.com/v1/unsubscribes

Content-Type
application/json

Questo nodo viene eseguito solo quando la regola 2 viene soddisfatta.

POSThttps://lists.example.com/v1/unsubscribes

Content-Type
application/json

phone da {{ $json.body.data.phone }}reason da {{ $json.body.data.reason }}

{
  "phone": "+447700900123",
  "reason": "USER_KEYWORD"
}
200 OK

POSThttps://lists.example.com/v1/unsubscribes

Content-Type
application/json

Non eseguito. Lo Switch ha inviato questo evento a un'altra uscita.

"optout.created" è l'evento che contiene un numero di telefono, in modo che anche gli altri tuoi strumenti possano smettere di inviarle messaggi.

Cosa ha inviato il nodo “Richiesta HTTP” Dati di esempio

POSThttps://api.flowella.io/v1/templates/send

Authorization
Bearer flo_(nascosta)Dalle tue credenziali n8n
Content-Type
application/json

Questo nodo viene eseguito solo quando la regola 3 viene soddisfatta.

POSThttps://api.flowella.io/v1/templates/send

Authorization
Bearer flo_(nascosta)Dalle tue credenziali n8n
Content-Type
application/json
Idempotency-Key
6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10

templateId da {{ $json.body.data.metaTemplateId }}Idempotency-Key da {{ $json.body.id }}, quindi una consegna riprovata non viene mai inviata due volterecipients dall'elenco dei membri gestito da n8n

{
  "templateId": "1234567890123456",
  "whatsappChannelId": "clsamplechannel0000000001",
  "recipients": [
    { "phone": "+447700900123", "bodyParameters": ["Ada"] },
    { "phone": "+447700900456", "bodyParameters": ["Ben"] }
  ]
}
202 Accepted{ "id": "v1ts-0123456789abcdef", "status": "accepted" }

POSThttps://api.flowella.io/v1/templates/send

Authorization
Bearer flo_(nascosta)Dalle tue credenziali n8n
Content-Type
application/json

Non eseguito. Lo Switch ha inviato questo evento a un'altra uscita.

Conserva la chiave API in una credenziale n8n, mai nel flusso di lavoro stesso. Il codice di stato "202 Accepted" indica che Flowella ha messo in coda l'invio e lo sta effettuando in background.

Configuralo in tre passaggi.

È necessario disporre di un account Flowella collegato a WhatsApp, di un modello approvato da Meta e di un flusso di lavoro n8n. Quindi:

  1. Passo 1: Aggiungi un trigger Webhook

    Avvia il flusso di lavoro con il nodo Webhook di n8n, impostalo su POST e copia il suo URL di produzione.

    Nodo WebhookDati di esempio
    Metodo
    POST
    Percorso
    flowella-events
    URL
    https://n8n.example.com/webhook/flowella-events
    Ascolto
    Webhook in uscita

  2. Passo 2: Iscriviti su Flowella

    In Impostazioni → Webhook, aggiungi quell'URL, seleziona gli eventi desiderati e salva il segreto di firma. L'opzione "Invia test" attiva un evento "webhook.test". È necessario disporre del ruolo di Proprietario o Amministratore.

    WebhookDati di esempio
    Endpoint
    https://n8n.example.com/webhook/flowella-events
    Eventi
    message.received, optout.created, template.status_updated
    Segreto di firma
    Salvato
    Test inviato
    Impostazioni dei webhook

  3. Passo 3: Invia indietro tramite richiesta HTTP

    Aggiungi un nodo "Richiesta HTTP" che invii una richiesta POST all'indirizzo /v1/templates/send, inserendo la tua chiave API Flowella nelle credenziali dell'intestazione.

    Nodo "Richiesta HTTP"Dati di esempio
    Metodo
    POST
    URL
    https://api.flowella.io/v1/templates/send
    Credenziale
    Header: Authorization
    202 Accettato
    Riferimento API

Cosa funziona oggi e cosa ci aspetta in futuro.

Tutto quanto sopra funziona grazie all'API di Flowella e ai webhook, già disponibili. A breve sarà disponibile un nodo Flowella per n8n.

Prossimamente

Un nodo Flowella per n8n

Quando sarà pronto, pubblicheremo qui le istruzioni su come funziona. Fino ad allora, il trigger Webhook e il nodo Richiesta HTTP di n8n svolgono egregiamente il loro compito.

Buono a sapersi

  • Controlla la firmaOgni richiesta contiene il campo “X-Flowella-Signature”, un digest esadecimale HMAC-SHA256 del corpo della richiesta non elaborato. Verificalo prima di procedere. Durante la rotazione della chiave segreta, il campo “X-Flowella-Signature-Previous” contiene anche la firma della chiave precedente.
  • Rispondi entro 10 secondiFlowella attende fino a 10 secondi per un codice di stato 2xx e tenta la consegna al massimo 3 volte, a intervalli di 1 e 2 secondi. Rispondi prima, poi esegui eventuali operazioni che richiedono più tempo.
  • Sono previste replicheUna consegna ripetuta presenta lo stesso ID busta, quindi conserva gli ID che hai già gestito e considera la ripetizione come un'operazione nulla.
  • ID, non paroleIl campo message.received contiene gli ID, la direzione e il tipo di messaggio, ma mai il testo. Il tuo team legge e risponde alle risposte nella casella di posta in arrivo di Flowella.
Inizia gratuitamente

Disponibile da oggi Funziona oggi

Compatibile con qualsiasi strumento in grado di inviare e ricevere richieste HTTP, n8n compreso.

Eventi webhook a cui puoi iscriverti oggi stesso

  • message.received
  • message.sent
  • message.delivered
  • message.read
  • message.failed
  • conversation.opened
  • conversation.closed
  • optout.created
  • template.status_updated
  • contact.created
  • contact.updated
  • contact.deleted

Inoltre, c'è webhook.test, che Send test attiva su richiesta.

Flo che salta di gioia con il pugno alzato e il cellulare in mano

Inizia a creare con Flowella e n8n.

Tutto ciò che è presente in questa pagina funziona oggi grazie all’API di Flowella e ai webhook. Prenota una demo di 30 minuti su Teams e analizzeremo insieme i tuoi flussi di lavoro.

Prenota una demo Riferimento API
Visualizza tutte le integrazioni