Wednesday, 13 April 2022 04:05

Octapush Webhooks – Ενημέρωση εξωτερικών CRM/ERP συστημάτων με POST ή GET

Τα Webhooks είναι HTTP callbacks που μπορεί ο χρήστης να ορίσει στο Octapush με σκοπό την ενημέρωση εξωτερικών συστημάτων όπως CRM/ERP όταν η κατάσταση ενός μηνύματος αλλάζει.

Μπορείτε να τα βρείτε στην επιλογή Developers στο user menu που βρίσκεται πάνω δεξιά στην οθόνη.

To πλαίσιο για να ρυθμίσετε τα webhooks του λογαριασμού σας θα εμφανιστεί στο τέλος της οθόνης.

Σε περίπτωση που δεν βλέπετε το panel όπως φαίνεται στην παρακάτω εικόνα, τότε επικοινωνήστε με το τμήμα υποστήριξης για να ενεργοποιήσουμε τα webhooks στον λογαριασμό σας.

To Octapush θα στείλει ένα http callback κάθε φορά που ένα γεγονός για το οποίο έχετε ορίσει να λαμβάνετε ενημέρωση συμβαίνει. Έχετε την δυνατότητα να επιλέξετε μεταξύ POST ή GET και φυσικά κατά την κλήση μπορείτε να συμπεριλάβετε όλη την πληροφορία που έχει το Οctapush για αυτόν τον παραλήπτη στην συγκεκριμένη καμπάνια. Αυτό επιτυγχάνεται μέσα από τα tokens που βρίσκονται διαθέσιμα και μπορείτε να συμπεριλάβετε στο link σας.

Καταστάσεις μηνύματων

Όταν ένα μήνυμα αποσταλεί μέσα από το Octapush, μπορεί να έχει διάφορες καταστάσεις που μας περιγράφουν αν παραδόθηκε ή όχι και γιατί. Αν το status είναι τελικό, σημαίνει ότι για το μήνυμα αυτό δεν πρόκειται να λάβουμε άλλη ενημέρωση για την κατάσταση του, διαφορετικά το μήνυμα δεν έχει φτάσει στην τελική του κατάσταση και θα ακολουθήσουν και άλλες ενημερώσεις.

Ο παρακάτω πίνακας περιέχει όλα τα status που ένα SMS ή Viber μήνυμα μπορεί να πάρει καθώς και μια σύντομη επεξήγηση για το καθένα.

Status	VIBER	SMS	Επεξήγηση	Final
Sent			Το μήνυμα έχει αποσταλεί στο τελικό δίκτυο για παράδοση	NO
Pending			Δεν είναι ακόμη γνωστή η κατάσταση του μηνύματος	NO
Submitted			Το μήνυμα έχει δρομολογηθεί για αποστολή	NO
Scheduled			Το μήνυμα έχει προγραμματιστεί για αποστολή σε ορισμένο χρόνο στο μέλλον	NO
Fallbacksms			Το μήνυμα δεν παραδόθηκε μέσω του Viber καναλιού και έχει προωθηθεί για αποστολή μέσω του SMS καναλιού	NO
Not Delivered			Το μήνυμα δεν παραδόθηκε	YES
Unknown			Η αποστολή πήρε κάποιο άλλο status από αυτά που έχουμε καταχωρημένα	YES
Error			Σφάλμα κατά την αποστολή	YES
Expired			Το μήνυμα δεν παραδόθηκε στο χρονικό διάστημα που είχαμε θέσει κατά την δημιουργία της καμπάνιας	YES
Failed			Η αποστολή του μηνύματος απέτυχε γιατί το υπόλοιπο που έχετε στον λογαριασμό σας δεν επαρκεί για την αποστολή	YES
Rejected			Ένα μήνυμα γίνεται rejected όταν το σύστημα απορρίπτει την αποστολή. Έχει να κάνει με το routing. Δηλαδή είτε λάθος αριθμός, είτε δεν υποστηρίζεται ο τερματισμός σε αυτό το δίκτυο από τον λογαριασμό του πελάτη	YES
Canceled			Η αποστολή του μηνύματος ακυρώθηκε	YES
Seen			Ο παραλήπτης έχει δει το μήνυμα	YES
Clicked			Ο παραλήπτης έχει πατήσει κάποιο link στο μήνυμα	YES
Blacklisted			Ο αριθμός ανήκει στην blacklist	YES
Unsubscribed			O παραλήπτης επέλεξε το Unsubscribed στο μήνυμα	YES
Blocked			Έγινε block το Viber Sender Id από το οποίο παραλήφθηκε το μήνυμα	YES

Tokens

Τα βασικά tokens που παρέχει η πλατφόρμα είναι τα πεδία που υπάρχουν και στον τηλεφωνικό κατάλογο όπου αποθηκεύετε τις επαφές σας.

Αυτά είναι: Τηλεφωνικός Αριθμός, Όνομα, Επίθετο, Τίτλος, Option1, Option2.

Αν έχετε δημιουργήσει και δικά σας επιπλέον πεδία σε μια λίστα, όπως για παράδειγμα ένα δικό σας ID τότε και αυτό θα εμφανιστεί σαν token και θα μπορέσετε να το χρησιμοποιήσετε με τα webhooks που θα δημιουργήσετε.

Δημιουργία Webhook

Για να δημιουργήσετε ένα νέο Webhook, πρέπει αρχικά να επιλέξετε το κανάλι που σας ενδιαφέρει δηλαδή SMS ή Viber.

Κατόπιν πρέπει να κάνετε click στην επιλογή Edit στο κάτω μέρος της σελίδας και πλέον είστε έτοιμοι να ενεργοποιήσετε την αποστολή webhook για οποιοδήποτε από τα παρεχόμενα statuses των μηνυμάτων όπως φαίνεται παρακάτω.

Αν υποθέσουμε ότι θέλουμε να λάβουμε ενημέρωση σε ένα εξωτερικό σύστημα για ένα event που συμβαίνει στο Οctapush, θα πρέπει να ενεργοποιήσουμε τον διακόπτη στην αριστερή μεριά στο event που μας ενδιαφέρει και να ορίσουμε το URL που θέλουμε να λάβουμε το callback καθώς και τις μεταβλητές που θέλουμε να συμπεριληφθούν

Αν θέλουμε να χρησιμοποιήσουμε την μέθοδο GET για το status blacklisted τότε θα πρέπει να συμπληρώσουμε την φόρμα όπως φαίνεται παρακάτω.