Οδηγός WooCommerce SMS
Ρύθμιση SMS provider, credentials, sender, message templates, voucher notification, COD filter και debug log.
Οδηγός εγκατάστασης και ρύθμισης WooCommerce SMS
Ο οδηγός καλύπτει την εγκατάσταση, όλες τις ρυθμίσεις, τη δοκιμή και τα συχνά προβλήματα του plugin OBS Woocommerce SMS. Η OBS κάνει τη ρύθμιση δωρεάν, αν το προτιμάτε.
1. Προαπαιτούμενα
- WordPress 5.8+, PHP 7.4+, WooCommerce 5.0+.
- Ενεργός λογαριασμός σε SMSAPI, Apifon ή Bulker, με υπόλοιπο.
- Credentials από τον provider: API Key (SMSAPI), API Key + API Token (Apifon), auth_key (Bulker).
- Εγκεκριμένο Sender Name στον provider (έως 20 χαρακτήρες, κατά προτίμηση λατινικοί).
- Αν θέλετε tracking στα SMS: ένα συμβατό courier plugin που αποθηκεύει τον αριθμό voucher στην παραγγελία.
2. Εγκατάσταση
- Κατεβάστε το ZIP από τον λογαριασμό σας στην OBS Technologies.
- WordPress → Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου → επιλέξτε το ZIP → Εγκατάσταση → Ενεργοποίηση.
- Ανοίξτε WooCommerce → Ρυθμίσεις → Integration → Integration OBS SMS. Θα βρείτε επίσης το link «Settings» στη λίστα πρόσθετων.
3. Χάρτης ρυθμίσεων
| Πεδίο | Τι κάνει |
|---|---|
| Enable | Γενική ενεργοποίηση της αποστολής SMS. |
| SMS Provider | SMSAPI, Apifon ή Bulker. |
| API Key | Το API Key του provider. Για Bulker, το auth_key. Εμφανίζεται μασκαρισμένο. Αν το αφήσετε κενό ή όπως είναι, κρατιέται το αποθηκευμένο. |
| Clear API Key | Διαγράφει ρητά το αποθηκευμένο API Key. |
| API Token (Reqd only for apifon) | Απαιτείται μόνο για Apifon. |
| Clear API Token | Διαγράφει ρητά το αποθηκευμένο API Token. |
| Sender Name | Ο αποστολέας που βλέπει ο πελάτης. Πρέπει να είναι εγκεκριμένος στον provider. Κόβεται στους 20 χαρακτήρες. |
| Message for New Order | Στέλνεται όταν η παραγγελία περνά σε Processing. Κενό = απενεργοποιημένο. |
| Message for Change in Order Status | Στέλνεται σε Pending και On hold. Δέχεται {old_status} και {new_status}. |
| Message on Voucher Creation | Στέλνεται όταν αποθηκευτεί αριθμός voucher από courier plugin. Δέχεται {voucher_code}, {tracking_number}, {tracking_url}, {courier_name}. |
| Message for Store Pickup Order | Στέλνεται στην ολοκλήρωση παραγγελιών με «Παραλαβή από το κατάστημα». |
| Message for Complete Order | Στέλνεται όταν η παραγγελία γίνει Completed. |
| Type of Order — Enable only for COD Orders | Τα SMS στέλνονται μόνο σε παραγγελίες με αντικαταβολή. |
| Debug Log — Enable logging | Καταγραφή στο WooCommerce → Κατάσταση → Logs (πηγή obs-woo-sms). Ενεργοποιήστε το μόνο για troubleshooting. |
Placeholders (λειτουργούν σε όλα τα πρότυπα): {first_name}, {last_name}, {order_number}, {order_total}, {old_status}, {new_status}, {voucher_code}, {tracking_number}, {tracking_url}, {courier_name}, και το μπλοκ {if_cod}…{endif_cod} για κείμενο μόνο στην αντικαταβολή.
Παράδειγμα για τη δημιουργία voucher: Η παραγγελία σας {order_number} στάλθηκε με {courier_name}. Παρακολούθηση: {tracking_url}{if_cod} Ποσό αντικαταβολής: {order_total}€{endif_cod}
4. Δοκιμή
- Ενεργοποιήστε προσωρινά το Debug Log.
- Κάντε δοκιμαστική παραγγελία με δικό σας ελληνικό κινητό στο τηλέφωνο χρέωσης.
- Αλλάξτε την κατάσταση σε Processing, μετά σε On hold και τέλος σε Completed. Ελέγξτε ότι κάθε SMS φτάνει μία φορά.
- Εκδώστε voucher με το courier plugin. Ελέγξτε ότι το SMS περιέχει τον σωστό αριθμό και ότι το link ανοίγει τη σελίδα tracking της courier.
- Αν δέχεστε αντικαταβολή, επαναλάβετε με παραγγελία COD για να ελέγξετε το μπλοκ {if_cod}.
- Ελέγξτε τη χρέωση στον λογαριασμό του provider. Τα ελληνικά και τα μεγάλα μηνύματα μπορεί να χρεωθούν ως περισσότερα από ένα SMS.
5. Go-live checklist
- Εγκεκριμένο Sender Name και επαρκές υπόλοιπο στον provider.
- Συμπληρωμένα μόνο τα πρότυπα που θέλετε. Τα κενά πρότυπα δεν στέλνουν.
- Σωστή ρύθμιση «Enable only for COD Orders» για τη ροή σας.
- Επιτυχής δοκιμή για κάθε γεγονός που χρησιμοποιείτε.
- Απενεργοποιημένο Debug Log μετά τη δοκιμή.
- Ενημερωμένη πολιτική απορρήτου για την αποστολή ενημερωτικών SMS.
6. Αντιμετώπιση προβλημάτων
| Σύμπτωμα | Πιθανή αιτία | Λύση |
|---|---|---|
| Δεν φεύγει κανένα SMS | Το Enable είναι κλειστό, λάθος credentials ή μηδενικό υπόλοιπο στον provider | Ελέγξτε Enable, SMS Provider και API Key/Token και δείτε το υπόλοιπο στον provider. Ενεργοποιήστε το Debug Log και επαναλάβετε. |
| Δεν στέλνεται SMS για νέα παραγγελία με τραπεζική κατάθεση | Το μήνυμα νέας παραγγελίας στέλνεται στο Processing. Η κατάθεση μένει σε On hold. | Για On hold στέλνεται το «Message for Change in Order Status». Συμπληρώστε το. |
| Το SMS έχει κενό αριθμό voucher ή link | Το courier plugin δεν έχει αποθηκεύσει voucher ή χρησιμοποιεί meta key που δεν αναγνωρίζεται | Ελέγξτε ότι το voucher εμφανίζεται στην παραγγελία. Αν χρησιμοποιείτε άλλο courier plugin, επικοινωνήστε μαζί μας για το meta key. |
| Δεν στέλνονται SMS σε παραγγελίες με κάρτα | Είναι ενεργό το «Enable only for COD Orders» | Απενεργοποιήστε την επιλογή, αν θέλετε SMS σε όλες τις παραγγελίες. |
| Ο πελάτης παίρνει πολλά SMS για την ίδια παραγγελία | Συμπληρωμένα πρότυπα για διαδοχικές καταστάσεις | Κρατήστε μόνο τα απαραίτητα. Το SMS voucher έχει προστασία διπλής αποστολής, τα μηνύματα κατάστασης δεν έχουν. |
| Το SMS αναφέρει λάθος courier | Σταθερό όνομα courier γραμμένο μέσα στο πρότυπο | Χρησιμοποιήστε το placeholder {courier_name}, που συμπληρώνεται από το voucher. |
| Ένα μήνυμα χρεώνεται ως 2–3 SMS | Ελληνικοί χαρακτήρες (λιγότεροι χαρακτήρες ανά SMS) και μεγάλο κείμενο ή link | Συντομεύστε το πρότυπο ή γράψτε το με λατινικούς χαρακτήρες. |
| Το κείμενο εμφανίζεται διπλό μέσα στο ίδιο SMS | Παλαιότερη έκδοση ή επανάληψη κειμένου στο πρότυπο | Ελέγξτε το πρότυπο και ενημερώστε στην τελευταία έκδοση. |
| Δεν βρίσκω τις ρυθμίσεις | Το plugin δεν έχει δικό του μενού | WooCommerce → Ρυθμίσεις → Integration → Integration OBS SMS, ή το link «Settings» στη λίστα πρόσθετων. |
| Σταμάτησαν τα SMS μετά από ενημέρωση και ο provider ήταν Yuboto | Η αποστολή μέσω Yuboto δεν είναι διαθέσιμη στην τρέχουσα έκδοση | Επιλέξτε SMSAPI, Apifon ή Bulker, ή επικοινωνήστε μαζί μας. |
| Το Sender Name εμφανίζεται διαφορετικό ή απορρίπτεται | Το όνομα δεν είναι εγκεκριμένο στον provider | Ζητήστε έγκριση από τον provider και χρησιμοποιήστε ακριβώς το εγκεκριμένο όνομα. |
Βήματα εγκατάστασης
-
Βήμα 1
Provider
Επιλέγουμε τον συμβατικό provider και περνάμε τα ιδιωτικά credentials.
-
Βήμα 2
Sender
Ορίζουμε μόνο sender name που έχει εγκριθεί από τον provider.
-
Βήμα 3
Templates
Γράφουμε ξεχωριστό, σύντομο μήνυμα για κάθε order event που θα χρησιμοποιηθεί.
-
Βήμα 4
Filters
Ορίζουμε αν τα SMS περιορίζονται σε COD orders και κρατάμε debug κλειστό εκτός troubleshooting.
-
Βήμα 5
Controlled test
Τρέχουμε μία ελεγχόμενη παραγγελία και επιβεβαιώνουμε ότι κάθε event στέλνεται μία φορά.
Συχνές ερωτήσεις
Ποιον provider υποστηρίζει;
Οι διαθέσιμες επιλογές είναι smsapi, apifon, yuboto και bulker. Η λειτουργία εξαρτάται από ενεργό λογαριασμό και σωστά credentials στον επιλεγμένο provider.
Πότε χρειάζεται API Token;
Η οθόνη το χαρακτηρίζει ως απαραίτητο μόνο για Apifon.
Μπορεί να στείλει tracking όταν δημιουργηθεί voucher;
Υπάρχει ξεχωριστό Message on Voucher Creation και η πραγματική αποστολή ελέγχεται με το courier meta που γράφει το αντίστοιχο plugin.