Viber Ειδοποιήσεις - Οδηγός Χρήστη

Για πελάτες CourierHub - πώς λειτουργεί το Viber, πώς γράφεις templates και τι να προσέξεις πριν το pilot.

Περιεχόμενα

1. Viber vs SMS
2. Προϋποθέσεις & Ενεργοποίηση
3. Πώς γράφεις Templates
4. Backfill & Σήμανση «Χρειάζεται έλεγχος»
5. Συχνές Ερωτήσεις
6. Αντιμετώπιση Προβλημάτων

---

1. Viber vs SMS

Χαρακτηριστικό	SMS (GSM7)	Viber (Unicode)
Χαρακτήρες	Κεφαλαία, χωρίς emoji. Καλημέρα → KΑΛHMEPA. Μετρά strlen(GSM7) - 1 SMS 160, 2 SMS 306, >306 χρεώνει επιπλέον SMS.	Κρατά ελληνικά/emoji αυτούσια (UTF-8). Καλημέρα Γιάννη 😊 μένει ως έχει. Όριο ~1000 χαρακτ.
Κόστος	Premium 0.15€ / Economy 0.10€ ανά SMS segment	Viber 0.08€/μήνυμα (αν αποτύχει: fallback Economy SMS)
Deliverability	Υψηλή, εξαρτάται από πάροχο	Υψηλότερη όταν ο παραλήπτης έχει Viber - αλλιώς fallback SMS
Gateway	1 Premium, 3 Economy	2 Viber (με backup 3 Economy)

Διαφορά που βλέπεις στο UI: Το preview SMS μετατρέπει σε GSM7, το Viber preview μένει Unicode. Οι μετρητές δείχνουν GSM7/Unicode αντίστοιχα.

---

2. Προϋποθέσεις & Ενεργοποίηση

1. Sender approval: Ο sender courierhub.gr πρέπει να εγκριθεί από τον πάροχο BulkGate. Αυτό είναι operational - το κάνει ο tech lead, όχι εσύ.
2. Flag ανά πελάτη: Η ρύθμιση customer_settings.send_to_viber (τιμή true) ανά customer_id. Όταν είναι false, το panel Viber εμφανίζεται απενεργοποιημένο (🔒 overlay) και ενημερώνει να επικοινωνήσεις με υποστήριξη.
3. Gateway: Όταν το Viber είναι ενεργό, επιλέγεις Gateway 2 και το σύστημα στέλνει πρώτα Viber· αν αποτύχει, fallback 3.

Ενεργοποίηση: Στείλε αίτημα στην υποστήριξη - δεν ανοίγεις flag μόνος σου, ούτε στέλνεις ενημερωτικά emails. Το pilot/opt-in γίνεται από τον tech lead.

---

3. Πώς γράφεις Templates

Τα templates βρίσκονται στο SMS Templates (/app/sms-templates).

Διαθέσιμα tags:

{voucher_number}   - Αριθμός voucher
{courier_name}     - Όνομα courier
{receiver_name}    - Όνομα παραλήπτη
{sender_name}      - Όνομα αποστολέα (κατάστημα)
{tracking_url}     - URL παρακολούθησης
{delivery_date}    - Ημερομηνία παράδοσης
{cod_amount}       - Ποσό αντικαταβολής
{delivery_address} - Διεύθυνση παράδοσης
[IF_COD]...[/IF_COD] - Κείμενο μόνο όταν υπάρχει αντικαταβολή

Παραδείγματα:

SMS (GSM7):

TO ΔEMA {voucher_number} EINAI KATH ODON ME {courier_name}. TRACK: {tracking_url}

Viber (Unicode):

Γεια σου {receiver_name} 👋 Το δέμα {voucher_number} με {courier_name} είναι καθ' οδόν!
📦 Tracking: {tracking_url}
[IF_COD]💰 Αντικαταβολή: {cod_amount}[/IF_COD]

Συμβουλές:

• Γράψε SMS σύντομα (στόχος ≤160) για να μην χρεώνεσαι 2 SMS.
• Στο Viber εκμεταλλεύσου emoji/ελληνικά - preview δεν τα κόβει.
• Το Viber μήνυμα είναι υποχρεωτικό μόνο όταν το Viber είναι ενεργό (validation required_if).

---

4. Backfill & Σήμανση «Χρειάζεται έλεγχος»

Όταν ενεργοποιήθηκε το Viber rollout, τα παλιά templates που είχαν κενό viber_message συμπληρώθηκαν αυτόματα:

• viber_message = sms_message (raw copy)
• viber_needs_review = true + badge ⚠️ Χρειάζεται έλεγχος στο dropdown και στο header

Τι σημαίνει: Το κείμενο είναι αντιγραφή του SMS (GSM7 style, κεφαλαία). Έλεγξέ το - διόρθωσε ελληνικά/emoji και πάτα Αποθήκευση · η σήμανση φεύγει αυτόματα.

Command (για dev/tech lead, ΠΟΤΕ σε live χωρίς έγκριση):

php artisan viber:backfill --dry-run          # default - μόνο προεπισκόπηση
php artisan viber:backfill --dry-run -v       # λίστα ids
php artisan viber:backfill --execute          # πραγματική εγγραφή (θέλει confirm)
php artisan viber:backfill --customer=42 --execute --force

• Idempotent: ξανατρέξιμο → 0 updated.
• Γράφει μόνο όπου viber_message είναι NULL/κενό.

---

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

Βλέπω το Viber panel απενεργοποιημένο - τι κάνω; Είναι αναμενόμενο αν το flag είναι false. Πάτα τον σύνδεσμο «Οδηγός Viber» ή επικοινώνησε με υποστήριξη. Μην προσπαθήσεις να το ενεργοποιήσεις μόνος.

Ποιο gateway να επιλέξω;

• Θες Viber → 2 (Viber με fallback Economy).
• Θες μόνο SMS → 1 Premium ή 3 Economy.
• Η χρέωση δεν αλλάζει billing logic - Viber sends κάνουν reserve και settle μετά το DLR.

Γιατί το SMS preview δείχνει κεφαλαία; Το SMS μετατρέπεται σε GSM7 για να χωρά σε 1 segment. Το Viber μένει Unicode.

Τι γίνεται αν ο παραλήπτης δεν έχει Viber; Ο πάροχος κάνει fallback σε Economy SMS (gateway 3).

---

6. Αντιμετώπιση Προβλημάτων

• Δεν στάλθηκε Viber: Έλεγξε customer_sms_settings (gateway, token), customer_settings.send_to_viber, balance, και ότι ο sender courierhub.gr είναι approved στο BulkGate.
• Λάθος μήκος: SMS → strlen(GSM7), Viber → mb_strlen(Unicode). Έλεγξε τους μετρητές στο preview.
• Badge δεν φεύγει: Σιγουρέψου ότι αποθήκευσες μετά την επεξεργασία του Viber - το save() καθαρίζει viber_needs_review.

Εκτός scope (operational): επιλογή πιλοτικών πελατών, άναμμα flags σε live, αποστολή ενημερωτικών emails - τα κάνει ο tech lead.

Τελευταία ενημέρωση: Σεπτέμβριος 2026