Callbacks Αναφορών Παράδοσης (Webhooks) & Επαλήθευση Υπογραφής

Τα Callbacks Αναφορών Παράδοσης (Webhooks) επιτρέπουν στο Rayo SMS να ενημερώνει αυτόματα τον server σας σε πραγματικό χρόνο κάθε φορά που αλλάζει η κατάσταση παράδοσης (Delivery Report / DLR) ενός απεσταλμένου μηνύματος SMS.

Για πλήρεις τεχνικές προδιαγραφές των παραμέτρων του payload, συμβουλευτείτε την Πλήρης Τεκμηρίωση Rayo SMS API (https://sms-api-docs.rayo.gr).

Ρύθμιση Callback URL & Μεθόδου HTTP

Η διαχείριση των Webhooks πραγματοποιείται από το μενού Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Callbacks (Ρυθμίσεις Callbacks):

Καθορισμός Callback URL Εισαγάγετε το πλήρες URL του endpoint στον server σας (π.χ. https://example.com/webhooks/rayo-dlr) που θα υποδέχεται τις αναφορές παράδοσης.
Επιλογή Μεθόδου HTTP (get ή post) Επιλέξτε την επιθυμητή μέθοδο HTTP:
- post: Αποστέλλει τα δεδομένα της αναφοράς παράδοσης στο σώμα του αιτήματος (συνιστάται).
- get: Αποστέλλει τις παραμέτρους της αναφοράς παράδοσης ως query parameters στο URL.
Δοκιμή με το Κουμπί Έλεγχος (Test) Πριν αποθηκεύσετε τις ρυθμίσεις σας, πατήστε το κουμπί Έλεγχος (Test). Το Rayo SMS θα στείλει αμέσως ένα δοκιμαστικό αίτημα στο URL σας και θα επιβεβαιώσει ότι ο server σας απαντά επιτυχώς (HTTP 2xx).
Αποθήκευση ή Απενεργοποίηση
- Πατήστε Αποθήκευση για να ενεργοποιήσετε την αποστολή των Callbacks.
- Εάν επιθυμείτε να σταματήσετε τη λήψη Webhooks και να καθαρίσετε τις ρυθμίσεις, πατήστε Διαγραφή και Απενεργοποίηση.

Ασφάλεια Webhook & Επαλήθευση Υπογραφής (`Signing Secret`)

Για να είστε βέβαιοι ότι κάθε αίτημα Callback προέρχεται αυθεντικά από το Rayo SMS και δεν έχει αλλοιωθεί κατά τη μεταφορά, κάθε λογαριασμός διαθέτει μια μοναδική Κρυφή Λέξη (Signing Secret) στη σελίδα Callbacks.

Κάθε HTTP αίτημα που αποστέλλει το Rayo SMS προς το Callback URL σας περιλαμβάνει την κεφαλίδα (header) υπογραφής:
- Κεφαλίδα Υπογραφής: Rayo-SMS-Signature
Ο server σας πρέπει να υπολογίζει την αναμενόμενη υπογραφή HMAC χρησιμοποιώντας την Κρυφή Λέξη (Signing Secret) σας και να τη συγκρίνει (με constant-time σύγκριση) με την τιμή της κεφαλίδας Rayo-SMS-Signature πριν επεξεργαστεί την αναφορά παράδοσης.

Εναλλαγή Κρυφής Λέξης Χωρίς Διακοπή Λειτουργίας (Zero-Downtime Rotation)

Εάν χρειαστεί να αντικαταστήσετε την Κρυφή Λέξη σας (π.χ. στο πλαίσιο περιοδικής πολιτικής ασφαλείας), το Rayo SMS υποστηρίζει εναλλαγή χωρίς καμία απώλεια Webhooks (zero-downtime rotation):

Έναρξη Ακύρωσης (Ακύρωση Κρυφής Λέξης) Στη σελίδα Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Callbacks, πατήστε Ακύρωση Κρυφής Λέξης (Expire Signing Secret).
Περίοδος Χάριτος & Νέα Κρυφή Λέξη Το σύστημα δημιουργεί αμέσως μια νέα Κρυφή Λέξη, ενώ διατηρεί την παλιά σε ισχύ για μια μεταβατική περίοδο χάριτος. Κατά τη διάρκεια αυτής της περιόδου, μπορείτε να ενημερώσετε τον κώδικα/διαμόρφωση του server σας με τη νέα κρυφή λέξη χωρίς να απορρίπτονται τα εισερχόμενα Callbacks.
Αναίρεση Ακύρωσης (Προαιρετικά) Εάν αλλάξετε γνώμη πριν λήξει η περίοδος χάριτος της προηγούμενης κρυφής λέξης, μπορείτε να πατήσετε Μην Ακυρώσεις την Κρυφή Λέξη ώστε να ακυρώσετε τη διαδικασία λήξης.

Σχετικοί Οδηγοί

Επισκόπηση API & Διαχείριση Κλειδιών APIΔείτε τα endpoints του REST API και πώς να διαχειριστείτε τα Κλειδιά API σας.

Ιστορικό & Αναφορές ΠαράδοσηςΠαρακολουθήστε τις καταστάσεις παράδοσης των SMS και μέσα από το περιβάλλον της εφαρμογής.