Αποστολή μηνυμάτων παραγγελιών WhatsApp από το Shopify

Πώς στέλνει το Shopify Flow ένα μήνυμα WhatsApp;

Με την ενέργεια Send HTTP request, η οποία κάνει αίτημα POST σε οποιοδήποτε URL, με headers και σώμα που μπορεί να χρησιμοποιεί μεταβλητές Liquid από το trigger.

Δημιουργήστε ένα workflow με trigger τη δημιουργία παραγγελίας και προσθέστε το Send HTTP request. Το URL είναι το endpoint μηνυμάτων του Cloud API για το phone number id του συνδεδεμένου αριθμού. Προσθέστε ένα header Authorization με τιμή Bearer ακολουθούμενο από το access token του αριθμού, αποθηκευμένο ως Flow secret και αναφερόμενο ως μεταβλητή secret. Οι τιμές των secrets δεν εμφανίζονται ποτέ στη διεπαφή του Flow και αποκρύπτονται από τα αρχεία καταγραφής εκτέλεσης, που είναι το σωστό μέρος για ένα token. Το σώμα είναι ένα μήνυμα template, με τον αριθμό τηλεφώνου του πελάτη στο πεδίο to και τις λεπτομέρειες της παραγγελίας ως παραμέτρους του template.

Το Flow θεωρεί επιτυχία μια απόκριση 2XX ή 3XX. Η Meta απαντά σε ένα έγκυρο αίτημα με το id του μηνύματος, άρα μια επιτυχημένη εκτέλεση σημαίνει ότι η Meta αποδέχτηκε το μήνυμα.

{
  "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}}" }]
    }]
  }
}

Γιατί το μήνυμα παραγγελίας πρέπει να είναι template;

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

Δημιουργήστε το template μία φορά, στην κατηγορία utility για ενημερώσεις παραγγελιών και αποστολών, και περιμένετε την έγκριση πριν ενεργοποιήσετε το workflow. Το όνομα και η γλώσσα στο σώμα του αιτήματος πρέπει να ταυτίζονται ακριβώς με το εγκεκριμένο template, και το πλήθος των παραμέτρων με τα placeholders του.

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

Τι γίνεται αν το πακέτο του καταστήματος δεν περιλαμβάνει το Send HTTP request;

Χρησιμοποιήστε αντί γι' αυτό ένα webhook διαχειριστή του Shopify. Στις Ρυθμίσεις, Ειδοποιήσεις, Webhooks, ο έμπορος μπορεί να δημιουργήσει ένα webhook για ένα συμβάν, όπως η δημιουργία παραγγελίας, σε μορφή JSON, προς ένα URL. Στρέψτε το σε έναν δέκτη: έναν κόμβο Webhook του n8n ή μια διαδρομή σε PHP, Python ή Node. Ο δέκτης διαβάζει την παραγγελία, ελέγχει τη συγκατάθεση και κάνει την ίδια κλήση template στο Cloud API.

Ποια διαδρομή κι αν στείλει το μήνυμα, οι απαντήσεις λειτουργούν το ίδιο. Όταν ο πελάτης απαντήσει στο μήνυμα παραγγελίας, η απάντηση φτάνει στο WhatsApp Business app στο κινητό του καταστήματος, επειδή ο αριθμός είναι σε Coexistence, και το παράθυρο 24 ωρών είναι πλέον ανοιχτό για ελεύθερο κείμενο. Αν έχει οριστεί προορισμός webhook για τον αριθμό, η απάντηση φτάνει και στο σύστημά σας. Το ίδιο το μήνυμα παραγγελίας εμφανίζεται επίσης στο app, ώστε όποιος απαντά να βλέπει σε τι απαντά ο πελάτης.

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

• Αποστολή ελεύθερου κειμένου κατά τη δημιουργία της παραγγελίας. Ο πελάτης δεν έχει γράψει, οπότε η Meta το απορρίπτει· πρέπει να είναι εγκεκριμένο template.
• Η διαχείριση σφαλμάτων έχει μείνει σε Retry για αποκρίσεις 4XX. Το Flow μπορεί να επαναλαμβάνει επί έως και 24 ώρες ένα αίτημα που η Meta δεν θα δεχτεί ποτέ.
• Τοποθέτηση του token σε header ως απλό κείμενο. Αποθηκεύστε το ως Flow secret, ώστε να μένει εκτός διεπαφής και αρχείων καταγραφής.

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

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