Στο παρόν άρθρο μπορείτε να βρείτε και να ακολουθήσετε τις οδηγίες για να ενσωματώσετε το mMP σε οποιαδήποτε πλατφόρμα της επιλογής σας μέσω του εργαλείου Zapier.
Λήψη SMS και Viber μηνυμάτων #
Για να μπορέσετε να λαμβάνετε τα μηνύματα τα οποία αποστέλλονται στον mMP λογαριασμό σας, μέσω Zapier, θα χρειαστεί να χρησιμοποιήσετε ως component το app “Webhooks by Zapier”.
Ρυθμίσεις (εικόνα 1):
- Επιλέγετε το επιθυμητό και αναγκαίο app “Webhooks by Zapier”.
- Στο πεδίο “Event” επιλέγετε την επιλογή “Catch Raw Hook”.
- Κάντε κλικ στο κουμπί “Continue”.
Στο επόμενο βήμα (εικόνα 2), το zapier δημιουργεί το webhook URL της υπηρεσίας. Το συγκεκριμένο URL θα χρειατεί να κοινοποιηθεί στη modulus, στο telecoms@modulus.gr μαζί με τα στοιχεία του email το οποίο έχει χρησιμοποιηθεί για τη δημιουργία του mMP λογαριασμού σας ώστε να ενσωματωθεί στις υπηρεσίες της πλατφόρμας.
Ενσωματώνοντας το 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 που επιθυμείτε.
Αποστολή SMS και Viber Μηνυμάτων #
Για να μπορέσετε να στείλετε μηνύματα μέσω Zapier, θα χρειαστεί να χρησιμοποιήσετε ως component το app “Webhooks by Zapier”.
Ρυθμίσεις (εικόνα 4):
- Επιλέγετε το επιθυμητό και αναγκαίο app “Webhooks by Zapier”.
- Στο πεδίο “Event” επιλέγετε την επιλογή “Custom Request”.
- Κάντε κλικ στο κουμπί “Continue”.
Αφού προχωρήσετε, το επόμενο βήμα αφορά την παραμετροποίηση του “Webhook” και συγκεκριμένα την ενότητα “Action”. όπως φαίνεται στην εικόνα 5.
Πιο συγκεκριμένα, για την ορθή συμπλήρωση των πεδίων μέσα στην ενότητα «Action», μπορείτε να ανατρέξετε στον πίνακα που ακολουθεί:
| Πεδίο | Τιμή |
| Method | POST |
| URL | https://messaging.modulus.gr/ott-api/message |
| Data*
(αφορά το API) |
{
“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 είναι διαθέσιμη στον σύνδεσμο https://messaging.modulus.gr/ott-api/swagger .
* Σημείωση 2: Στο πεδίο Data, γίνεται η παραμετροποίηση των μηνυμάτων και αποστολή των δυναμικών πληροφοριών. Με την ολοκλήρωση των παραπάνω, η αποστολή μηνυμάτων μπορεί να ενσωματωθεί στο flow της υπηρεσίας.
