Αποστολή ενημερώσεων παραγγελιών WooCommerce μέσω WhatsApp

Πώς μια παραγγελία WooCommerce ενεργοποιεί ένα μήνυμα WhatsApp;

Μέσω ενός webhook του WooCommerce και ενός δέκτη. Στο WooCommerce, από τις Ρυθμίσεις, Για προχωρημένους, Webhooks, προσθέστε ένα webhook με θέμα παραγγελίας, όπως δημιουργία ή ενημέρωση παραγγελίας, ένα URL παράδοσης και ένα secret. Το WooCommerce στέλνει τότε την παραγγελία ως JSON σε αυτό το URL κάθε φορά που συμβαίνει το γεγονός.

Το payload είναι σταθερό, οπότε δεν μπορεί να κατευθυνθεί απευθείας στο Cloud API. Ανάμεσα παρεμβάλλεται ένας δέκτης: ένας κόμβος Webhook του n8n, μια διαδρομή στο PHP του ίδιου του καταστήματος ή οποιαδήποτε μικρή υπηρεσία. Διαβάζει την παραγγελία, επιλέγει τον αριθμό τηλεφώνου του πελάτη και τις λεπτομέρειες που χρειάζεται το μήνυμα, και κάνει ένα αίτημα HTTPS στο endpoint μηνυμάτων του Cloud API για τον συνδεδεμένο αριθμό, με το access token του αριθμού ως bearer token.

Το θέμα order.updated δεν συνδέεται με μία συγκεκριμένη κατάσταση, επομένως ο δέκτης πρέπει να διαβάζει το πεδίο status της παραγγελίας και να στέλνει μία φορά για κάθε μετάβαση που τον ενδιαφέρει. Το WooCommerce κάνει την παράδοση στο παρασκήνιο μέσω wp-cron από προεπιλογή, οπότε το μήνυμα μπορεί να ακολουθεί την παραγγελία με μικρή καθυστέρηση.

Πώς ξέρει ο δέκτης ότι το αίτημα προήλθε από το κατάστημα;

Από την υπογραφή του WooCommerce. Κάθε παράδοση φέρει μια κεφαλίδα X-WC-Webhook-Signature, ένα HMAC-SHA256 του ακατέργαστου payload σε κωδικοποίηση base64, που υπολογίζεται με το secret που ορίσατε στο webhook. Ο δέκτης υπολογίζει το ίδιο hash πάνω στο σώμα που έλαβε, το συγκρίνει και απορρίπτει ό,τι δεν ταιριάζει.

Εδώ πρόκειται για το δικό σας secret του καταστήματος, οπότε, σε αντίθεση με την υπογραφή της Meta στα εισερχόμενα μηνύματα WhatsApp, μπορεί να επικυρωθεί. Κάντε τη σύγκριση σε σταθερό χρόνο και υπολογίστε το hash στο ακατέργαστο σώμα πριν το αναλύσει οποιοδήποτε framework, επειδή το JSON που έχει κωδικοποιηθεί ξανά δίνει διαφορετικό hash.

Απαντήστε γρήγορα με 2xx. Το WooCommerce θεωρεί αποτυχία κάθε απόκριση που δεν είναι 2xx, 301 ή 302, και μετά από περισσότερες από πέντε διαδοχικές αποτυχίες απενεργοποιεί το webhook. Ένας δέκτης που είναι εκτός λειτουργίας λόγω deploy, ή αργεί επειδή περιμένει τη Meta πριν απαντήσει, μπορεί να κλείσει τα μηνύματα του καταστήματος χωρίς να το πάρει κανείς είδηση.

Τι μπορεί να στείλει το κατάστημα και πότε;

Ένα εγκεκριμένο template, κάθε φορά που το κατάστημα γράφει πρώτο. Το παράθυρο εξυπηρέτησης πελάτη 24 ωρών της Meta ανοίγει μόνο όταν ο πελάτης στείλει μήνυμα στον αριθμό, οπότε μια επιβεβαίωση παραγγελίας ή μια ενημέρωση αποστολής ξεκινά από την επιχείρηση και το ελεύθερο κείμενο απορρίπτεται. Δημιουργήστε ένα template κατηγορίας utility για κάθε ενημέρωση, περιμένετε την έγκριση και στείλτε το με όνομα και γλώσσα, με τον αριθμό παραγγελίας και τις υπόλοιπες λεπτομέρειες ως παραμέτρους.

Η Meta απαιτεί επίσης opt-in: ο πελάτης έδωσε τον αριθμό του και συμφώνησε να ενημερώνεται από αυτή την επιχείρηση στο WhatsApp. Ένα πλαίσιο επιλογής στο ταμείο, αποθηκευμένο στην παραγγελία, είναι η απλούστερη καταγραφή, και ο δέκτης πρέπει να το ελέγχει πριν στείλει.

Μόλις ο πελάτης απαντήσει, η συνομιλία είναι συνηθισμένο Coexistence. Η απάντηση εμφανίζεται στο WhatsApp Business app στο τηλέφωνο του καταστήματος, το παράθυρο είναι ανοιχτό για ελεύθερο κείμενο και η ομάδα απαντά από την εφαρμογή όπως πάντα.

Συνηθισμένα λάθη

• Κλήση του Cloud API πριν απαντήσετε στο WooCommerce. Μια αργή ή αποτυχημένη αποστολή προσμετράται εις βάρος του webhook, το οποίο απενεργοποιείται μετά από περισσότερες από πέντε αποτυχίες.
• Υπολογισμός του hash στο αναλυμένο JSON αντί για το ακατέργαστο σώμα. Η υπογραφή δεν ταιριάζει ποτέ και κάθε γνήσια παράδοση απορρίπτεται.
• Αποστολή σε κάθε παράδοση order.updated. Το θέμα δεν συνδέεται με μία κατάσταση, οπότε αν δεν καταγράφετε ποια μετάβαση έχει ήδη ειδοποιηθεί, οι πελάτες λαμβάνουν διπλά μηνύματα.

Συχνές ερωτήσεις

Συνεχίστε την ανάγνωση