Delivyr SMS

Η Delivyr είναι συνεργάτης SMS για μηνύματα σε αριθμούς ΗΠΑ και Καναδά. Στέλνει μόνο πρότυπα που έχει εγκρίνει η Delivyr - δεν υπάρχει SMS ελεύθερου κειμένου μέσω Delivyr. Η Delivyr λειτουργεί την υπηρεσία της και κρατά τα δεδομένα των μηνυμάτων στις Ηνωμένες Πολιτείες.

Για ποιους είναι

Για επιχειρήσεις που στέλνουν SMS σε παραλήπτες στις ΗΠΑ ή στον Καναδά και έχουν ήδη, ή ανοίγουν, λογαριασμό στη Delivyr. Ο χώρος εργασίας σας στο Joryio μπορεί να φιλοξενείται στην ΕΕ ή στις ΗΠΑ· αυτό που μετράει είναι οι παραλήπτες να έχουν αριθμούς ΗΠΑ ή Καναδά (+1).

Σύνδεση του λογαριασμού σας Delivyr

Φέρνετε τον δικό σας λογαριασμό Delivyr και τον συνδέετε μόνοι σας, από την κάρτα Delivyr στις Ενσωματώσεις. Χρειάζεστε δύο στοιχεία από την πύλη της Delivyr, και τα δύο στο Settings > General:

• το Account ID σας στη Delivyr
• ένα κλειδί API της Delivyr

1. Ανοίξτε τις Ενσωματώσεις και επιλέξτε Delivyr (στα Μηνύματα).
2. Εισαγάγετε το Account ID και το κλειδί API. Αν η Delivyr έδωσε στον λογαριασμό σας αριθμό αποστολής, μπορείτε να τον εισαγάγετε κι αυτόν. Η Delivyr επιλέγει τον αριθμό από τον οποίο στέλνει, οπότε το Joryio απλώς τον εμφανίζει ως αποστολέα· χωρίς αυτόν, ο αποστολέας εμφανίζεται ως "Delivyr".
3. Πατήστε Έλεγχος σύνδεσης για να ελέγξετε τα στοιχεία με τη Delivyr και μετά Σύνδεση Delivyr. Το Joryio τα ελέγχει ξανά, συνδέει τον λογαριασμό με αυτόν τον χώρο εργασίας και διαβάζει τα πρότυπά σας για πρώτη φορά.

Μετά τη σύνδεση, η κάρτα δείχνει το Account ID, τον αποστολέα, πότε συγχρονίστηκαν τελευταία τα πρότυπα και πόσα είναι, με Έλεγχος σύνδεσης, Ανανέωση προτύπων, Αντικατάσταση κλειδιού API και Αποσύνδεση. Αυτόν τον αποστολέα επιλέγετε στο βήμα SMS μιας καμπάνιας ή ενός journey.

• Ποιος μπορεί να συνδέσει. Μόνο οι διαχειριστές του χώρου εργασίας - το δικαίωμα Ρυθμίσεις: Εγγραφή - μπορούν να συνδέσουν, να αντικαταστήσουν το κλειδί ή να αποσυνδέσουν. Τα άλλα μέλη βλέπουν την κάρτα αλλά δεν μπορούν να την αλλάξουν.
• Το κλειδί API. Αποθηκεύεται κρυπτογραφημένο και δεν εμφανίζεται ξανά. Για να το αλλάξετε, χρησιμοποιήστε την Αντικατάσταση κλειδιού API· το νέο κλειδί ελέγχεται με τη Delivyr πριν αποθηκευτεί.
• Πολλοί λογαριασμοί ανά χώρο εργασίας, ένας χώρος εργασίας ανά λογαριασμό. Ένας χώρος εργασίας μπορεί να συνδέσει πολλούς λογαριασμούς Delivyr - για παράδειγμα έναν ανά μάρκα - και ο καθένας εμφανίζεται στην κάρτα με το δικό του όνομα. Ένας λογαριασμός Delivyr μπορεί να συνδεθεί με έναν μόνο χώρο εργασίας του Joryio: το Delivyr κρατά πρότυπα και λίστα STOP ανά λογαριασμό, οπότε ένας λογαριασμός κοινός σε δύο χώρους εργασίας θα μοιραζόταν μία λίστα STOP.
• Χώροι εργασίας επίδειξης. Σε demo, η σύνδεση λειτουργεί μόνο αν το Joryio έχει ανοίξει το demo σε εξωτερικές συνδέσεις.
• Χρέωση. Όπως σε κάθε λογαριασμό SMS που φέρνετε, πληρώνετε τη Delivyr για τα μηνύματα βάσει της δικής σας συμφωνίας μαζί της, και το Joryio προσθέτει το τέλος πλατφόρμας ανά μήνυμα.

Αν ο έλεγχος σύνδεσης αποτύχει, η κάρτα λέει γιατί - για παράδειγμα ότι η Delivyr δεν αποδέχτηκε το Account ID και το κλειδί API, ή δεν απάντησε. Η σύνδεση είναι νέα, οπότε αν ένας έλεγχος αποτύχει με τρόπο που φαίνεται λάθος, επικοινωνήστε μαζί μας και θα το εξετάσουμε μαζί σας. Επικοινωνήστε μαζί μας επίσης αν δεν έχετε ακόμη λογαριασμό Delivyr.

Πολλοί λογαριασμοί Delivyr

Ένας χώρος εργασίας μπορεί να στέλνει μέσω περισσότερων από έναν λογαριασμών Delivyr, για παράδειγμα έναν ανά μάρκα. Για να προσθέσετε έναν, πατήστε Σύνδεση άλλου λογαριασμού Delivyr κάτω από τους συνδεδεμένους λογαριασμούς και εισαγάγετε το Account ID και το κλειδί API του όπως παραπάνω. Δώστε του ένα Όνομα - για παράδειγμα τη μάρκα - ώστε να ξεχωρίζετε τους λογαριασμούς: το όνομα εμφανίζεται στην κάρτα, στην επιλογή αποστολέα SMS και στη σελίδα Πρότυπα SMS. Χωρίς όνομα, ο πρώτος λογαριασμός λέγεται "Delivyr" και οι επόμενοι "Delivyr" μαζί με το Account ID τους. Μπορείτε να μετονομάσετε έναν λογαριασμό αργότερα με το μολύβι δίπλα στο όνομά του.

Κάθε λογαριασμός είναι ξεχωριστός:

• Δική του κάρτα. Κάθε λογαριασμός έχει δικό του αποστολέα, πρότυπα, Δοκιμή σύνδεσης, Ανανέωση προτύπων, Αντικατάσταση κλειδιού API και Αποσύνδεση. Η αποσύνδεση ενός λογαριασμού αφήνει τους άλλους συνδεδεμένους.
• Δικά του πρότυπα. Ο επεξεργαστής SMS δείχνει τα πρότυπα του λογαριασμού στον οποίο ανήκει ο επιλεγμένος αριθμός και αναφέρει αυτόν τον λογαριασμό. Ένα πρότυπο ανήκει σε έναν λογαριασμό και στέλνεται μόνο μέσω αυτού: αν αλλάξετε τον αριθμό σε άλλον λογαριασμό, επιλέξτε ένα από τα πρότυπα εκείνου του λογαριασμού. Η σελίδα Πρότυπα SMS δείχνει σε ποιον λογαριασμό ανήκει κάθε πρότυπο και ρωτά για ποιον λογαριασμό είναι ένα νέο πρότυπο.
• Δικό του URL webhook και λίστα STOP. Κάθε λογαριασμός έχει το δικό του URL για αναφορές παράδοσης, και ένα STOP που αναφέρει ένας λογαριασμός διαγράφει την επαφή μόνο από τον αριθμό εκείνου του λογαριασμού.

Αποσύνδεση

Η Αποσύνδεση ζητά πρώτα επιβεβαίωση. Δεν επιτρέπεται όσο μια καμπάνια ή ένα journey που είναι ενεργό, προγραμματισμένο, σε παύση ή σε αναμονή έγκρισης στέλνει ακόμη μέσω Delivyr· η κάρτα τα απαριθμεί, ώστε να τα σταματήσετε ή να τα μεταφέρετε πρώτα σε άλλον αριθμό SMS. Τα πρόχειρα δεν την εμποδίζουν - ο έλεγχος εκκίνησης τα επισημαίνει όταν η Delivyr αποσυνδεθεί. Η αποσύνδεση αφαιρεί από αυτόν τον χώρο εργασίας το αποθηκευμένο κλειδί, τον αποστολέα Delivyr και τα συγχρονισμένα πρότυπα. Τίποτα δεν αλλάζει στον λογαριασμό σας Delivyr.

Πρότυπα

Κάθε μήνυμα της Delivyr είναι πρότυπο. Τα πρότυπά σας βρίσκονται στη σελίδα SMS Templates του Brand Studio, που εμφανίζεται μόλις η Delivyr συνδεθεί με τον χώρο εργασίας σας.

• Δημιουργημένα στην πύλη της Delivyr. Τα πρότυπα που δημιουργείτε και εγκρίνονται στην πύλη της Delivyr συγχρονίζονται στο Joryio κάθε 30 λεπτά, ή αμέσως όταν πατάτε Ανανέωση από τη Delivyr.
• Δημιουργημένα στο Joryio. Το Νέο πρότυπο υποβάλλει το πρότυπο για έλεγχο στη Delivyr. Εμφανίζεται ως Σε έλεγχο μέχρι η Delivyr να το εγκρίνει ή να το απορρίψει.
• Πρότυπα συστήματος της Delivyr. Εμφανίζονται και τα έτοιμα πρότυπα της Delivyr, που στέλνονται χωρίς έλεγχο.

Το εγκεκριμένο κείμενο δεν αλλάζει. Για να αλλάξετε τη διατύπωση, δημιουργήστε νέο πρότυπο. Λεπτομέρειες, καταστάσεις και συμβουλές γραφής στα Πρότυπα SMS (Delivyr).

Αποστολή σε καμπάνιες και journeys

Όταν ο αριθμός από τον οποίο στέλνετε ανήκει σε λογαριασμό Delivyr, ο επεξεργαστής SMS δείχνει επιλογέα προτύπων αντί για πλαίσιο μηνύματος - στις καμπάνιες και στο βήμα SMS ενός journey.

1. Επιλέξτε εγκεκριμένο πρότυπο. Τα πρότυπα που είναι ακόμη σε έλεγχο δεν εμφανίζονται.
2. Συμπληρώστε κάθε {{variable}} του προτύπου. Γράψτε κείμενο ή χρησιμοποιήστε εξατομίκευση Liquid όπως {{ user.first_name }}· κάθε επαφή παίρνει τις δικές της τιμές τη στιγμή της αποστολής.
3. Βάλτε τη διεύθυνση προορισμού στο {{link}}. Το Joryio τη στέλνει ως δικό του σύντομο σύνδεσμο με παρακολούθηση, ώστε τα κλικ να μετρώνται όπως σε κάθε σύνδεσμο SMS.
4. Δείτε την προεπισκόπηση και χρησιμοποιήστε το Αποστολή δοκιμαστικού SMS για να στείλετε το πρότυπο σε αριθμό δοκιμής.

Ο έλεγχος εκκίνησης επισημαίνει ένα SMS σε λογαριασμό Delivyr που δεν έχει πρότυπο, χρησιμοποιεί πρότυπο που δεν έχει εγκριθεί ή αφήνει μια μεταβλητή κενή. Αν αυτά τα ευρήματα σταματούν την εκκίνηση εξαρτάται από τη ρύθμιση ελέγχου εκκίνησης του χώρου εργασίας σας, όμως η ίδια η Delivyr δεν στέλνει ποτέ τέτοιο μήνυμα, οπότε διορθώστε τα πριν την εκκίνηση. Περισσότερα για τον επεξεργαστή: Λογαριασμοί Delivyr: εγκεκριμένα πρότυπα.

Συναίνεση και διαγραφές

• Το STOP το χειρίζεται η Delivyr. Όταν ένας παραλήπτης απαντά STOP, η Delivyr σταματά να στέλνει σε αυτόν τον αριθμό από τον λογαριασμό σας. Οι διαγραφές και οι κανόνες συναίνεσης του ίδιου του Joryio εξακολουθούν να ισχύουν πριν από κάθε αποστολή.
• Διπλή επιβεβαίωση (double opt-in). Αν η διπλή επιβεβαίωση είναι ενεργή στον λογαριασμό σας Delivyr, η Delivyr στέλνει κανονικά πρότυπα σε έναν αριθμό μόνο αφού ο παραλήπτης επιβεβαιώσει. Το Joryio έχει αντίστοιχη κατάσταση επαφής, Αναμένει επιβεβαίωση - δείτε τη Διαχείριση συνδρομών.

Μόλις ρυθμιστούν οι αναφορές παράδοσης, οι διαγραφές της Delivyr αντιγράφονται στην επαφή στο Joryio: ένα STOP τη διαγράφει από τα SMS, και μια απάντηση YES ή UNSTOP την εγγράφει ξανά (και επιβεβαιώνει μια επαφή σε κατάσταση Αναμένει επιβεβαίωση). Χωρίς αναφορές παράδοσης, οι απαντήσεις STOP και οι επιβεβαιώσεις μένουν μόνο στην πλευρά της Delivyr. Όταν η Delivyr κρατά τη διαγραφή μιας επαφής από τα SMS, η σελίδα της επαφής το αναφέρει: μπορείτε ακόμη να την εγγράψετε ξανά στο Joryio, αλλά η Delivyr συνεχίζει να μπλοκάρει τα SMS μέχρι να στείλει START.

Double opt-in για SMS. Το Delivyr έχει δικό του double opt-in, οπότε όταν ο αριθμός SMS ενός χώρου εργασίας είναι σε λογαριασμό Delivyr, το double opt-in για SMS του Joryio δεν στέλνει δεύτερη επιβεβαίωση: οι νέες εγγραφές SMS καταγράφονται κανονικά και το Delivyr κρατά τα μηνύματα προς ανεπιβεβαίωτους αριθμούς ("Not confirmed yet") μέχρι η επαφή να απαντήσει YES στο Delivyr.

Αναφορές παράδοσης, διαγραφές και απαντήσεις

Η Delivyr στέλνει αναφορές παράδοσης, διαγραφές και απαντήσεις μόνο σε ένα webhook που προσθέτετε στην πύλη Delivyr, και εσείς γράφετε το περιεχόμενο που στέλνει για κάθε συμβάν. Το Joryio σας δίνει και τα δύο: ένα URL webhook και ένα έτοιμο payload για κάθε συμβάν. Μέχρι να τα προσθέσετε, δεν επιστρέφει τίποτα - το Joryio ξέρει ότι ένα μήνυμα παραδόθηκε στη Delivyr, όχι όμως αν έφτασε, και οι απαντήσεις STOP δεν αντιγράφονται στην επαφή στο Joryio.

Ρύθμιση

1. Ανοίξτε Ενσωματώσεις > Delivyr και, στις Αναφορές παράδοσης, πατήστε Ρύθμιση αναφορών παράδοσης. Μόνο οι διαχειριστές του χώρου εργασίας - Ρυθμίσεις: Εγγραφή - βλέπουν το URL.
2. Στην πύλη Delivyr, ανοίξτε Settings > Webhooks και δημιουργήστε ένα webhook με το URL webhook που δείχνει το Joryio. Το ίδιο URL χρησιμοποιείται για όλα τα συμβάντα.
3. Εγγράψτε το webhook σε κάθε συμβάν του πίνακα παρακάτω. Για κάθε συμβάν, επικολλήστε το payload του Joryio (JSONata) - η κάρτα έχει κουμπί Αντιγραφή για καθένα, και παρατίθενται παρακάτω.
4. Αποθηκεύστε. Η κάρτα δείχνει πότε έφτασε η τελευταία αναφορά.

Συμβάν Delivyr	Τι κάνει το Joryio
delivery_receipt	Σημειώνει το μήνυμα Παραδόθηκε, ή Απέτυχε με τον λόγο (μη παραδόσιμο, έληξε, απορρίφθηκε από τον πάροχο), στα analytics καμπανιών και journeys.
rejected_message	Σημειώνει το μήνυμα Απέτυχε με τον λόγο της Delivyr. Ο κωδικός 1 (διαγραμμένος) διαγράφει επίσης την επαφή από τα SMS.
opt_out	Ένα STOP διαγράφει την επαφή από τα SMS για τον αριθμό σας στη Delivyr. Ένα YES ή UNSTOP την εγγράφει ξανά - μόνο όταν το ίδιο το Joryio έλαβε αυτή την απάντηση από την επαφή στον αριθμό σας στη Delivyr τις τελευταίες 24 ώρες, και μόνο για τον αριθμό σας στη Delivyr: μια διαγραφή από τα SMS των άλλων αριθμών σας παραμένει.
incoming_messages	Αποθηκεύει την απάντηση στην επαφή· μπορεί να ξεκινήσει ή να προωθήσει ένα journey, και το {{ reply.text }} τη διαβάζει. Μια απάντηση που είναι λέξη διαγραφής (STOP, UNSUBSCRIBE, CANCEL, END, QUIT, REVOKE, OPT OUT και η υπόλοιπη λίστα διαγραφής του Joryio) διαγράφει επίσης την επαφή από τα SMS - μία φορά, ακόμη κι αν φτάσει και η αναφορά opt_out της Delivyr για το ίδιο STOP. Μια απάντηση START ή YES δεν την εγγράφει ξανά: μόνο η αναφορά opt_out της Delivyr το κάνει.
message_log	Επιβεβαιώνει ότι η Delivyr δέχτηκε το μήνυμα.
event_log	Μετρά κλικ σε συνδέσμους που παρακολουθεί η Delivyr. Οι προεπισκοπήσεις συνδέσμων από ρομπότ παραλείπονται.

Κάθε λογαριασμός Delivyr έχει το δικό του URL webhook. Με πολλούς λογαριασμούς Delivyr, ρυθμίστε τις αναφορές παράδοσης στην κάρτα κάθε λογαριασμού και επικολλήστε το URL του λογαριασμού στο portal Delivyr εκείνου του λογαριασμού. Τα payloads είναι ίδια για κάθε λογαριασμό. Μια αναφορά που φτάνει στο URL ενός λογαριασμού δεν αντιστοιχίζεται ποτέ σε μήνυμα που στάλθηκε μέσω άλλου λογαριασμού.

Τα payloads

Επικολλήστε το καθένα, χωρίς αλλαγές, ως payload του συμβάντος του.

delivery_receipt

{ "version": 1, "type": "delivery_receipt", "id": id, "request_id": request_id, "message_log_id": message_log_id, "status": status, "status_mapped": status_mapped, "epoch": epoch }

rejected_message

{ "version": 1, "type": "rejected_message", "id": id, "request_id": request_id, "phone_number": phone_number, "rejection_code": rejection_code, "rejection_reason": rejection_reason }

opt_out

{ "version": 1, "type": "opt_out", "dml": dml, "phone_number": phone_number, "system_number": system_number, "incoming_log_id": incoming_log_id, "request_id": request_id }

incoming_messages

{ "version": 1, "type": "incoming_messages", "id": id, "from": from, "to": to, "body": body, "message_log_id": message_log_id, "request_id": request_id }

message_log

{ "version": 1, "type": "message_log", "id": id, "request_id": request_id, "sending_number": sending_number, "segments": segments, "testing": testing }

event_log

{ "delivyr_ignore": event != "click", "version": 1, "type": "event_log", "event": event, "message_log_id": message_log_id, "request_id": request_id }

• Έκδοση. Κάθε payload περιέχει "version": 1. Αν το Joryio αλλάξει το payload, η κάρτα θα το αναφέρει· τότε επικολλήστε το νέο. Μια αναφορά με payload που δεν αναγνωρίζει το Joryio απορρίπτεται και μετριέται στην κάρτα.
• Κρατήστε το URL ιδιωτικό. Όποιος το έχει μπορεί να στείλει αναφορές και διαγραφές για αυτόν τον χώρο εργασίας. Αν διαρρεύσει, πατήστε Δημιουργία νέου URL στην κάρτα: το παλιό σταματά να λειτουργεί αμέσως, και οι αναφορές σταματούν μέχρι να επικολλήσετε το νέο URL στη Delivyr.
• Μετρούν μόνο τα δικά σας μηνύματα. Το Joryio αντιστοιχίζει κάθε αναφορά με το μήνυμα που έστειλε από αυτόν τον χώρο εργασίας. Μια αναφορά που δεν αντιστοιχίζεται μετριέται στην κάρτα ως μη αντιστοιχισμένη και δεν προστίθεται ποτέ σε επαφή ή καμπάνια.

Περιορισμοί σήμερα

• Χωρίς SMS ελεύθερου κειμένου. Κάθε μήνυμα πρέπει να είναι εγκεκριμένο πρότυπο. Μια καμπάνια που δημιουργείται μέσω του API με μήνυμα ελεύθερου κειμένου σε λογαριασμό Delivyr απορρίπτεται.
• Μόνο ΗΠΑ και Καναδάς. Μια αποστολή σε αριθμό εκτός +1 αποτυγχάνει με το "Delivyr sends to US and Canada (+1) numbers only" και δεν επαναλαμβάνεται.
• Οι αναφορές παράδοσης χρειάζονται το webhook. Τα μηνύματα που παραδόθηκαν ή απέτυχαν, οι διαγραφές και οι απαντήσεις φτάνουν στο Joryio μόνο αφού προσθέσετε το webhook του Joryio στην πύλη Delivyr - δείτε Αναφορές παράδοσης, διαγραφές και απαντήσεις. Οι αναφορές παράδοσης είναι νέες: αν η κάρτα δείχνει αναφορές που δεν αντιστοιχίστηκαν σε μήνυμα ενώ τα Παραδοθέντα μένουν στο μηδέν, επικοινωνήστε μαζί μας.

Δημόσιο API

Τα ίδια πρότυπα είναι διαθέσιμα και μέσω του δημόσιου REST API, μόνο για χώρους εργασίας Delivyr. Δείτε τα Πρότυπα SMS στο Messaging API.