Καλύψτε SMS, κλήσεις, WhatsApp και email με ακριβείς ονομασίες συμβάντων.
WEBHOOK V2 · Κάθε γεγονός από κινητό, παραδίδεται στο λογισμικό σας
Μετατρέψτε κάθε γεγονός από τη συνδεδεμένη κινητή συσκευή σε άμεση ενέργεια.
SMSMobileAPI Webhook V2 στέλνει δομημένα γεγονότα HTTPS στις εφαρμογές σας όταν ένα SMS υποβληθεί, αποσταλεί, αποτύχει ή ληφθεί, όταν μια κλήση κινητού είναι αναπάντητη, εισερχόμενη ή εξερχόμενη, και όταν συμβαίνει υποστηριζόμενη δραστηριότητα WhatsApp ή email. Διαμορφώστε τα πάντα οπτικά από τον πίνακα ελέγχου σας — δεν απαιτείται βρόχος polling.
Διαβάστε την τεκμηρίωση του APIΕπιλέξτε τα γεγονότα που λαμβάνει κάθε προορισμός. Δοκιμάστε, παύστε, παρακολουθήστε και ανανεώστε το μυστικό υπογραφής του από έναν χώρο εργασίας.
Στείλτε διαφορετικές ομάδες συμβάντων σε διαφορετικούς προορισμούς HTTPS.
Επαληθεύστε κάθε αίτημα χρησιμοποιώντας την υπογραφή HMAC-SHA256 και τη χρονική του σήμανση.
Οι προσωρινές αποτυχίες προορισμού επαναπροσπαθούνται χωρίς να εμποδίζουν άλλους λογαριασμούς.
Πώς λειτουργεί το Webhook V2
Από ένα πραγματικό γεγονός κινητού προς την εφαρμογή σας σε τρία σαφή βήματα.
Η συνδεδεμένη κινητή σας συσκευή και οι υπηρεσίες SMSMobileAPI παράγουν λειτουργικά γεγονότα. Webhook V2 τοποθετεί κάθε επιλέξιμο γεγονός σε μια ανθεκτική ουρά παράδοσης και στέλνει ένα υπογεγραμμένο φορτίο JSON στο HTTPS URL που επιλέξατε.
- 1
Συμβαίνει ένα γεγονός
Υποβάλλεται ένα μήνυμα, μια κινητή συσκευή στέλνει ή λαμβάνει ένα SMS, μια κλήση αλλάζει κατάσταση, ή καταγράφεται υποστηριζόμενη δραστηριότητα WhatsApp και email.
- 2
Webhook V2 το δρομολογεί
SMSMobileAPI δημιουργεί ένα σταθερό αναγνωριστικό συμβάντος και θέτει σε ουρά παράδοσης μόνο για προορισμούς που έχουν εγγραφεί σε αυτόν τον τύπο συμβάντος.
- 3
Το λογισμικό σας αντιδρά
Το δημόσιο endpoint HTTPS σας επαληθεύει την υπογραφή, αποθηκεύει το αναγνωριστικό συμβάντος και ξεκινά τη ροή εργασίας CRM, υποστήριξης, ειδοποιήσεων ή αυτοματοποίησης.
15 ακριβείς τύποι συμβάντων
Εγγραφείτε μόνο στα γεγονότα κινητού που χρειάζεται η ροή εργασίας σας.
Ένας προορισμός μπορεί να λαμβάνει τα πάντα, ή μπορείτε να διαχωρίσετε συστήματα παραγωγής, αναλύσεις και επιχειρησιακές ειδοποιήσεις. Κάθε γεγονός έχει ακριβές όνομα ώστε η εφαρμογή σας να το διαχειρίζεται προβλέψιμα.
SMS
5sms.api.submittedSMS υποβλήθηκε μέσω API
Ένα αίτημα API δημιούργησε μια εργασία αποστολής SMS. Χρήσιμο για να επιβεβαιώσετε ότι το αίτημα εισήλθε στην πλατφόρμα.
sms.sentSMS αποστάλθηκε
Το συνδεδεμένο κινητό επιβεβαίωσε την αποστολή SMS.
sms.failedSMS απέτυχε
Το συνδεδεμένο κινητό επέστρεψε σφάλμα αποστολής SMS.
sms.receivedSMS λήφθηκε
Ένα συνδεδεμένο κινητό συγχρόνισε ένα εισερχόμενο SMS.
sms.mobile.sentSMS αποστέλθηκε από κινητό
Ένα SMS στάλθηκε χειροκίνητα από το συνδεδεμένο κινητό.
Κλήσεις
3call.missedΑναπάντητη κλήση
Μια αναπάντητη κλήση συγχρονίστηκε από ένα συνδεδεμένο κινητό.
call.incomingΕισερχόμενη κλήση
Μια εισερχόμενη κλήση συγχρονίστηκε από ένα συνδεδεμένο κινητό.
call.outgoingΕξερχόμενη κλήση
Μια εξερχόμενη κλήση συγχρονίστηκε από ένα συνδεδεμένο κινητό.
whatsapp.submittedWhatsApp υποβλήθηκε
Δημιουργήθηκε εργασία αποστολής WhatsApp.
whatsapp.sentWhatsApp στάλθηκε
Το συνδεδεμένο περιβάλλον WhatsApp επιβεβαίωσε ότι το μήνυμα στάλθηκε.
whatsapp.failedWhatsApp απέτυχε
Η λειτουργία αποστολής WhatsApp απέτυχε.
whatsapp.receivedWhatsApp λήφθηκε
Ένα μήνυμα WhatsApp ανακτήθηκε αφού ο λογαριασμός ζήτησε συγχρονισμό.
whatsapp.voice.transcribedΦωνητικό μήνυμα μεταγράφηκε
Ένα επιλέξιμο WhatsApp φωνητικό μήνυμα που ανακτήθηκε μετατράπηκε σε κείμενο.
Ηλεκτρονικό ταχυδρομείο
2email.sentEmail αποστάλθηκε
Μια αίτηση αποστολής email δημιουργήθηκε από το SMSMobileAPI.
email.receivedEmail λήφθηκε
Ένας συνδεδεμένος λογαριασμός email έλαβε ένα μήνυμα.
Διαμορφώστε τα πάντα οπτικά
Επαγγελματική διαχείριση webhook χωρίς επεξεργασία αρχείων ρυθμίσεων.
Ανοίξτε το Webhook V2 στον πίνακα ελέγχου SMSMobileAPI, προσθέστε ένα όνομα προορισμού και δημόσιο HTTPS URL, επιλέξτε τα συμβάντα και αποθηκεύστε. Ο πίνακας ελέγχου παρέχει τα στοιχεία ελέγχου που χρειάζεστε για την καθημερινή λειτουργία και την αντιμετώπιση προβλημάτων.
Πολλαπλοί προορισμοί
Δημιουργήστε αφιερωμένους προορισμούς για το CRM, την παρακολούθηση, την ανάλυση ή τις εφαρμογές πελατών σας.
Φίλτρα συμβάντων
Επιλέξτε ακριβώς ποια SMS, κλήσεων, WhatsApp και email συμβάντα θα λαμβάνει κάθε URL.
Δοκιμή παράδοσης
Στείλτε ένα ελεγχόμενο δοκιμαστικό συμβάν πριν βασιστείτε στον προορισμό σε παραγωγή.
Παύση και επανενεργοποίηση
Σταματήστε έναν προορισμό άμεσα χωρίς να διαγράψετε τη διαμόρφωσή του.
Ανανέωση μυστικού
Δημιουργήστε ένα νέο μυστικό υπογραφής όταν το απαιτεί η διαδικασία ασφαλείας σας.
Δραστηριότητα παράδοσης
Ελέγξτε τις παραδόσεις στην ουρά, τις παραδοθείσες, τις σε επαναπροσπάθεια και τις αποτυχημένες, με πληροφορίες για τις προσπάθειες και την κατάσταση HTTP.
https://crm.example.com/hooks/mobileΕνεργόsms.receivedcall.missedwhatsapp.received
https://ops.example.com/eventsΕνεργόsms.failedwhatsapp.failed
Αξιοπιστία από το σχεδιασμό
Σχεδιασμένο για αξιόπιστη, ανεξάρτητη παράδοση.
Η παράδοση webhook είναι ασύγχρονη. Το mobile workflow σας δεν περιμένει να απαντήσει ένας τρίτος URL, και ένας προορισμός που αποτυγχάνει δεν μπλοκάρει άλλον πελάτη ή προορισμό.
Ανθεκτική ουρά
Τα επιλέξιμα συμβάντα αποθηκεύονται πριν την παράδοση, ώστε η προσωρινή διακοπή του παραλήπτη να μην διαγράφει το συμβάν.
Παράδοση τουλάχιστον μία φορά
Μια παράδοση μπορεί να επαναληφθεί. Αποθηκεύστε το αναγνωριστικό συμβάντος και επεξεργαστείτε το μόνο μία φορά στην εφαρμογή σας.
Προοδευτικές επαναπροσπάθειες
Οι προσωρινές αποτυχίες επαναπροσεγγίζονται με αυξανόμενες καθυστερήσεις, έως το όριο επαναπροσπάθειας της πλατφόρμας.
Απομόνωση αποτυχιών
Ένα αργό ή μη διαθέσιμο endpoint δεν μπορεί να σταματήσει την παράδοση σε μη σχετικούς προορισμούς.
Αυτόματη προστασία
Ένας προορισμός με παρατεταμένες αποτυχίες μπορεί να τεθεί σε παύση για να προστατευτεί η ουρά και η υποδομή σας.
Λειτουργική ορατότητα
Ο πίνακας ελέγχου και η παρακολούθηση webmaster αποκαλύπτουν την κατάσταση της ουράς, τα αποτελέσματα και τα πρόσφατα σφάλματα παράδοσης.
Υπογεγραμμένο και επαληθεύσιμο
Επαληθεύστε το αίτημα πριν εμπιστευτείτε το συμβάν.
Κάθε παράδοση περιλαμβάνει χρονική σήμανση, αναγνωριστικό παράδοσης, τύπο συμβάντος, σταθερό idempotency key και HMAC-SHA256 υπογραφή. Κρατήστε το μυστικό υπογραφής στον διακομιστή σας, υπολογίστε την υπογραφή από το ακατέργαστο σώμα του αιτήματος και απορρίψτε άκυρα ή παρωχημένα αιτήματα.
X-SMSMobileAPI-EventΟ τύπος συμβάντος, π.χ. sms.received.X-SMSMobileAPI-DeliveryΤο μοναδικό αναγνωριστικό παράδοσης για αυτόν τον προορισμό.X-SMSMobileAPI-TimestampΧρονική σήμανση Unix που χρησιμοποιείται κατά την επαλήθευση της υπογραφής.X-SMSMobileAPI-SignatureHMAC-SHA256 υπογραφή για ασφαλή σύγκριση.Idempotency-KeyΣταθερό UUID συμβάντος που χρησιμοποιείται για την αποτροπή διπλής επεξεργασίας.Συνεπές περίβλημα συμβάντος
Ένα συνεπές JSON περίβλημα για κάθε κανάλι.
Το περίβλημα παραμένει προβλέψιμο σε SMS, κλήσεις, WhatsApp και email. Το αντικείμενο δεδομένων περιέχει τα πεδία που σχετίζονται με τον τύπο συμβάντος, ενώ τα κορυφαία αναγνωριστικά σας επιτρέπουν να δρομολογείτε και να αποτρέπετε διπλή επεξεργασία κάθε παράδοσης.
id— σταθερό αναγνωριστικό συμβάντοςtype— ακριβής τύπος συμβάντοςoccurred_at— πότε συνέβη η δραστηριότηταdata— πληροφορίες ανά κανάλι
{
"id": "whv2_01J...",
"type": "sms.received",
"api_version": "2026-09-22",
"created_at": "2026-09-22T12:00:00Z",
"occurred_at": "2026-09-22T11:59:58Z",
"data": {
"guid": "...",
"from": "+32...",
"message": "Can you call me back?"
}
}Από το συμβάν στο επιχειρηματικό αποτέλεσμα
Κάντε την κινητή επικοινωνία να πυροδοτεί την επόμενη επιχειρηματική ενέργεια.
Συνομιλίες CRM
Προσθέστε ένα ληφθέν μήνυμα SMS ή WhatsApp στη σωστή επαφή και ειδοποιήστε τον ανατεθειμένο υπεύθυνο.
Ανάκτηση χαμένης κλήσης
Δημιουργήστε εργασία επανακλήσης, στείλτε ένα επακόλουθο SMS ή ειδοποιήστε την ομάδα εφημερίας μετά από μια χαμένη κλήση.
Υποστήριξη πελατών
Άνοιγμα ή ενημέρωση αιτήματος υποστήριξης όταν ο πελάτης απαντά από το κινητό του.
Λειτουργίες ηλεκτρονικού εμπορίου
Ενημέρωση ροών επικοινωνίας παραγγελιών αφού ένα μήνυμα από κινητό αποσταλεί, επιβεβαιωθεί ή αποτύχει.
Παρακολούθηση και ειδοποιήσεις
Αποστολή αποτυχιών παράδοσης ή ασυνήθιστης δραστηριότητας κλήσεων στα εργαλεία παρατηρησιμότητας και διαχείρισης περιστατικών.
Ροές εργασίας για AI και δεδομένα
Τροφοδοτήστε εξουσιοδοτημένα συμβάντα σε ροές ταξινόμησης, αναφορών ή υποστήριξης χωρίς να ερωτάτε επανειλημμένα το API.
Σταματήστε τον επαναλαμβανόμενο έλεγχο για αλλαγές
Ο επαναλαμβανόμενος έλεγχος στέλνει επαναλαμβανόμενα αιτήματα. Οι webhooks ειδοποιούν το λογισμικό σας όταν κάτι αλλάζει.
Ο επαναλαμβανόμενος έλεγχος καταναλώνει αιτήματα ακόμα και όταν δεν συνέβη κάτι και προσθέτει καθυστέρηση μεταξύ των ελέγχων. Το Webhook V2 προωθεί το σχετικό συμβάν στο endpoint σας, κάνοντας την αυτοματοποίηση πιο γρήγορη, απλή και ευκολότερη στην κλιμάκωση.
Συχνές ερωτήσεις — Webhook V2
Ερωτήσεις πριν συνδέσετε το endpoint σας.
Χρειάζεται να δημιουργήσω βρόχο επαναλαμβανόμενου ελέγχου;+
Όχι. Το Webhook V2 στέλνει τα εγγεγραμμένα συμβάντα στο δημόσιο endpoint HTTPS σας. Μπορείτε να χρησιμοποιείτε τις API όταν χρειάζεστε να ερωτήσετε ιστορικό ή λεπτομέρειες.
Μπορώ να ρυθμίσω πολλαπλά URL webhook;+
Ναι. Μπορείτε να δημιουργήσετε πολλαπλούς προορισμούς και να επιλέξετε διαφορετικό σύνολο συμβάντων για κάθε έναν, εντός των ορίων του λογαριασμού που εμφανίζονται στον πίνακα ελέγχου.
Πώς ξέρω ότι ένα SMS στάλθηκε πραγματικά;+
Χρησιμοποιήστε sms.api.submitted για να γνωρίζετε ότι η εργασία δημιουργήθηκε και sms.sent για την επιβεβαίωση που αναφέρθηκε από το συνδεδεμένο κινητό. Αντιμετωπίστε τα ως δύο διαφορετικά λειτουργικά στάδια.
Μπορεί ένα webhook να παραδοθεί περισσότερες από μία φορές;+
Ναι. Το Webhook V2 χρησιμοποιεί παράδοση τύπου at-least-once. Αποθηκεύστε το σταθερό ID συμβάντος ή το Idempotency-Key και αγνοήστε παράδοση που έχετε ήδη επεξεργαστεί.
Τι πρέπει να επιστρέψει το endpoint μου;+
Επιστρέψτε μια HTTP 2xx απάντηση αφού αποδεχτείτε με ασφάλεια το συμβάν. Η επεξεργασία μπορεί να συνεχιστεί ασύγχρονα εντός της εφαρμογής σας.
Συλλέγονται συνεχώς τα ληφθέντα WhatsApp συμβάντα;+
Όχι. Η ανάκτηση ληφθέντων μηνυμάτων WhatsApp ακολουθεί τη δική της διαδικασία συγχρονισμού βάσει συγκατάθεσης. Το γεγονός whatsapp.received είναι διαθέσιμο αφού ανακτηθεί ένα επιλέξιμο μήνυμα.
Τα συμβάντα του κινητού σας. Το λογισμικό σας. Οι ενέργειές σας.
Συνδέστε το λογισμικό σας με τη δραστηριότητα του πραγματικού σας κινητού τώρα.
Δημιουργήστε τον λογαριασμό σας ή συνδεθείτε, ανοίξτε το Webhook V2, προσθέστε έναν δημόσιο προορισμό HTTPS και επιλέξτε τα συμβάντα που έχουν σημασία για τη ροή εργασίας σας. Στείλτε ένα δοκιμαστικό συμβάν, επαληθεύστε την υπογραφή του και ενεργοποιήστε την ενσωμάτωσή σας.
