Στο παρόν άρθρο μπορείτε να βρείτε οδηγίες για να ενσωματώσετε το mMP σε οποιαδήποτε πλατφόρμα της επιλογής σας μέσω του εργαλείου Zapier.
Για να μπορέσετε να λαμβάνετε τα μηνύματα που αποστέλλονται στον mMP λογαριασμό σας μέσω Zapier, θα χρειαστεί να χρησιμοποιήσετε το app “Webhooks by Zapier”.
Ρυθμίσεις (Εικόνα 1):
Στο επόμενο βήμα (Εικόνα 2), το Zapier δημιουργεί το webhook URL της υπηρεσίας. Αυτό το URL θα χρειαστεί να κοινοποιηθεί στη Modulus, στο telecoms@modulus.gr, μαζί με τα στοιχεία του email που έχει χρησιμοποιηθεί για τη δημιουργία του mMP λογαριασμού σας, ώστε να ενσωματωθεί στις υπηρεσίες της πλατφόρμας.
Εικόνα 2
Ενσωματώνοντας το URL στην υπηρεσία, με κάθε νέα λήψη μηνύματος θα δημιουργείται αντίστοιχα μία εγγραφή (record), όπως φαίνεται στην Εικόνα 3 παρακάτω.
Οι μεταβλητές σε κάθε εγγραφή που δημιουργείται είναι οι παρακάτω:
Variable name | Information |
querystring__type | Message type (SMS / Viber) |
querystring__sender | Τηλέφωνο αποστολέα |
querystring__receiver | Τηλέφωνο παραλήπτη |
querystring__text | Κείμενο μηνύματος |
querystring__id | ID μηνύματος πλατφόρμας |
querystring__foreign_id | ID μηνύματος παρόχου |
querystring__reply_datetime_stamp | Ημερομηνία λήψης μηνύματος |
querystring__media | Αρχείο μηνύματος (Viber Attachment) |
querystring__filename | Όνομα αρχείου μηνύματος (Viber Attachment) |
Επιλέγοντας ένα συγκεκριμένο record (εγγραφή) και κάνοντας κλικ στο κουμπί «Continue with selected record» (όπως φαίνεται στην Εικόνα 3), μπορείτε να μεταφέρετε την πληροφορία του εισερχόμενου μηνύματος στο flow που επιθυμείτε.
Για να μπορέσετε να στείλετε μηνύματα μέσω Zapier, θα χρειαστεί να χρησιμοποιήσετε το app “Webhooks by Zapier”.
Ρυθμίσεις (Εικόνα 4):
Αφού προχωρήσετε, το επόμενο βήμα αφορά την παραμετροποίηση του “Webhook” και συγκεκριμένα την ενότητα “Action”, όπως φαίνεται στην Εικόνα 5.
Για την ορθή συμπλήρωση των πεδίων μέσα στην ενότητα «Action», ανατρέξτε στον παρακάτω πίνακα:
Πεδίο | Τιμή |
Method | POST |
URL | https://messaging.modulus.gr/ott-api/message |
Data* | ```json { “routing”: “string”, “priority”: 3, “recipients”: [ { “msisdn”: “string” } ], “viber”: { “sender”: “string”, “type”: “text”, |
Πεδίο | Τιμή |
“validityPeriod”: 86400, “text”: “string”, “imageUrl”: “string”, “buttonCaption”: “string”, “buttonAction”: “string”, “expiryText”: “string”, “scheduleDateTime”: “2022-03-10T16:15:50Z” }, “sms”: { “sender”: “string”, “text”: “string”, “encoding”: “gsm”, “validityPeriod”: 86400, “scheduleDateTime”: “2022-03-10T16:15:50Z”, “dcs”: “string”, “udh”: “string” }, “dlr”: true, “dlrUrl”: “string”, “externalTags”: [ “string” ] } ``` |
|
Unflatten | YES |
Basic Auth | Bearer <your API key> |
Headers | Content-Type: application/json |
*Σημείωση 1: Η πλήρης επεξήγηση του παρεχόμενου API είναι διαθέσιμη στον σύνδεσμο Swagger API.
*Σημείωση 2: Στο πεδίο Data, γίνεται η παραμετροποίηση των μηνυμάτων και η αποστολή των δυναμικών πληροφοριών. Με την ολοκλήρωση των παραπάνω, η αποστολή μηνυμάτων μπορεί να ενσωματωθεί στο flow της υπηρεσίας.
Ευχαριστούμε!