User Guide – SMS Center Tracking

Ο οδηγός εξηγεί πώς ο διαχειριστής ρυθμίζει και χρησιμοποιεί το module για αποστολή SMS tracking ενημερώσεων σε OpenMage / Magento 1 μέσω SMS Center.

Admin path

System -> Configuration -> Ioweb -> SMS Center Tracking

Πριν ξεκινήσετε

1. Επιβεβαιώστε ότι είναι εγκατεστημένο το IOWEB Base extension.
2. Επιβεβαιώστε ότι υπάρχει ενεργός λογαριασμός SMS Center.
3. Πάρτε το SMS Center API key.
4. Ελέγξτε ότι οι παραγγελίες έχουν σωστά τηλέφωνα στη shipping address.
5. Ετοιμάστε μία test παραγγελία με shipment και tracking number.

Information section

Developed By
Read-only σύνδεσμος προς IOWEB.

Description
Read-only περιγραφή του module.

Installation ID
Αναγνωριστικό εγκατάστασης για υποστήριξη. Χρησιμοποιείται όταν επικοινωνείτε με την IOWEB για τεχνικό έλεγχο. Αποθηκεύεται σε default scope.

General section

Enable SMS Tracking
Ενεργοποιεί ή απενεργοποιεί την αποστολή SMS tracking για το επιλεγμένο configuration scope. Ρυθμίστε το σε Yes αφού ελεγχθούν API key, sender name, message template και test shipment.

API Key
Το SMS Center API key που χρησιμοποιείται για έλεγχο τηλεφώνου και αποστολή SMS.

Sender Name
Το όνομα αποστολέα που εμφανίζεται στα εξερχόμενα SMS, σύμφωνα με τους κανόνες του SMS Center λογαριασμού.

Message
Το SMS template που χρησιμοποιείται όταν το shipment έχει tracking number. Το module μορφοποιεί το template με PHP sprintf() και περνάει τις τιμές με αυτή τη σειρά:

1. order increment ID
2. carrier title
3. tracking number

Προτεινόμενο template:

Order %s was shipped with %s. Tracking number: %s

Μπορείτε να χρησιμοποιήσετε positional placeholders αν θέλετε άλλη σειρά:

Tracking number %3$s for order %1$s via %2$s

Shipment SMS flow

1. Ο διαχειριστής ή κάποιο integration δημιουργεί/αποθηκεύει Magento shipment.
2. Το module διαβάζει το shipment ID.
3. Φορτώνει το πρώτο tracking record του shipment.
4. Διαβάζει το order increment ID της παραγγελίας.
5. Δημιουργεί το SMS με order number, carrier title και tracking number.
6. Διαβάζει το τηλέφωνο της shipping address.
7. Ελέγχει το τηλέφωνο μέσω SMS Center mobile validation.
8. Στέλνει το SMS μέσω SMS Center API.
9. Προσθέτει την απάντηση του SMS Center ή το validation result στα Magento order comments.

Testing checklist

1. Ενεργοποιήστε το module σε staging ή σε ελεγχόμενο test window.
2. Συμπληρώστε API key και sender name.
3. Ορίστε σύντομο message template με τα τρία placeholders.
4. Δημιουργήστε test παραγγελία με έγκυρο shipping telephone.
5. Δημιουργήστε shipment και προσθέστε tracking number.
6. Αποθηκεύστε το shipment.
7. Επιβεβαιώστε ότι το SMS παραλήφθηκε.
8. Ανοίξτε την παραγγελία και ελέγξτε τα order comments για την απάντηση SMS Center.
9. Ελέγξτε το var/log/sms.log αν το Magento logging είναι ενεργό.

Store scope notes

Οι General ρυθμίσεις είναι διαθέσιμες σε default, website και store scope. Ρυθμίστε τις στο scope που αντιστοιχεί στις παραγγελίες που δοκιμάζετε. Το Installation ID αποθηκεύεται μόνο σε default scope.

Troubleshooting

• Αν δεν αποστέλλεται SMS, ελέγξτε enablement, API key, sender name, tracking number, shipping telephone και σύνδεση server προς smscenter.gr.
• Αν το μήνυμα έχει κενές τιμές, ελέγξτε το template και τα shipment tracking fields.
• Αν ο πελάτης δεν λαμβάνει SMS, ελέγξτε μορφή τηλεφώνου, SMS Center account status, order comments και var/log/sms.log.
• Αν δεν εμφανίζεται το configuration page, ελέγξτε ότι το module είναι active, υπάρχει το IOWEB Base, καθαρίστηκε cache και έγινε logout/login στο admin.