Invia messaggi d'ordine WhatsApp da Shopify

Come invia un messaggio WhatsApp Shopify Flow?

Con l'azione Send HTTP request, che esegue un POST verso qualsiasi URL con header e body che possono usare le variabili Liquid del trigger.

Crea un workflow sul trigger di creazione dell'ordine e aggiungi Send HTTP request. L'URL è l'endpoint dei messaggi della Cloud API per il phone number id del numero connesso. Aggiungi un header Authorization il cui valore è Bearer seguito dal token di accesso del numero, salvato come secret di Flow e richiamato come variabile secret. I valori dei secret non compaiono mai nell'interfaccia di Flow e vengono oscurati nei log delle esecuzioni, ed è lì che un token deve stare. Il body è un messaggio template, con il numero di telefono del cliente nel campo to e i dettagli dell'ordine come parametri del template.

Flow considera una risposta 2XX o 3XX come un successo. Meta risponde a una richiesta valida con l'id del messaggio, quindi un'esecuzione riuscita significa che Meta ha accettato il messaggio.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

Perché un messaggio d'ordine deve essere un template?

Perché è il negozio a scrivere per primo. La finestra di assistenza clienti di 24 ore di Meta si apre solo quando il cliente scrive al numero. Una conferma d'ordine, un aggiornamento di spedizione o un promemoria di carrello abbandonato vengono inviati prima, quindi il testo libero viene rifiutato e passa solo un template approvato in anticipo.

Crea il template una sola volta, nella categoria utility per gli aggiornamenti di ordini e spedizioni, e attendi l'approvazione prima di attivare il workflow. Il nome e la lingua nel body della richiesta devono coincidere esattamente con il template approvato, e il numero di parametri deve corrispondere ai suoi segnaposto.

C'è poi il consenso. Meta richiede l'opt-in prima che un'azienda scriva a qualcuno su WhatsApp: la persona ha fornito il proprio numero e ha accettato di ricevere messaggi da quell'azienda. Una casella al checkout che lo dichiara è il modo più comune per raccoglierlo, e il workflow dovrebbe verificarla prima dell'invio.

Cosa fare se il piano del negozio non include Send HTTP request?

Usa invece un webhook admin di Shopify. In Impostazioni, Notifiche, Webhook, un merchant può creare un webhook per un evento come la creazione di un ordine, in JSON, verso un URL. Puntalo a un ricevitore: un nodo Webhook di n8n, oppure una route in PHP, Python o Node. Il ricevitore legge l'ordine, verifica il consenso ed esegue la stessa chiamata template verso la Cloud API.

Che sia l'uno o l'altro a inviare, le risposte funzionano allo stesso modo. Quando il cliente risponde al messaggio d'ordine, la risposta arriva nell'app WhatsApp Business sul telefono del negozio, perché il numero è in Coexistence, e la finestra di 24 ore è ora aperta al testo libero. Se per il numero è impostata una destinazione webhook, la risposta raggiunge anche il tuo sistema. Anche il messaggio d'ordine compare nell'app, così chi risponde vede a cosa sta rispondendo il cliente.

Errori comuni

• Inviare testo libero alla creazione dell'ordine. Il cliente non ha scritto, quindi Meta lo rifiuta: deve essere un template approvato.
• Lasciare la gestione degli errori su Retry per le risposte 4XX. Flow può riprovare fino a 24 ore una richiesta che Meta non accetterà mai.
• Mettere il token in un header come testo semplice. Salvalo come secret di Flow, così resta fuori dall'interfaccia e dai log.

Domande frequenti

Continua a leggere