Automazione dello stato degli ordini su WhatsApp
Un'automazione dello stato degli ordini su WhatsApp risponde a "dov'è il mio ordine?" con dati in tempo reale dal sistema dello store. Un passaggio per parole chiave intercetta la domanda, un webhook invia il messaggio e il numero di telefono del cliente al backend dello store, e il backend restituisce lo stato come risposta. Gli aggiornamenti sulla spedizione che lo store invia per primo partono come template di utilità approvati.
easyCoexistence collega il numero WhatsApp Business che il tuo store già usa nell'app alla Cloud API di Meta tramite Coexistence.
Tempo che il backend dello store ha per restituire una risposta prima che il passaggio webhook fallisca e ti arrivi un'e-mail.
Il numero WhatsApp del cliente in cifre internazionali, inviato con il messaggio così il backend può trovare gli ordini tramite il telefono.
La risposta più lunga inviata come un unico testo WhatsApp; tutto ciò che supera il limite viene tagliato.
La categoria Meta per conferme d'ordine e avvisi di spedizione: non promozionale e specifica per l'ordine del cliente.
Meta considera marketing un template che abbina un aggiornamento d'ordine a una promozione.
Il ritmo massimo fisso di Meta per un numero Coexistence, il limite per un picco di aggiornamenti di spedizione.
Come funziona una risposta automatica sullo stato dell'ordine?
Lo stato si trova nel sistema del tuo store, quindi il compito dell'automazione è portare la domanda fin lì e riportare indietro la risposta. Un'automazione per parole chiave intercetta le domande sugli ordini, il suo passaggio Call my webhook le invia al tuo backend, e la risposta del backend parte dal tuo numero WhatsApp Business. easyCoexistence non conserva dati sugli ordini: il registro delle esecuzioni tiene il messaggio e la risposta per 30 giorni, e il tuo store resta la fonte di verità. La stessa ricerca può essere anche un passaggio Call an API, che chiama direttamente l'API del tuo store e conserva la sua risposta JSON per i passaggi successivi.
Quali messaggi devono avviare la ricerca?
Le domande sugli ordini si riconoscono facilmente dalle parole, quindi un'automazione per parole chiave è la scelta giusta. Parti da Send to my system e cambia il suo trigger in Has keyword con Contains, oppure parti da Keyword reply e sostituisci il passaggio con Call my webhook. Aggiungi le parole in ogni lingua in cui vendi, fino a 30. Le altre domande passano alle restanti automazioni, per esempio un agente su Every message, perché le automazioni per parole chiave vengono controllate per prime e una sola automazione risponde a ogni messaggio.
- Inglese: order, tracking, delivery, shipped, where is my.
- Portoghese: pedido, rastreio, rastreamento, entrega, encomenda.
- Spagnolo: envío, envio, seguimiento, paquete (pedido ed entrega sono già inseriti).
- Simboli: # intercetta i numeri d'ordine scritti come #1042.
Cosa riceve il backend dello store e cosa deve restituire?
Una POST JSON firmata in X-EC-Signature con il Signing secret dell'automazione. I campi che contano per una ricerca sono contact.wa_id, il numero WhatsApp del cliente in cifre internazionali senza il segno più, e message.text, dove può comparire un numero d'ordine. Trova gli ordini più recenti per quel telefono, oppure ricava il numero dal testo, e rispondi con HTTP 200 e un corpo JSON il cui campo reply contiene il testo da inviare. Mantieni la risposta semplice e breve: fino a 4.096 caratteri vanno inviati come un unico messaggio, e titoli o link markdown compaiono come simboli grezzi.
Request (trimmed):
{
"event": "automation.step",
"dry_run": false,
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "type": "text", "text": "Hi, where is my order #1042?" },
"history": [ … up to 10 recent messages, oldest first … ]
}
Response, HTTP 200, within 20 seconds:
{ "reply": "Hi Ana! Order #1042 left our warehouse today and should arrive by Friday. Tracking: https://track.example/1042" }Cosa deve dire il backend quando non trova l'ordine?
Qualcosa di utile in ogni caso. Una sola automazione risponde a ogni messaggio, e un passaggio posto dopo il webhook verrebbe eseguito anche dopo una risposta riuscita, quindi anche i testi di riserva li gestisce il backend (con un passaggio Call an API al posto del webhook, un passaggio Split into paths può ramificarsi in base alla risposta):
- Ordine trovato: lo stato, la data prevista e il link di tracciamento.
- Nessun ordine per questo telefono: chiedi il numero d'ordine o l'e-mail usata al checkout.
- Più ordini aperti: elencali brevemente e chiedi quale.
- Pacco smarrito o danneggiato: dì che una persona risponderà in questa chat e avvisa il tuo team.
- Un test, con
dry_runtrue: restituisci una risposta di esempio e non modifichi nulla. - Backend non disponibile o più lento di 20 secondi: il passaggio fallisce, non viene inviato nulla e un'e-mail te lo segnala così puoi rispondere tu.
Come si inviano gli aggiornamenti di spedizione prima che il cliente chieda?
Gli aggiornamenti proattivi sono messaggi avviati dalla tua azienda, quindi partono come template approvati, inviati dal sistema del tuo store tramite la Cloud API quando un ordine cambia stato. Creali nella categoria utility, quella che Meta usa per le conferme d'ordine e gli avvisi di spedizione: uno sconto o un suggerimento di prodotto nello stesso template lo trasforma in marketing. La tua AI può preparare e inviare i template con create_template, usando {{1}} per il nome e {{2}} per il numero d'ordine con valori di esempio, e controllare l'approvazione con get_template_status. Lo store poi chiama l'endpoint di invio ottenuto da get_api_credentials sui propri eventi d'ordine, oppure invia una richiesta all'URL di un'automazione con il trigger Your system calls a URL (l'esempio Updates from your system), che invia il template con i dettagli dell'ordine presi da {{vars.webhook.*}}; le pagine Shopify e WooCommerce mostrano il collegamento. Meta addebita ogni messaggio template in base alla categoria e al paese, sul tuo WhatsApp Business Account.
Cosa succede quando un cliente risponde a un aggiornamento di spedizione?
La sua risposta apre una nuova finestra di 24 ore, e le tue automazioni la gestiscono come qualsiasi messaggio in arrivo: una risposta per parole chiave, la ricerca dell'ordine o l'assistente AI. C'è un dettaglio importante. Un cliente la cui chat non ha uno storico recente viene contato come un primo messaggio, quindi un'automazione First message può salutare chi sta solo rispondendo al tuo avviso di spedizione; formula il benvenuto in modo che funzioni bene anche dopo un aggiornamento. Su un numero Coexistence il template inviato dallo store resta nel thread della chat dell'app, così il team vede il contesto prima di intervenire.
Come configurarlo
- Expose an order lookupAdd an HTTPS endpoint, or an n8n workflow, that verifies X-EC-Signature, finds orders by contact.wa_id or the number in message.text and returns {"reply": "..."}.
- Create the automation, switched OffStart from Send to my system, change the trigger to Has keyword, add your order words, paste the URL into Webhook URL, set the switch to Off and click Save.
- Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's configuration.
- Test with Run testClick Test and send "where is my order #1042?" in Try it. Your endpoint receives dry_run true and the sample contact 15550000000.
- Switch it On, then add shipping templatesSwitch the automation On and save, then create utility templates for confirmed, shipped and delivered orders, sent by your store.
Errori comuni
- Restituire lo stato con un altro nome di campo. Viene inviato solo un campo stringa di primo livello chiamato reply; tutto il resto viene registrato come nessuna risposta e il cliente non riceve nulla.
- Confrontare contact.wa_id con i telefoni digitati così come sono al checkout. wa_id contiene il prefisso internazionale e nessun segno più, spazio o trattino; confronta solo le cifre.
- Aggiungere un passaggio Reply with text dopo il webhook come riserva. Viene eseguito anche dopo una risposta riuscita, quindi il cliente riceve due messaggi; restituisci il testo di riserva dal backend.
- Inserire un coupon nel template di spedizione. Meta considera il contenuto misto come marketing e può ricategorizzarlo o rifiutarlo; tieni le offerte in template marketing separati.
Il suo passaggio Call my webhook porta le domande sugli ordini al tuo backend e riporta indietro la risposta, con firma, limite di 20 secondi ed e-mail in caso di errore, e get_api_credentials fornisce al tuo store ciò che serve per inviare i template di spedizione. Le automazioni non hanno costi aggiuntivi. Da US$ 9 a US$ 0,75 per numero al mese, con il prezzo che scende man mano che aggiungi numeri, e i primi 3 giorni di prova gratuita.
Domande frequenti
Un passaggio AI può rispondere alle domande sugli ordini invece di una parola chiave?
Sì. Un agente AI con uno strumento personalizzato, un URL con parametri come il numero d'ordine e header facoltativi, può cercare l'ordine da solo, oppure il modello può stare dietro il webhook, per esempio un nodo n8n AI Agent con uno strumento di ricerca ordini che restituisce il suo testo come reply. Un passaggio Reply with AI da solo legge solo le sue istruzioni e la chat, quindi non ha dati sugli ordini in tempo reale.
E se il cliente invia l'ordine come foto o messaggio vocale?
Una foto arriva come [image] seguita dalla sua didascalia, quindi una parola chiave corrisponde solo se la didascalia contiene la parola, anche se un agente AI può guardare l'immagine con la tua chiave. Un messaggio vocale viene trascritto con la tua chiave OpenAI o OpenRouter e salvato come [voice message] seguito dalle parole, che una parola chiave può riconoscere; senza una tale chiave resta [voice message]. Fai chiedere all'AI o a una risposta fissa il numero d'ordine in forma di testo.
L'automazione può inviare la fattura o un'etichetta di spedizione in PDF?
Sì, dal tuo backend: invia il documento tramite la Cloud API con le credenziali del numero, entro 24 ore dall'ultimo messaggio del cliente, e restituisci una breve risposta che dice che il file è in arrivo. La risposta del webhook, di suo, contiene solo testo. Un file fisso, come un listino prezzi, può partire dal passaggio Send a picture or file.
Quante domande sugli ordini può gestire contemporaneamente?
Le esecuzioni sono indipendenti, quindi più clienti possono chiedere nello stesso momento. easyCoexistence distribuisce gli invii, al massimo 10 al secondo per numero, sotto i 20 al secondo di Meta per Coexistence, e il tuo backend deve solo rispondere a una POST entro 20 secondi.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il