- Λήψη SMS και Viber μηνυμάτων
- Αποστολή SMS και Viber Μηνυμάτων
Στο παρόν άρθρο μπορείτε να βρείτε οδηγίες για να ενσωματώσετε το mMP σε οποιαδήποτε πλατφόρμα της επιλογής σας μέσω του εργαλείου Zapier.
Λήψη SMS και Viber μηνυμάτων
Για να μπορέσετε να λαμβάνετε τα μηνύματα που αποστέλλονται στον mMP λογαριασμό σας μέσω Zapier, θα χρειαστεί να χρησιμοποιήσετε το 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 λογαριασμού σας, ώστε να ενσωματωθεί στις υπηρεσίες της πλατφόρμας.
Εικόνα 2
Ενσωματώνοντας το URL στην υπηρεσία, με κάθε νέα λήψη μηνύματος θα δημιουργείται αντίστοιχα μία εγγραφή (record), όπως φαίνεται στην Εικόνα 3 παρακάτω.
Εικόνα 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, θα χρειαστεί να χρησιμοποιήσετε το app “Webhooks by Zapier”.
Ρυθμίσεις (Εικόνα 4):
- Επιλέξτε το επιθυμητό app “Webhooks by Zapier”.
- Στο πεδίο “Event”, επιλέξτε την επιλογή “Custom Request”.
- Κάντε κλικ στο κουμπί “Continue”.
Εικόνα 4
Αφού προχωρήσετε, το επόμενο βήμα αφορά την παραμετροποίηση του “Webhook” και συγκεκριμένα την ενότητα “Action”, όπως φαίνεται στην Εικόνα 5.
Εικόνα 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 της υπηρεσίας.